ThinkPHP內置函數----I方法

雖然你仍然能夠在開發過程當中使用傳統方式獲取各類系統變量，例如：

$id    =  $_GET['id']; // 獲取get變量$name  =  $_POST['name'];  // 獲取post變量$value =  $_SESSION['var']; // 獲取session變量$name  =  $_COOKIE['name']; // 獲取cookie變量$file  =  $_SERVER['PHP_SELF']; // 獲取server變量

可是咱們不建議直接使用傳統方式獲取，由於沒有統一的安全處理機制，後期若是調整的話，改起來會比較麻煩。因此，更好的方式是在框架中統一使用I函數進行變量獲取和過濾。

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

I('變量類型.變量名',['默認值'],['過濾方法'],['額外數據源'])

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

變量類型	含義
get	獲取GET參數
post	獲取POST參數
param	自動判斷請求類型獲取GET、POST或者PUT參數
request	獲取REQUEST 參數
put	獲取PUT 參數
session	獲取 $_SESSION 參數
cookie	獲取 $_COOKIE 參數
server	獲取 $_SERVER 參數
globals	獲取 $GLOBALS參數
path	獲取 PATHINFO模式的URL參數（3.2.2新增）
data	獲取 其餘類型的參數，須要配合額外數據源參數（3.2.2新增）

注意：變量類型不區分大小寫。
變量名則嚴格區分大小寫。
默認值和過濾方法均屬於可選參數。

咱們以GET變量類型爲例，說明下I方法的使用：

echo I('get.id'); // 至關於 $_GET['id']echo I('get.name'); // 至關於 $_GET['name']

支持默認值：

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

採用方法過濾：

// 採用htmlspecialchars方法對$_GET['name'] 進行過濾，若是不存在則返回空字符串echo I('get.name','','htmlspecialchars');

支持直接獲取整個變量類型，例如：

// 獲取整個$_GET 數組I('get.');

用一樣的方式，咱們能夠獲取post或者其餘輸入類型的變量，例如：

I('post.name','','htmlspecialchars'); // 採用htmlspecialchars方法對$_POST['name'] 進行過濾，若是不存在則返回空字符串I('session.user_id',0); // 獲取$_SESSION['user_id'] 若是不存在則默認爲0I('cookie.'); // 獲取整個 $_COOKIE 數組I('server.REQUEST_METHOD'); // 獲取 $_SERVER['REQUEST_METHOD']

param變量類型是框架特有的支持自動判斷當前請求類型的變量獲取方式，例如：

echo I('param.id');

若是當前請求類型是GET，那麼等效於 $_GET['id']，若是當前請求類型是POST或者PUT，那麼至關於獲取 $_POST['id'] 或者 PUT參數id。

因爲param類型是I函數默認獲取的變量類型，所以事實上param變量類型的寫法能夠簡化爲：

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

3.2.2新增了path和data兩個變量類型，用法以下：

path類型變量能夠用於獲取URL參數（必須是PATHINFO模式參數有效，不管是GET仍是POST方式都有效），例如：當前訪問URL地址是 http://serverName/index.php/New/2013/06/01

那麼咱們能夠經過

echo I('path.1'); // 輸出2013echo I('path.2'); // 輸出06echo I('path.3'); // 輸出01

data類型變量能夠用於獲取不支持的變量類型的讀取，例如：

I('data.file1','','',$_FILES);

變量過濾

若是你沒有在調用I函數的時候指定過濾方法的話，系統會採用默認的過濾機制（由DEFAULT_FILTER配置），事實上，該參數的默認設置是：

// 系統默認的變量過濾機制'DEFAULT_FILTER'        => 'htmlspecialchars'

也就說，I方法的全部獲取變量若是沒有設置過濾方法的話都會進行htmlspecialchars過濾，那麼：

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

一樣，該參數也能夠設置支持多個過濾，例如：

'DEFAULT_FILTER'        => 'strip_tags,htmlspecialchars'

設置後，咱們在使用：

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

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

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

I方法的第三個參數若是傳入函數名，則表示調用該函數對變量進行過濾並返回（在變量是數組的狀況下自動使用array_map進行過濾處理），不然會調用PHP內置的filter_var方法進行過濾處理，例如：

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

表示 會對$_POST['email'] 進行 格式驗證，若是不符合要求的話，返回空字符串。（關於更多的驗證格式，能夠參考 官方手冊的filter_var用法。）或者能夠用下面的字符標識方式：

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

能夠支持的過濾名稱必須是filter_list方法中的有效值（不一樣的服務器環境可能有所不一樣），可能支持的包括：

intbooleanfloatvalidate_regexpvalidate_urlvalidate_emailvalidate_ipstringstrippedencodedspecial_charsunsafe_rawemailurlnumber_intnumber_floatmagic_quotescallback

在有些特殊的狀況下，咱們不但願進行任何過濾，即便DEFAULT_FILTER已經有所設置，可使用：

// 下面兩種方式都不採用任何過濾方法I('get.name','','');I('get.id','',false);

一旦過濾參數設置爲空字符串或者false，即表示再也不進行任何的過濾。