可以通过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');
变量检测可以支持所有支持的系统变量。
变量获取变量获取利用hinkRequest
类的如下方法及参数:
变量类型方法包括:
PARAM
变量PARAM变量是框架供应的用于自动识别GET
、POST
或者PUT
要求的一种变量获取办法,是系统推举的获取要求参数的方法,用法如下:
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'); Request::instance()->get('name'); Request::instance()->get(); Request::instance()->get(false);
或者利用内置的助手函数input
方法实现相同的功能:
input('get.id');input('get.name');input('get.');
注:pathinfo地址参数不能通过get方法获取,查看“获取PARAM变量”
获取POST
变量Request::instance()->post('name'); Request::instance()->post(); Request::instance()->post(false);
利用助手函数实现:
input('post.name');input('post.');
获取PUT
变量
Request::instance()->put('name'); Request::instance()->put(); Request::instance()->put(false);
利用助手函数实现:
input('put.name');input('put.');
获取REQUEST
变量
Request::instance()->request('id'); Request::instance()->request(); Request::instance()->request(false);
利用助手函数实现:
input('request.id');input('request.');
获取SERVER
变量
Request::instance()->server('PHP_SELF'); Request::instance()->server();
利用助手函数实现:
input('server.PHP_SELF');input('server.');
获取SESSION
变量
Request::instance()->session('user_id'); Request::instance()->session();
利用助手函数实现:
input('session.user_id');input('session.');
获取Cookie
变量
Request::instance()->cookie('user_id'); Request::instance()->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'); Request::instance()->param('username','','strip_tags'); Request::instance()->post('name','','orgFilter::safeHtml');
可以支持传入多个过滤规则,例如:
Request::instance()->param('username','','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地址的话 返回空字符串。
如果希望和全局的过滤方法合并的话,可以利用
Request::instance()->get('name','','strtolower',true);
获取部分变量
如果你只须要获取当前要求的部分参数,可以利用:
Request::instance()->only('id,name');
或者利用数组办法
Request::instance()->only(['id','name']);
默认获取的是当前要求参数,如果须要获取其它类型的参数,可以利用第二个参数,例如:
Request::instance()->only(['id','name'],'get');Request::instance()->only(['id','name'],'post');
打消部分变量
也支持打消某些变量获取,例如
Request::instance()->except('id,name');
或者利用数组办法
Request::instance()->except(['id','name']);
同样支持指定变量类型获取:
Request::instance()->except(['id','name'],'get');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
,如果须要传入字符串之外的变量可以利用下面的润色符,包括:
如果你要获取的数据为数组,请一定把稳要加上 /a
润色符才能精确获取到。
本节紧张讲解了如何获取要求过来的数据,包括全局变量。
更改变量如果须要变动要求变量的值,可以通过下面的办法:
Request::instance()->get(['id'=>10]);Request::instance()->post(['name'=>'thinkphp']);
只管即便避免直接修正$_GET
或者 $_POST
数据,同时也不能直接修正param
变量,例如下面的操作是无效的:
Request::instance()->param(['id'=>10]);
获取要求类型
在很多情形下面,我们须要判断当前操作的要求类型是GET、POST、PUT、DELETE或者HEAD,一方面可以针对要求类型作出不同的逻辑处理,其余一方面有些情形下面须要验证安全性,过滤不屈安的要求。
ThinkPHP5.0 取消了用于判断要求类型的系统常量(如IS_GET,IS_POST等),统一采取 thinkRequest类 处理要求类型。
用法如下
// 是否为 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 要求\"大众;// 是否为 cliif (Request::instance()->isCli()) echo \"大众当前为 cli\"大众;// 是否为 cgiif (Request::instance()->isCgi()) echo \"大众当前为 cgi\公众;助手函数
// 是否为 GET 要求if (request()->isGet()) echo \"大众当前为 GET 要求\公众;……