filter_input
(no version information, might be only in CVS)
filter_input -- PHP の外部から変数を受け取り、オプションでそれをフィルタリングする
説明
mixed
filter_input ( int type, string variable_name [, int filter [, mixed options]] )
| 警告 |
この関数は、
実験的 なものです。この関数の動作・
名前・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP
のリリースにおいて変更される可能性があります。
この関数は自己責任で使用してください。 |
パラメータ
- type
INPUT_GET、INPUT_POST、
INPUT_COOKIE、INPUT_SERVER、
INPUT_ENV、INPUT_SESSION
(まだ実装されていません) および INPUT_REQUEST のいずれか。
- variable_name
取得する変数の名前。
- filter
適用するフィルタ。デフォルトは FILTER_DEFAULT です。
- options
オプションあるいはフラグの論理和の連想配列。
オプションを指定可能なフィルタの場合、この配列の "flags"
フィールドにフラグを指定します。
返り値
成功した場合は要求された変数の値、フィルタリングに失敗した場合に FALSE、
あるいは変数 variable_name が設定されていない場合に
NULL を返します。フラグ FILTER_NULL_ON_FAILURE
が指定されている場合は、変数が設定されていなければ FALSE、
フィルタリングに失敗したら NULL を返します。
例
例 1. filter_input() の例
<?php
$search_html = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_SPECIAL_CHARS);
$search_url = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_ENCODED);
echo "You have searched for $search_html.\n";
echo "<a href='?search=$search_url'>Search again.</a>";
?>
|
上の例の出力は、たとえば
以下のようになります。 You have searched for Me & son.
<a href='?search=Me%20%26%20son'>Search again.</a> |
|