(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input — 通過(guò)名稱(chēng)獲取特定的外部變量,并且可以通過(guò)過(guò)濾器處理它
type
INPUT_GET
, INPUT_POST
,
INPUT_COOKIE
, INPUT_SERVER
或
INPUT_ENV
之一。
variable_name
待獲取的變量名。
filter
The ID of the filter to apply. The Types of filters manual page lists the available filters.
If omitted, FILTER_DEFAULT
will be used, which is
equivalent to
FILTER_UNSAFE_RAW
.
This will result in no filtering taking place by default.
options
一個(gè)選項的關(guān)聯(lián)數組,或者按位區分的標示。如果過(guò)濾器接受選項,可以通過(guò)數組的 "flags" 位去提供這些標示。
如果成功的話(huà)返回所請求的變量。如果過(guò)濾失敗則返回 false
,如果variable_name
不存在的話(huà)則返回 null
。
如果標示 FILTER_NULL_ON_FAILURE
被使用了,那么當變量不存在時(shí)返回 false
,當過(guò)濾失敗時(shí)返回 null
。
示例 #1 一個(gè) filter_input() 的例子
<?php
$search_html = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_SPECIAL_CHARS);
$search_url = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_ENCODED);
echo "You have searched for $search_html.\n";
echo "<a href='?search=$search_url'>Search again.</a>";
?>
以上例程的輸出類(lèi)似于:
You have searched for Me & son. <a href='?search=Me%20%26%20son'>Search again.</a>