thinkphp i方法

thinkphp i方法

#ThinkPHP的I方法是3.1.3版本新增的，如果你是之前的3.*版本的話，可以直接參考使用3.1快速入門教學系列的變數部分。

概述

正如你所見的一樣，I方法是ThinkPHP眾多單字母函數中的新成員，其命名來自於英文Input（輸入），主要用於更方便和安全的獲取系統輸入變量，可以用於任何地方，用法格式如下：

I('变量类型.变量名',['默认值'],['过滤方法'])

變量類型是指請求方式或輸入類型，包括：

注意：變數類型不區分大小寫。

變數名則嚴格區分大小寫。

預設值和過濾方法均屬於可選參數。

用法

我們以GET變數型別為例，說明下I方法的使用：

echo I('get.id'); // 相当于 $_GET['id']
echo I('get.name'); // 相当于 $_GET['name']

支援預設值：

echo I('get.id',0); // 如果不存在$_GET['id'] 则返回0
echo I('get.name',''); // 如果不存在$_GET['name'] 则返回空字符串

採用方法過濾：

echo I('get.name','','htmlspecialchars'); // 采用htmlspecialchars方法对$_GET['name'] 进行过滤，如果不存在则返回空字符串

支援直接取得整個變數類型，例如：

I('get.'); // 获取整个$_GET 数组

用相同的方式，我們可以取得post或其他輸入類型的變數，例如：

I('post.name','','htmlspecialchars'); // 采用htmlspecialchars方法对$_POST['name'] 进行过滤，如果不存在则返回空字符串
I('session.user_id',0); // 获取$_SESSION['user_id'] 如果不存在则默认为0
I('cookie.'); // 获取整个 $_COOKIE 数组
I('server.REQUEST_METHOD'); // 获取 $_SERVER['REQUEST_METHOD']

param變數類型是框架特有的支援自動判斷目前請求類型的變數取得方式，例如：

echo I('param.id');

如果目前請求類型是GET，那麼等效於$_GET['id ']，如果目前請求類型是POST或PUT，那麼相當於取得$_POST['id'] 或PUT參數id。

且param類型變數也可以用數字索引的方式取得URL參數（必須是PATHINFO模式參數有效，無論是GET或POST方式都有效），例如：

目前存取URL位址是

http://serverName/index.php/New/2013/06/01

那麼我們可以透過

echo I('param.1'); // 输出2013
echo I('param.2'); // 输出06
echo I('param.3'); // 输出01

事實上，param變數類型的寫法可以簡化為：

I('id'); // 等同于 I('param.id')
I('name'); // 等同于 I('param.name')

變數過濾

使用I方法的時候變數其實經過了兩道過濾，首先是全域的過濾，全域過濾是透過配置VAR_FILTERS參數，這裡一定要注意，3.1版本之後，VAR_FILTERS參數的過濾機制已經更改為採用array_walk_recursive方法遞歸過濾了，主要對過濾方法的要求是必須引用返回，所以這裡設定htmlspecialchars是無效的，你可以自訂一個方法，例如：

function filter_default(&$value){
    $value = htmlspecialchars($value);
}

然後配置：

'VAR_FILTERS'=>'filter_default'

如果需要進行多次過濾，可以用：

'VAR_FILTERS'=>'filter_default,filter_exp'

filter_exp方法是框架內建的安全過濾方法，用來防止利用模型的EXP功能進行注入攻擊。

因為VAR_FILTERS參數設定的是全域過濾機制，而且採用的是遞歸過濾，對效率有所影響，所以，我們更建議直接對獲取變數過濾的方式，除了在I方法的第三個參數設定過濾方法外，還可以採用配置DEFAULT_FILTER參數的方式設定過濾，事實上，該參數的預設設定是：

'DEFAULT_FILTER'        => 'htmlspecialchars'

也就說，I方法的所有取得變數都會進行htmlspecialchars過濾，那麼：

I('get.name'); // 等同于 htmlspecialchars($_GET['name'])

同樣，該參數也可以支援多個過濾，例如：

'DEFAULT_FILTER'        => 'strip_tags,htmlspecialchars'

I('get.name'); // 等同于 htmlspecialchars(strip_tags($_GET['name']))

如果我們在使用I方法的時候指定了過濾方法，那麼就會忽略DEFAULT_FILTER的設置，例如：

echo I('get.name','','strip_tags'); // 等同于 strip_tags($_GET['name'])

I方法的第三個參數如果傳入函數名，則表示呼叫該函數對變數進行過濾並返回（在變數是數組的情況下自動使用array_map進行過濾處理），否則會呼叫PHP內建的filter_var方法進行過濾處理，例如：

I('post.email','',FILTER_VALIDATE_EMAIL);

表示會對$_POST['email'] 進行格式驗證，如果不符合要求的話，傳回空字串。

（關於更多的驗證格式，可以參考官方手冊的filter_var用法。）

#或可以用下面的字元標識方式：

I('post.email','','email');

可以支援的過濾名稱必須是filter_list方法中的有效值（不同的伺服器環境可能有所不同），可能支援的包括：

int
boolean
float
validate_regexp
validate_url
validate_email
validate_ip
string
stripped
encoded
special_chars
unsafe_raw
email
url
number_int
number_float
magic_quotes
callback

在有些特殊的情況下，我們不希望進行任何過濾，即使DEFAULT_FILTER已經有所設置，可以使用：

I('get.name','',NULL);

一旦過濾參數設為NULL，即表示不再進行任何的過濾。

本文來自ThinkPHP框架技術文章欄：http://www.php.cn/phpkj/thinkphp/

#

以上是thinkphp i方法的詳細內容。更多資訊請關注PHP中文網其他相關文章！