PHP filter_input_array()関数
完全な PHP Filter リファレンスマニュアル
定義と用法
filter_input_array() 関数は、スクリプト外部から複数の入力(フォーム入力など)を取得し、フィルタリングします。
この関数は、複数の入力変数をフィルタリングする際に便利です。filter_input() を繰り返し呼び出す必要がありません。
この関数は、さまざまなソースから入力を取得できます:
- INPUT_GET
- INPUT_POST
- INPUT_COOKIE
- INPUT_ENV
- INPUT_SERVER
- INPUT_SESSION(未実装)
- INPUT_REQUEST(未実装)
成功した場合は、フィルタリングされたデータを配列として返します。失敗した場合は FALSE を返します。
構文
filter_input_array(input_type, filter_args)
| パラメータ | 説明 |
|---|---|
| input_type | 必須。入力タイプを指定します。上記のリストの可能なタイプを参照してください。 |
| filter_args | 省略可能。フィルタパラメータの配列を指定します。有効な配列のキー名は変数名、有効な値はフィルタ ID、またはフィルタ・フラグ・オプションを指定する配列です。 このパラメータは単一のフィルタ ID にすることもできます。その場合、入力配列内のすべての値は指定されたフィルタでフィルタリングされます。 フィルタ ID は、ID 名(例: FILTER_VALIDATE_EMAIL)または ID 番号(例: 274)のいずれかです。 |
ヒントと注釈
ヒント:参照:完全な PHP Filter リファレンスマニュアル、この関数と一緒に使用できるフィルタを参照してください。
例
この例では、filter_input_array() 関数を使用して 3 つの POST 変数をフィルタリングします。受け取る POST 変数は、名前、年齢、メールアドレスです:
<?php
$filters = array
(
"name" => array
(
"filter"=>FILTER_CALLBACK,
"flags"=>FILTER_FORCE_ARRAY,
"options"=>"ucwords"
),
"age" => array
(
"filter"=>FILTER_VALIDATE_INT,
"options"=>array
(
"min_range"=>1,
"max_range"=>120
)
),
"email"=> FILTER_VALIDATE_EMAIL,
);
print_r(filter_input_array(INPUT_POST, $filters));
?>
$filters = array
(
"name" => array
(
"filter"=>FILTER_CALLBACK,
"flags"=>FILTER_FORCE_ARRAY,
"options"=>"ucwords"
),
"age" => array
(
"filter"=>FILTER_VALIDATE_INT,
"options"=>array
(
"min_range"=>1,
"max_range"=>120
)
),
"email"=> FILTER_VALIDATE_EMAIL,
);
print_r(filter_input_array(INPUT_POST, $filters));
?>
コードの出力は次のとおりです:
Array
(
[name] => Peter
[age] => 41
[email] => peter@example.com
)
(
[name] => Peter
[age] => 41
[email] => peter@example.com
)
完全な PHP Filter リファレンスマニュアル その他の拡張機能