1. 什么是 php 過濾器？

php 過濾器用于驗證和過濾來自非安全來源的數據。

測試、驗證和過濾用戶輸入或自定義數據是任何 web 應用程序的重要組成部分。

php 的過濾器擴展的設計目的是使數據過濾更輕松快捷。

2. 為什么使用過濾器？

幾乎所有的 web 應用程序都依賴外部的輸入。這些數據通常來自用戶或其他應用程序（比如 web 服務）。通過使用過濾器，您能夠確保應用程序獲得正確的輸入類型。

您應該始終對外部數據進行過濾！

輸入過濾是最重要的應用程序安全課題之一。

什么是外部數據？

• 來自表單的輸入數據
• cookies
• web services data
• 服務器變量
• 數據庫查詢結果

3. 函數和過濾器

如需過濾變量，請使用下面的過濾器函數之一：

• filter_var() - 通過一個指定的過濾器來過濾單一的變量
• filter_var_array() - 通過相同的或不同的過濾器來過濾多個變量
• filter_input - 獲取一個輸入變量，并對它進行過濾
• filter_input_array - 獲取多個輸入變量，并通過相同的或不同的過濾器對它們進行過濾

在下面的范例中，我們用 filter_var() 函數驗證了一個整數：

<?php
$int = 123;
 
if(!filter_var($int, filter_validate_int))
{
    echo("不是一個合法的整數");
}
else
{
    echo("是個合法的整數");
}
?>

上面的代碼使用了 "filter_validate_int" 過濾器來過濾變量。由于這個整數是合法的，因此上面的代碼將輸出：

如果我們嘗試使用一個非整數的變量（比如 "123abc"），則將輸出："integer is not valid"。

4. validating 和 sanitizing

有兩種過濾器：

validating 過濾器：

• 用于驗證用戶輸入
• 嚴格的格式規則（比如 url 或 e-mail 驗證）
• 如果成功則返回預期的類型，如果失敗則返回 false

sanitizing 過濾器：

• 用于允許或禁止字符串中指定的字符
• 無數據格式規則
• 始終返回字符串

5. 選項和標志

選項和標志用于向指定的過濾器添加額外的過濾選項。

不同的過濾器有不同的選項和標志。

在下面的范例中，我們用 filter_var() 和 "min_range" 以及 "max_range" 選項驗證了一個整數：

<?php
$var=300;
 
$int_options = array(
    "options"=>array
    (
        "min_range"=>0,
        "max_range"=>256
    )
);
 
if(!filter_var($var, filter_validate_int, $int_options))
{
    echo("不是一個合法的整數");
}
else
{
    echo("是個合法的整數");
}
?>

就像上面的代碼一樣，選項必須放入一個名為 "options" 的相關數組中。如果使用標志，則不需在數組內。

由于整數是 "300"，它不在指定的范圍內，以上代碼的輸出將是：

不是一個合法的整數

6. 驗證輸入

讓我們試著驗證來自表單的輸入。

我們需要做的第一件事情是確認是否存在我們正在查找的輸入數據。

然后我們用 filter_input() 函數過濾輸入的數據。

在下面的范例中，輸入變量 "email" 被傳到 php 頁面：

<?php
if(!filter_has_var(input_get, "email"))
{
    echo("沒有 email 參數");
}
else
{
    if (!filter_input(input_get, "email", filter_validate_email))
    {
        echo "不是一個合法的 e-mail";
    }
    else
    {
        echo "是一個合法的 e-mail";
    }
}
?>

以上范例測試結果如下：

范例解釋:

上面的范例有一個通過 "get" 方法傳送的輸入變量 (email)：

7. 凈化輸入

讓我們試著清理一下從表單傳來的 url。

首先，我們要確認是否存在我們正在查找的輸入數據。

然后，我們用 filter_input() 函數來凈化輸入數據。

在下面的范例中，輸入變量 "url" 被傳到 php 頁面：

<?php
if(!filter_has_var(input_get, "url"))
{
    echo("沒有 url 參數");
}
else
{
    $url = filter_input(input_get, 
    "url", filter_sanitize_url);
    echo $url;
}
?>

范例解釋:

上面的范例有一個通過 "get" 方法傳送的輸入變量 (url)：

假如輸入變量是一個類似這樣的字符串："http://www.ru??no??ob.com/"，則凈化后的 $url 變量如下所示：

8. 過濾多個輸入

表單通常由多個輸入字段組成。為了避免對 filter_var 或 filter_input 函數重復調用，我們可以使用 filter_var_array 或 the filter_input_array 函數。

在本例中，我們使用 filter_input_array() 函數來過濾三個 get 變量。接收到的 get 變量是一個名字、一個年齡以及一個 e-mail 地址：

<?php
$filters = array
(
    "name" => array
    (
        "filter"=>filter_sanitize_string
    ),
    "age" => array
    (
        "filter"=>filter_validate_int,
        "options"=>array
        (
            "min_range"=>1,
            "max_range"=>120
        )
    ),
    "email"=> filter_validate_email
);
 
$result = filter_input_array(input_get, $filters);
 
if (!$result["age"])
{
    echo("年齡必須在 1 到 120 之間。<br>");
}
elseif(!$result["email"])
{
    echo("e-mail 不合法<br>");
}
else
{
    echo("輸入正確");
}
?>

范例解釋:

上面的范例有三個通過 "get" 方法傳送的輸入變量 (name、age 和 email)：

filter_input_array() 函數的第二個參數可以是數組或單一過濾器的 id。

如果該參數是單一過濾器的 id，那么這個指定的過濾器會過濾輸入數組中所有的值。

如果該參數是一個數組，那么此數組必須遵循下面的規則：

• 必須是一個關聯數組，其中包含的輸入變量是數組的鍵（比如 "age" 輸入變量）
• 此數組的值必須是過濾器的 id ，或者是規定了過濾器、標志和選項的數組

9. 使用 filter callback

通過使用 filter_callback 過濾器，可以調用自定義的函數，把它作為一個過濾器來使用。這樣，我們就擁有了數據過濾的完全控制權。

您可以創建自己的自定義函數，也可以使用已存在的 php 函數。

將您準備用到的過濾器的函數，按指定選項的規定方法進行規定。在關聯數組中，帶有名稱 "options"。

在下面的范例中，我們使用了一個自定義的函數把所有 "_" 轉換為 "."：

<?php
function convertspace($string)
{
    return str_replace("_", ".", $string);
}
 
$string = "www_yapf_com!";
 
echo filter_var($string, filter_callback,
array("options"=>"convertspace"));
?>

范例解釋

上面的范例把所有 "_" 轉換成 "." ：