PHPのfilter_has_var()関数とは？使い方とサンプルコードを解説

PHPの filter_has_var() 関数は、指定した種類（タイプ）の中に、特定の変数が存在するかどうかをチェックするために使用される関数です。フォーム送信やURLパラメータの受け取りなどで、変数が実際に存在するかを確認したい場合に便利です。

構文

filter_has_var(type, var)

パラメータ

• type − チェック対象となる入力の種類を指定します。以下の5種類から選択できます。

  • INPUT_GET
  • INPUT_POST
  • INPUT_COOKIE
  • INPUT_SERVER
  • INPUT_ENV

• var − 存在を確認したい変数の名前を文字列で指定します。

戻り値

filter_has_var() 関数は、変数が存在する場合は true を返し、存在しない場合は false を返します。

使用例

次の例では、GETリクエスト経由で渡された入力変数「email」の存在を手軽にチェックしています。入力の種類として INPUT_GET を使用しています。

<?php
   if (!filter_has_var(INPUT_GET, "email")) {
      echo("Email isn't there!");
   } else {
      echo("Email is there!");
   }
?>

このコードでは、まず filter_has_var(INPUT_GET, "email") の結果を否定演算子「!」で反転させて判定しています。GETパラメータに「email」が存在しなければ if 文の中が実行され、「Email isn't there!」と表示されます。逆に存在すれば else 側の処理が行われます。

出力結果

上記のコードを実行した場合の出力は次のとおりです。

Email isn't there!

この例ではURLに email パラメータが付与されていない状態でアクセスしているため、「email」という変数は存在せず、このような結果になります。

まとめ

filter_has_var() 関数を使うことで、GET・POST・COOKIE・SERVER・ENV の各入力元に対して、変数の有無を簡単かつ安全に確認できます。ユーザー入力を扱う際には、いきなり値を読み込む前に存在チェックを行うことで、未定義変数によるエラーを防ぎ、より堅牢なPHPアプリケーションを作成することができます。