可以通過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變量是框架提供的用於自動識別GET
、POST
或者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
來源:簡書
著作權歸作者所有。商業轉載請聯繫作者獲得授權,非商業轉載請註明出處。