filter_var_array

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

filter_var_array — 取得多個變數並選擇性地過濾它們

說明

filter_var_array(陣列 $array, 陣列|整數 $options = FILTER_DEFAULT, 布林值 $add_empty = true): 陣列|false|null

使用 FILTER_VALIDATE_* 驗證過濾器、FILTER_SANITIZE_* 消毒過濾器或自訂過濾器，過濾關聯式陣列的值。

參數

array: 包含要過濾資料的關聯式陣列。
options: 可以是一個選項的關聯式陣列，或是要套用至每個項目的過濾器，可以使用 FILTER_VALIDATE_* 常數作為驗證過濾器，或使用 FILTER_SANITIZE_* 常數作為消毒過濾器。選項陣列是一個關聯式陣列，其中鍵對應於資料 array 中的鍵，而關聯值是要套用至此項目的過濾器，或是一個描述如何以及應該套用哪個過濾器至此項目的關聯式陣列。描述如何套用過濾器的關聯式陣列必須包含 'filter' 鍵，其關聯值是要套用的過濾器，可以是 FILTER_VALIDATE_*、FILTER_SANITIZE_*、FILTER_UNSAFE_RAW 或 FILTER_CALLBACK 常數之一。它可以選擇性地包含 'flags' 鍵，用於指定套用至過濾器的標誌，以及 'options' 鍵，用於指定套用至過濾器的任何選項。
add_empty: 將遺漏的鍵以 null 加入到回傳值中。

回傳值

成功時，會回傳一個包含所請求變數值的陣列；失敗時，則回傳 false。如果過濾失敗，陣列值將會是 false；如果未設定變數，則會是 null。

範例

範例 #1 filter_var_array() 範例

<?php

$data = [
 'product_id' => 'libgd<script>',
 'component' => '10',
 'versions' => '2.0.33',
 'testscalar' => ['2', '23', '10', '12'],
 'testarray' => '2',
];

$filters = [
 'product_id' => FILTER_SANITIZE_ENCODED,
 'component' => [
 'filter' => FILTER_VALIDATE_INT,
 'flags' => FILTER_FORCE_ARRAY,
 'options' => [
 'min_range' => 1,
 'max_range' => 10,
 ],
 ],
 'versions' => [
 'filter' => FILTER_SANITIZE_ENCODED
 ],
 'testscalar' => [
 'filter' => FILTER_VALIDATE_INT,
 'flags' => FILTER_REQUIRE_SCALAR,
 ],
 'testarray' => [
 'filter' => FILTER_VALIDATE_INT,
 'flags' => FILTER_FORCE_ARRAY,
 ],
 'doesnotexist' => FILTER_VALIDATE_INT,
];

var_dump(filter_var_array($data, $filters));

?>

以上範例會輸出：

array(6) {
  ["product_id"]=>
  string(17) "libgd%3Cscript%3E"
  ["component"]=>
  array(1) {
    [0]=>
    int(10)
  }
  ["versions"]=>
  string(6) "2.0.33"
  ["testscalar"]=>
  bool(false)
  ["testarray"]=>
  array(1) {
    [0]=>
    int(2)
  }
  ["doesnotexist"]=>
  NULL
}

參見：

filter_input_array() - 取得外部變數並選擇性地過濾它們
filter_var() - 使用指定的過濾器過濾變數
filter_input() - 透過名稱取得特定外部變數並選擇性地過濾它
驗證過濾器 FILTER_VALIDATE_*
淨化過濾器 FILTER_SANITIZE_*

發現問題了嗎？

學習如何改進此頁面 • 提交 Pull Request • 回報錯誤

＋新增筆記

使用者貢獻的筆記 3 則筆記

向上

向下

匿名 ¶

1 年前

要將相同的過濾器應用於多個參數/鍵值，請使用 array_fill_keys()。

<?php
$data = array(
 'product_id' => 'libgd<script>',
 'component' => ' 10 ',
 'versions' => '2.0.33',
 'testscalar' => array('2', '23', '10', '12'),
 'testarray' => '2',
);
$keys = array(
 'product_id',
 'component',
 'versions',
 'doesnotexist',
 'testscalar',
 'testarray'
);
$options = array(
 'filter' => FILTER_CALLBACK,
 'options' => function ($value) {
 return trim(strip_tags($value));
 },
);
$args = array_fill_keys($keys, $options);
/* Result
$args = array(
 'product_id' => array(
 'filter' => FILTER_CALLBACK,
 'options' => function ($value) {
 return trim(strip_tags($value));
 },
 ),
 'component' => array(
 'filter' => FILTER_CALLBACK,
 'options' => function ($value) {
 return trim(strip_tags($value));
 },
 ),
 'versions' => array(
 'filter' => FILTER_CALLBACK,
 'options' => function ($value) {
 return trim(strip_tags($value));
 },
 ),
 'doesnotexist' => array(
 'filter' => FILTER_CALLBACK,
 'options' => function ($value) {
 return trim(strip_tags($value));
 },
 ),
 'testscalar' => array(
 'filter' => FILTER_CALLBACK,
 'options' => function ($value) {
 return trim(strip_tags($value));
 },
 ),
 'testarray' => array(
 'filter' => FILTER_CALLBACK,
 'options' => function ($value) {
 return trim(strip_tags($value));
 },
 ),
);
*/

$myinputs = filter_var_array($data, $args);
var_dump($myinputs);

Output:

array(6) {
 'product_id' =>
 string(5) "libgd"
 'component' =>
 string(2) "10"
 'versions' =>
 string(6) "2.0.33"
 'doesnotexist' =>
 NULL
 'testscalar' =>
 array(4) {
 [0] =>
 string(1) "2"
 [1] =>
 string(2) "23"
 [2] =>
 string(2) "10"
 [3] =>
 string(2) "12"
 }
 'testarray' =>
 string(1) "2"
}

向上

向下

eguvenc at gmail dot com ¶

15 年前

<?php 
//簡單清理陣列的範例.. 
 
$data = array( 
 '<b>bold</b>', 
 '<script>javascript</script>', 
 'P*}i@893746%%%p*.i.*}}|.dw<?php echo "echo works!!";?>'); 
 
$myinputs = filter_var_array($data,FILTER_SANITIZE_STRING); 
 
var_dump($myinputs); 
 
//輸出： 
//formarray(3) { [0]=> string(4) "bold" [1]=> string(10) "javascript" [2]=> string(26) "P*}i@893746%%%p*.i.*}}|.dw" } 
?>

向上

向下

-1

Vee W. ¶

5 年前

$emails = [
'a' => 'email1@domain.com',
'b' => '<email2>@domain.com',
];

$result = filter_var_array($emails, FILTER_SANITIZE_EMAIL);
print_r($result);

// 結果會是…
// array('a' => 'email1@domain.com', 'b' => 'email2@domain.com')

＋新增筆記