PHP filter_input()関数


PHP Filter 参考手册PHP Filter 完全リファレンスマニュアル

定義と使用法

filter_input() 関数は、スクリプトの外部(フォーム入力など)から入力を取得し、フィルタリングします。

この関数は、ユーザー入力などの安全でないソースからの変数を検証するために使用されます。

この関数は、さまざまなソースから入力を取得できます。

  • INPUT_GET
  • INPUT_POST
  • INPUT_COOKIE
  • INPUT_ENV
  • INPUT_SERVER
  • INPUT_SESSION(未実装)
  • INPUT_REQUEST(未実装)

成功した場合はフィルタリングされたデータを返します。失敗した場合は FALSE を返します。 "variable" パラメータが設定されていない場合は NULL を返します。

構文

filter_input(input_type, variable, filter, options)

引数 説明
input_type 必須。入力タイプを指定します。上記のリストで可能なタイプを参照してください。
variable 必須。フィルタリングする変数を指定します。
filter オプション。使用するフィルターの ID を指定します。デフォルトは FILTER_SANITIZE_STRING です。参照:PHP Filter 完全リファレンスマニュアルで、可能なフィルターを確認できます。

フィルター ID は、ID 名(例: FILTER_VALIDATE_EMAIL)または ID 番号(例: 274)のいずれかです。

options オプション。フラグ/オプションを含む連想配列、または単一のフラグ/オプションを指定します。各フィルターで使用可能なフラグとオプションを確認してください。


例

この例では、filter_input() 関数を使用して POST 変数をフィルタリングします。受け取った POST 変数が有効なメールアドレスである場合:

<?php
if (!filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL))
{
echo "E-Mail is not valid";
}
else
{
echo "E-Mail is valid";
}
?>

このコードの出力は次のとおりです:

E-Mail is valid


PHP Filter 参考手册PHP Filter 完全リファレンスマニュアル その他の拡張機能