thinkphp6 請求(request)變量

可以通過Request對象完成全局輸入變量的檢測、獲取和安全過濾,支持包括$_GET$_POST$_REQUEST$_SERVER$_SESSION$_COOKIE$_ENV等系統變量,以及文件上傳信息。

檢測變量是否設置

可以使用has方法來檢測一個變量參數是否設置,如下:

Request::instance()->has('id','get');
Request::instance()->has('name','post');

或者使用助手函數

input('?get.id');
input('?post.name');

變量檢測可以支持所有支持的系統變量。

變量獲取

變量獲取使用\think\Request類的如下方法及參數:

變量類型方法('變量名/變量修飾符','默認值','過濾方法')

變量類型方法包括:

方法 描述
param 獲取當前請求的變量
get 獲取 $_GET 變量
post 獲取 $_POST 變量
put 獲取 PUT 變量
delete 獲取 DELETE 變量
session 獲取 $_SESSION 變量
cookie 獲取 $_COOKIE 變量
request 獲取 $_REQUEST 變量
server 獲取 $_SERVER 變量
env 獲取 $_ENV 變量
route 獲取 路由(包括PATHINFO) 變量
file 獲取 $_FILES 變量

獲取PARAM變量

PARAM變量是框架提供的用於自動識別GETPOST或者PUT請求的一種變量獲取方式,是系統推薦的獲取請求參數的方法,用法如下:

// 獲取當前請求的name變量
Request::instance()->param('name');
// 獲取當前請求的所有變量(經過過濾)
Request::instance()->param();
// 獲取當前請求的所有變量(原始數據)
Request::instance()->param(false);
// 獲取當前請求的所有變量(包含上傳文件)
Request::instance()->param(true);

param方法會把當前請求類型的參數和PATH_INFO變量以及GET請求合併。

使用助手函數實現:

input('param.name');
input('param.');
或者
input('name');
input('');

因爲input函數默認就採用PARAM變量讀取方式。

獲取GET變量

Request::instance()->get('id'); // 獲取某個get變量
Request::instance()->get('name'); // 獲取get變量
Request::instance()->get(); // 獲取所有的get變量(經過過濾的數組)
Request::instance()->get(false); // 獲取所有的get變量(原始數組)

或者使用內置的助手函數input方法實現相同的功能:

input('get.id');
input('get.name');
input('get.');

注:pathinfo地址參數不能通過get方法獲取,查看“獲取PARAM變量”

獲取POST變量

Request::instance()->post('name'); // 獲取某個post變量
Request::instance()->post(); // 獲取經過過濾的全部post變量
Request::instance()->post(false); // 獲取全部的post原始變量

使用助手函數實現:

input('post.name');
input('post.');

獲取PUT變量

Request::instance()->put('name'); // 獲取某個put變量
Request::instance()->put(); // 獲取全部的put變量(經過過濾)
Request::instance()->put(false); // 獲取全部的put原始變量

使用助手函數實現:

input('put.name');
input('put.');

獲取REQUEST變量

Request::instance()->request('id'); // 獲取某個request變量
Request::instance()->request(); // 獲取全部的request變量(經過過濾)
Request::instance()->request(false); // 獲取全部的request原始變量數據

使用助手函數實現:

input('request.id');
input('request.');

獲取SERVER變量

Request::instance()->server('PHP_SELF'); // 獲取某個server變量
Request::instance()->server(); // 獲取全部的server變量

使用助手函數實現:

input('server.PHP_SELF');
input('server.');

獲取SESSION變量

Request::instance()->session('user_id'); // 獲取某個session變量
Request::instance()->session(); // 獲取全部的session變量

使用助手函數實現:

input('session.user_id');
input('session.');

獲取Cookie變量

Request::instance()->cookie('user_id'); // 獲取某個cookie變量
Request::instance()->cookie(); // 獲取全部的cookie變量

使用助手函數實現:

input('cookie.user_id');
input('cookie.');

變量過濾

支持對獲取的變量進行過濾,過濾方式包括函數、方法過濾,以及PHP內置的Types of filters,我們可以設置全局變量過濾方法,例如:

Request::instance()->filter('htmlspecialchars');

支持設置多個過濾方法,例如:

Request::instance()->filter(['strip_tags','htmlspecialchars']),

也可以在獲取變量的時候添加過濾方法,例如:

Request::instance()->get('name','','htmlspecialchars'); // 獲取get變量 並用htmlspecialchars函數過濾
Request::instance()->param('username','','strip_tags'); // 獲取param變量 並用strip_tags函數過濾
Request::instance()->post('name','','org\Filter::safeHtml'); // 獲取post變量 並用org\Filter類的safeHtml方法過濾

可以支持傳入多個過濾規則,例如:

Request::instance()->param('username','','strip_tags,strtolower'); // 獲取param變量 並依次調用strip_tags、strtolower函數過濾

Request對象還支持PHP內置提供的Filter ID過濾,例如:

Request::instance()->post('email','',FILTER_VALIDATE_EMAIL);

框架對FilterID做了轉換支持,因此也可以使用字符串的方式,例如:

Request::instance()->post('email','','email');

採用字符串方式定義FilterID的時候,系統會自動進行一次filter_id調用轉換成Filter常量。

具體的字符串根據filter_list函數的返回值來定義。

需要注意的是,採用Filter ID 進行過濾的話,如果不符合過濾要求的話 會返回false,因此你需要配合默認值來確保最終的值符合你的規範。

例如,

Request::instance()->post('email','',FILTER_VALIDATE_EMAIL);

就表示,如果不是規範的email地址的話 返回空字符串。

如果希望和全局的過濾方法合併的話,可以使用

// 獲取get變量 並使用全局函數htmlspecialchars函數以及strtolower方法過濾
Request::instance()->get('name','','strtolower',true); 

獲取部分變量

如果你只需要獲取當前請求的部分參數,可以使用:

// 只獲取當前請求的id和name變量
Request::instance()->only('id,name');

或者使用數組方式

// 只獲取當前請求的id和name變量
Request::instance()->only(['id','name']);

默認獲取的是當前請求參數,如果需要獲取其它類型的參數,可以使用第二個參數,例如:

// 只獲取GET請求的id和name變量
Request::instance()->only(['id','name'],'get');
// 只獲取POST請求的id和name變量
Request::instance()->only(['id','name'],'post');

排除部分變量

也支持排除某些變量獲取,例如

// 排除id和name變量
Request::instance()->except('id,name');

或者使用數組方式

// 排除id和name變量
Request::instance()->except(['id','name']);

同樣支持指定變量類型獲取:

// 排除GET請求的id和name變量
Request::instance()->except(['id','name'],'get');
// 排除POST請求的id和name變量
Request::instance()->except(['id','name'],'post');

變量修飾符

input函數支持對變量使用修飾符功能,可以更好的過濾變量。

用法如下:

input('變量類型.變量名/修飾符');

或者

Request::instance()->變量類型('變量名/修飾符');

例如:

input('get.id/d');
input('post.name/s');
input('post.ids/a');
Request::instance()->get('id/d');

ThinkPHP5.0版本默認的變量修飾符是/s,如果需要傳入字符串之外的變量可以使用下面的修飾符,包括:

修飾符 作用
s 強制轉換爲字符串類型
d 強制轉換爲整型類型
b 強制轉換爲布爾類型
a 強制轉換爲數組類型
f 強制轉換爲浮點類型

如果你要獲取的數據爲數組,請一定注意要加上 /a 修飾符才能正確獲取到。

本節主要講解了如何獲取請求過來的數據,包括全局變量。

更改變量

如果需要更改請求變量的值,可以通過下面的方式:

// 更改GET變量
Request::instance()->get(['id'=>10]);
// 更改POST變量
Request::instance()->post(['name'=>'thinkphp']);

儘量避免直接修改$_GET 或者 $_POST數據,同時也不能直接修改param變量,例如下面的操作是無效的:

// 更改請求變量
Request::instance()->param(['id'=>10]);

獲取請求類型

在很多情況下面,我們需要判斷當前操作的請求類型是GET、POST、PUT、DELETE或者HEAD,一方面可以針對請求類型作出不同的邏輯處理,另外一方面有些情況下面需要驗證安全性,過濾不安全的請求。

ThinkPHP5.0 取消了用於判斷請求類型的系統常量(如IS_GET,IS_POST等),統一採用 think\Request類 處理請求類型。

用法如下

// 是否爲 GET 請求
if (Request::instance()->isGet()) echo "當前爲 GET 請求";
// 是否爲 POST 請求
if (Request::instance()->isPost()) echo "當前爲 POST 請求";
// 是否爲 PUT 請求
if (Request::instance()->isPut()) echo "當前爲 PUT 請求";
// 是否爲 DELETE 請求
if (Request::instance()->isDelete()) echo "當前爲 DELETE 請求";
// 是否爲 Ajax 請求
if (Request::instance()->isAjax()) echo "當前爲 Ajax 請求";
// 是否爲 Pjax 請求
if (Request::instance()->isPjax()) echo "當前爲 Pjax 請求";
// 是否爲手機訪問
if (Request::instance()->isMobile()) echo "當前爲手機訪問";
// 是否爲 HEAD 請求
if (Request::instance()->isHead()) echo "當前爲 HEAD 請求";
// 是否爲 Patch 請求
if (Request::instance()->isPatch()) echo "當前爲 PATCH 請求";
// 是否爲 OPTIONS 請求
if (Request::instance()->isOptions()) echo "當前爲 OPTIONS 請求";
// 是否爲 cli
if (Request::instance()->isCli()) echo "當前爲 cli";
// 是否爲 cgi
if (Request::instance()->isCgi()) echo "當前爲 cgi";
助手函數

// 是否爲 GET 請求
if (request()->isGet()) echo "當前爲 GET 請求";



作者:hfm0922
鏈接:https://www.jianshu.com/p/f06d09954565
來源:簡書
著作權歸作者所有。商業轉載請聯繫作者獲得授權,非商業轉載請註明出處。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章