PHP filter_input_array() 函數

PHP Filter 函數

定義和用法

filter_input_array() 函數從腳本外部獲取多項輸入，并進行過濾。

本函數無需重復調用 filter_input()，對過濾多個輸入變量很有用。

本函數可從各種來源獲取輸入：

  • INPUT_GET
  • INPUT_POST
  • INPUT_COOKIE
  • INPUT_ENV
  • INPUT_SERVER
  • INPUT_SESSION (Not yet implemented)
  • INPUT_REQUEST (Not yet implemented)

如果成功，則返回被過濾的數據，如果失敗，則返回 false。

語法

filter_input(input_type, args)
參數 描述
input_type 必需。規定輸入類型。參見上面的列表中可能的類型。
args

可選。規定過濾器參數數組。

合法的數組鍵是變量名。合法的值是過濾器 ID，或者規定過濾器、標志以及選項的數組。

該參數也可以是一個單獨的過濾器 ID，如果是這樣，輸入數組中的所有值由指定過濾器進行過濾。

提示和注釋

提示：參見完整的 PHP Filter 參考手冊，查看可與該函數一同使用的過濾器。

實例

在本例中，我們使用 filter_input_array() 函數來過濾三個 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));
?>

輸出類似：

Array
 (
 [name] => Peter
 [age] => 41
 [email] => peter@example.com
 )

PHP Filter 函數