PHP 過濾器

PHP 過濾器用於驗證和過濾來自非安全來源的數據,例如使用者的輸入。


什麼是 PHP 過濾器?

PHP 篩選器用於驗證和過濾來自非安全性來源的資料。

測試、驗證和過濾使用者輸入或自訂資料是任何 Web 應用程式的重要組成部分。

PHP 的過濾器擴充功能的設計目的是讓資料過濾更輕鬆快速。


為什麼要使用篩選器?

幾乎所有的 Web 應用程式都依賴外部的輸入。這些數據通常來自使用者或其他應用程式(例如 web 服務)。透過使用過濾器,您能夠確保應用程式獲得正確的輸入類型。

您應該始終對外部資料進行過濾!

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

什麼是外部資料?

·   來自表單的輸入資料

·   Cookies

·   Web services data

·    伺服器變數

·   資料庫查詢結果


函數與篩選器

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

·   filter_var() - 透過一個指定的過濾器來過濾單一的變數

·   filter_var_array() - 透過相同的或不同的過濾器來過濾多個變數

·   filter_input - 取得一個輸入變量,並對它進行過濾

·   filter_input_array - 取得多個輸入變量,並透過相同的或不同的過濾器對它們進行過濾


實例

#在下面的實例中,我們用filter_var() 函數驗證了一個整數:

FILTER_VALIDATE_INT 過濾器以整數為驗證值。

<?php
header("Content-type:text/html;charset=utf-8");
$int = 123;

if(!filter_var($int, FILTER_VALIDATE_INT))
{
    echo("不是一个合法的整数");
}
else
{
    echo("是个合法的整数");
}
?>

程式運行結果:

是個合法的整數


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


Validating 和Sanitizing

#有兩個篩選器:

Validating 過濾器:

·    用於驗證使用者輸入

·   嚴格的格式規則(例如URL 或E-Mail 驗證)

·   如果成功則傳回預期的類型,如果失敗則回傳FALSE

Sanitizing 篩選器:

#·   用於允許或禁止字串中指定的字元

·   無資料格式規則

·   總是回傳字串


#選項與標誌

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

不同的濾鏡有不同的選項和標誌。


實例

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

<?php
header("Content-type:text/html;charset=utf-8");
$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",它不在指定的範圍內,以上程式碼的輸出將會是:

不是一個合法的整數

如需查看完整的函數和篩選器列表,請造訪我們的 PHP Filter 參考手冊。您可以看到每個過濾器的可用選項和標誌。


驗證輸入

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

我們需要做的第一件事情是確認是否存在我們正在尋找的輸入資料。

然後我們用 filter_input() 函數過濾輸入的資料。


實例

#在下面的實例中,以GET的方式輸入變數"email" 傳到PHP 頁面:

<?php
header("Content-type:text/html;charset=utf-8");
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";
    }
}
?>

程式運行結果:

6.png

##實例解釋

上面的實例有一個透過"GET" 方法傳送的輸入變數(email):

1.  偵測是否存在"GET" 類型的"email" 輸入變數

2.  如果存在輸入變量,檢測它是否為有效的e-mail 位址



##淨化輸入

讓我們試著清理一下從表單傳來的URL。 首先,我們要確認是否存在我們正在尋找的輸入資料。

然後,我們用 filter_input() 函數來淨化輸入資料。 ##################################實例#########

在下面的實例中,輸入變數"url" 傳到PHP 頁面:

<?php
header("Content-type:text/html;charset=utf-8");
if(!filter_has_var(INPUT_GET, "url"))
{
    echo("没有 url 参数");
}
else
{
    $url = filter_input(INPUT_GET,
        "url", FILTER_SANITIZE_URL);
    echo $url;
}
?>

##實例解釋

FILTER_SANITIZE_URL 過濾器刪除字串中所有非法的URL 字元。

上面的實例有一個透過"GET" 方法傳送的輸入變數(url):

#1.   偵測是否存在"GET" 類型的"url" 輸入變數

#2.   如果存在此輸入變量,對其進行淨化(刪除非法字元),並將其儲存在$url 變量中

假如輸入變量是一個類似這樣的字串:" http:// www.ruåånoøøob.com/",則淨化後的$url 變數如下所示:

7.png


過濾多個輸入

#表單通常由多個輸入欄位組成。為了避免對 filter_var 或 filter_input 函數重複調用,我們可以使用 filter_var_array 或 the filter_input_array 函數。

實例

我們使用 filter_input_array() 函數來過濾三個 GET 變數。接收到的GET 變數是一個名字、一個年齡以及一個e-mail 位址:

<?php
header("Content-type:text/html;charset=utf-8");
$filters = array
(
    "name" => array
    (
        "filter_has_var"=>FILTER_SANITIZE_STRING
    ),
    "age" => array
    (
        "filter_has_var"=>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("输入正确");
}
?>

程式運行結果:

8.png

實例解釋

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

1.   設定一個數組,其中包含了輸入變數的名稱和指定的輸入變數的篩選器

2.   呼叫filter_input_array() 函數,參數包括GET 輸入變數及剛才設定的陣列

3.   偵測$result變數中的"age" 和"email" 變數是否有非法的輸入。 (如果有非法輸入,則在使用 filter_input_array() 函數之後,輸入變數為 FALSE。)

filter_input_array() 函數的第二個參數可以是陣列或單一篩選器的 ID。

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

如果該參數是一個數組,那麼此數組必須遵循下面的規則:

·   必須是關聯數組,其中包含的輸入變數是數組的鍵(例如"age" 輸入變數)

·   此陣列的值必須是過濾器的ID ,或是規定了過濾器、標誌和選項的陣列


使用Filter Callback

★  FILTER_CALLBACK 過濾器使用使用者自訂函數對值進行篩選

透過使用FILTER_CALLBACK 過濾器,可以呼叫自訂的函數,把它當作一個過濾器來使用。這樣,我們就擁有了資料過濾的完全控制權。

您可以建立自己的自訂函數,也可以使用已存在的 PHP 函數。

將您準備用到的篩選器的函數,依照指定選項的規定方法進行規定。在關聯數組中,帶有名稱 "options"。

實例

#在下面的實例中,我們使用了一個自訂的函數把所有"_" 轉換為"."  

<?php
header("Content-type:text/html;charset=utf-8");
function convertSpace($string)
{
    return str_replace("_", ".", $string);
}
$string = "www_php_cn!";
echo filter_var($string, FILTER_CALLBACK,
    array("options"=>"convertSpace"));
?>

#程式運行結果:

www.php.cn!

#實例解釋

上面的實例把所有"_" 轉換成"." :

1.建立一個把"_" 替換為"." 的函數

2.  呼叫filter_var() 函數,它的參數是FILTER_CALLBACK 過濾器以及包含我們的函數的陣列


#
繼續學習
||
<?php header("Content-type:text/html;charset=utf-8"); $int = 123; if(!filter_var($int, FILTER_VALIDATE_INT)) { echo("不是一个合法的整数"); } else { echo("是个合法的整数"); } ?>