PHP 過濾器

本節(jié)將為你講解 PHP 過濾器的使用。

PHP 過濾器用于驗證和過濾來自非安全來源的數(shù)據(jù)，比如用戶的輸入。

什么是 PHP 過濾器？

PHP 過濾器用于驗證和過濾來自非安全來源的數(shù)據(jù)。

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

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

為什么使用過濾器？

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

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

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

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

• 來自表單的輸入數(shù)據(jù)
• Cookies
• Web services data
• 服務(wù)器變量
• 數(shù)據(jù)庫查詢結(jié)果

函數(shù)和過濾器

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

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

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

 <?php
 $int = 123;

 if(!filter_var($int, FILTER_VALIDATE_INT))
 {
 echo("Integer is not valid");
 }
 else
 {
 echo("Integer is valid");
 }
 ?> 

上面的代碼使用了 "FILTER_VALIDATE_INT" 過濾器來過濾變量。由于這個整數(shù)是合法的，因此上面的代碼將輸出："Integer is valid"。

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

如需查看完整的函數(shù)和過濾器列表，請訪問我們的 PHP Filter 參考手冊。

Validating 和 Sanitizing

有兩種過濾器：

Validating 過濾器：

• 用于驗證用戶輸入
• 嚴格的格式規(guī)則（比如 URL 或 E-Mail 驗證）
• 如果成功則返回預(yù)期的類型，如果失敗則返回 FALSE

Sanitizing 過濾器：

• 用于允許或禁止字符串中指定的字符
• 無數(shù)據(jù)格式規(guī)則
• 始終返回字符串

選項和標志

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

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

在下面的實例中，我們用 filter_var() 和 "min_range" 以及 "max_range" 選項驗證了一個整數(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("Integer is not valid");
 }
 else
 {
 echo("Integer is valid");
 }
 ?> 

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

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

如需查看完整的函數(shù)和過濾器列表，請訪問我們的 PHP Filter 參考手冊。您可以看到每個過濾器的可用選項和標志。

驗證輸入

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

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

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

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

<?php
 if(!filter_has_var(INPUT_GET, "email"))
 {
 echo("Input type does not exist");
 }
 else
 {
 if (!filter_input(INPUT_GET, "email", FILTER_VALIDATE_EMAIL))
 {
 echo "E-Mail is not valid";
 }
 else
 {
 echo "E-Mail is valid";
 }
 }
 ?> 

實例解釋

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

1. 檢測是否存在 "GET" 類型的 "email" 輸入變量
2. 如果存在輸入變量，檢測它是否是有效的 e-mail 地址

凈化輸入

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

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

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

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

<?php
 if(!filter_has_var(INPUT_POST, "url"))
 {
 echo("Input type does not exist");
 }
 else
 {
 $url = filter_input(INPUT_POST, 
 "url", FILTER_SANITIZE_URL);
 }
 ?> 

實例解釋

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

1. 檢測是否存在 "POST" 類型的 "url" 輸入變量
2. 如果存在此輸入變量，對其進行凈化（刪除非法字符），并將其存儲在 $url 變量中

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

過濾多個輸入

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

在本例中，我們使用 filter_input_array() 函數(shù)來過濾三個 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("Age must be a number between 1 and 120.<br>");
   }
 elseif(!$result["email"])
   {
   echo("E-Mail is not valid.<br>");
   }
 else
   {
   echo("User input is valid");
   }
 ?> 

實例解釋

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

1. 設(shè)置一個數(shù)組，其中包含了輸入變量的名稱和用于指定的輸入變量的過濾器
2. 調(diào)用 filter_input_array() 函數(shù)，參數(shù)包括 GET 輸入變量及剛才設(shè)置的數(shù)組
3. 檢測 $result 變量中的 "age" 和 "email" 變量是否有非法的輸入。（如果存在非法輸入，在使用 filter_input_array() 函數(shù)之后，輸入變量為 FALSE。）

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

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

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

• 必須是一個關(guān)聯(lián)數(shù)組，其中包含的輸入變量是數(shù)組的鍵（比如 "age" 輸入變量）
• 此數(shù)組的值必須是過濾器的 ID ，或者是規(guī)定了過濾器、標志和選項的數(shù)組

使用 Filter Callback

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

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

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

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

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

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

實例解釋

上面的實例把所有 "_" 轉(zhuǎn)換成空格：

1. 創(chuàng)建一個把 "_" 替換為空格的函數(shù)
2. 調(diào)用 filter_var() 函數(shù)，它的參數(shù)是 FILTER_CALLBACK 過濾器以及包含我們的函數(shù)的數(shù)組

在下一節(jié)內(nèi)容中，我們將介紹 PHP 的高級過濾器！