過(guò)濾器

什么是 PHP 過(guò)濾器？

PHP 過(guò)濾器用于驗(yàn)證和過(guò)濾來(lái)自非安全來(lái)源的數(shù)據(jù)。

測(cè)試、驗(yàn)證和過(guò)濾用戶輸入或自定義數(shù)據(jù)是任何 Web 應(yīng)用程序的重要組成部分。

PHP 的過(guò)濾器擴(kuò)展的設(shè)計(jì)目的是使數(shù)據(jù)過(guò)濾更輕松快捷。

為什么使用過(guò)濾器？

幾乎所有的 Web 應(yīng)用程序都依賴外部的輸入。這些數(shù)據(jù)通常來(lái)自用戶或其他應(yīng)用程序（比如 web 服務(wù)）。通過(guò)使用過(guò)濾器，您能夠確保應(yīng)用程序獲得正確的輸入類型。

您應(yīng)該始終對(duì)外部數(shù)據(jù)進(jìn)行過(guò)濾！

輸入過(guò)濾是最重要的應(yīng)用程序安全課題之一。

什么是外部數(shù)據(jù)？

· 來(lái)自表單的輸入數(shù)據(jù)

· Cookies

· Web services data

· 服務(wù)器變量

· 數(shù)據(jù)庫(kù)查詢結(jié)果

函數(shù)和過(guò)濾器

如需過(guò)濾變量，請(qǐng)使用下面的過(guò)濾器函數(shù)之一：

· filter_var() - 通過(guò)一個(gè)指定的過(guò)濾器來(lái)過(guò)濾單一的變量

· filter_var_array() - 通過(guò)相同的或不同的過(guò)濾器來(lái)過(guò)濾多個(gè)變量

· filter_input - 獲取一個(gè)輸入變量，并對(duì)它進(jìn)行過(guò)濾

· filter_input_array - 獲取多個(gè)輸入變量，并通過(guò)相同的或不同的過(guò)濾器對(duì)它們進(jìn)行過(guò)濾

在下面的實(shí)例中，我們用 filter_var() 函數(shù)驗(yàn)證了一個(gè)整數(shù)：

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

上面的代碼使用了 "FILTER_VALIDATE_INT" 過(guò)濾器來(lái)過(guò)濾變量。由于這個(gè)整數(shù)是合法的，因此上面的代碼將輸出：

QQ截圖20161009095342.png

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

如需查看完整的函數(shù)和過(guò)濾器列表，請(qǐng)?jiān)L問(wèn)我們的 PHP Filter 參考手冊(cè)。

Validating 和 Sanitizing

有兩種過(guò)濾器：

Validating 過(guò)濾器：

· 用于驗(yàn)證用戶輸入

· 嚴(yán)格的格式規(guī)則（比如 URL 或 E-Mail 驗(yàn)證）

· 如果成功則返回預(yù)期的類型，如果失敗則返回 FALSE

Sanitizing 過(guò)濾器：

· 用于允許或禁止字符串中指定的字符

· 無(wú)數(shù)據(jù)格式規(guī)則

· 始終返回字符串

選項(xiàng)和標(biāo)志

選項(xiàng)和標(biāo)志用于向指定的過(guò)濾器添加額外的過(guò)濾選項(xiàng)。

不同的過(guò)濾器有不同的選項(xiàng)和標(biāo)志。

在下面的實(shí)例中，我們用 filter_var() 和 "min_range" 以及 "max_range" 選項(xiàng)驗(yàn)證了一個(gè)整數(shù)：

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

就像上面的代碼一樣，選項(xiàng)必須放入一個(gè)名為 "options" 的相關(guān)數(shù)組中。如果使用標(biāo)志，則不需在數(shù)組內(nèi)。

由于整數(shù)是 "300"，它不在指定的范圍內(nèi)，以上代碼的輸出將是：

不是一個(gè)合法的整數(shù)

如需查看完整的函數(shù)和過(guò)濾器列表，請(qǐng)?jiān)L問(wèn)我們的 PHP Filter 參考手冊(cè)。您可以看到每個(gè)過(guò)濾器的可用選項(xiàng)和標(biāo)志。

驗(yàn)證輸入

讓我們?cè)囍?yàn)證來(lái)自表單的輸入。

我們需要做的第一件事情是確認(rèn)是否存在我們正在查找的輸入數(shù)據(jù)。

然后我們用 filter_input() 函數(shù)過(guò)濾輸入的數(shù)據(jù)。

在下面的實(shí)例中，輸入變量 "email" 被傳到 PHP 頁(yè)面：

<?php
if(!filter_has_var(INPUT_GET, "email"))
{
         echo("沒(méi)有 email 參數(shù)");
}
else
{
         if (!filter_input(INPUT_GET, "email", FILTER_VALIDATE_EMAIL))
         {
                 echo "不是一個(gè)合法的 E-Mail";
         }
         else
         {
                 echo "是一個(gè)合法的 E-Mail";
         }
}
?>

以上實(shí)例測(cè)試結(jié)果如下：

QQ截圖20161009095013.png

實(shí)例解釋

上面的實(shí)例有一個(gè)通過(guò) "GET" 方法傳送的輸入變量 (email)：

1. 檢測(cè)是否存在 "GET" 類型的 "email" 輸入變量

2. 如果存在輸入變量，檢測(cè)它是否是有效的 e-mail 地址

凈化輸入

讓我們?cè)囍謇硪幌聫谋韱蝹鱽?lái)的 URL。

首先，我們要確認(rèn)是否存在我們正在查找的輸入數(shù)據(jù)。

然后，我們用 filter_input() 函數(shù)來(lái)凈化輸入數(shù)據(jù)。

在下面的實(shí)例中，輸入變量 "url" 被傳到 PHP 頁(yè)面：

<?php
if(!filter_has_var(INPUT_GET, "url"))
{
         echo("沒(méi)有 url 參數(shù)");
}
else
{
         $url = filter_input(INPUT_GET,
         "url", FILTER_SANITIZE_URL);
         echo $url;
}
?>

實(shí)例解釋

上面的實(shí)例有一個(gè)通過(guò) "GET" 方法傳送的輸入變量 (url)：

1. 檢測(cè)是否存在 "GET" 類型的 "url" 輸入變量

2. 如果存在此輸入變量，對(duì)其進(jìn)行凈化（刪除非法字符），并將其存儲(chǔ)在 $url 變量中

假如輸入變量是一個(gè)類似這樣的字符串："http://www.miracleart.cn /"，則凈化后的 $url 變量如下所示：

QQ截圖20161009095035.png

過(guò)濾多個(gè)輸入

表單通常由多個(gè)輸入字段組成。為了避免對(duì) filter_var 或 filter_input 函數(shù)重復(fù)調(diào)用，我們可以使用 filter_var_array 或 the filter_input_array 函數(shù)。

在本例中，我們使用 filter_input_array() 函數(shù)來(lái)過(guò)濾三個(gè) GET 變量。接收到的 GET 變量是一個(gè)名字、一個(gè)年齡以及一個(gè) 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("輸入正確");
}
?>

實(shí)例解釋

上面的實(shí)例有三個(gè)通過(guò) "GET" 方法傳送的輸入變量 (name、age 和 email)：

1. 設(shè)置一個(gè)數(shù)組，其中包含了輸入變量的名稱和用于指定的輸入變量的過(guò)濾器

2. 調(diào)用 filter_input_array() 函數(shù)，參數(shù)包括 GET 輸入變量及剛才設(shè)置的數(shù)組

3. 檢測(cè) $result 變量中的 "age" 和 "email" 變量是否有非法的輸入。（如果存在非法輸入，在使用 filter_input_array() 函數(shù)之后，輸入變量為 FALSE。）

filter_input_array() 函數(shù)的第二個(gè)參數(shù)可以是數(shù)組或單一過(guò)濾器的 ID。

如果該參數(shù)是單一過(guò)濾器的 ID，那么這個(gè)指定的過(guò)濾器會(huì)過(guò)濾輸入數(shù)組中所有的值。

如果該參數(shù)是一個(gè)數(shù)組，那么此數(shù)組必須遵循下面的規(guī)則：

· 必須是一個(gè)關(guān)聯(lián)數(shù)組，其中包含的輸入變量是數(shù)組的鍵（比如 "age" 輸入變量）

· 此數(shù)組的值必須是過(guò)濾器的 ID ，或者是規(guī)定了過(guò)濾器、標(biāo)志和選項(xiàng)的數(shù)組

使用 Filter Callback

通過(guò)使用 FILTER_CALLBACK 過(guò)濾器，可以調(diào)用自定義的函數(shù)，把它作為一個(gè)過(guò)濾器來(lái)使用。這樣，我們就擁有了數(shù)據(jù)過(guò)濾的完全控制權(quán)。

您可以創(chuàng)建自己的自定義函數(shù)，也可以使用已存在的 PHP 函數(shù)。

將您準(zhǔn)備用到的過(guò)濾器的函數(shù)，按指定選項(xiàng)的規(guī)定方法進(jìn)行規(guī)定。在關(guān)聯(lián)數(shù)組中，帶有名稱 "options"。

在下面的實(shí)例中，我們使用了一個(gè)自定義的函數(shù)把所有 "_" 轉(zhuǎn)換為空格：

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

上面代碼的結(jié)果如下所示：

QQ截圖20161009095054.png