欢迎访问爱油菜中文网!
您所在的位置:首页 > 代码学苑 > 网建教程

thinkphp6 请求(request)变量

作者:来源:爱油菜教育发表于:2022-01-30 13:08:51

可以通过Request对象完成全局输入变量的检测、获取和安全过滤,支持包括$_GET$_POST$_REQUEST$_SERVER$_SESSION$_COOKIE$_ENV等系统变量,以及文件上传信息。

检测变量是否设置

可以使用has方法来检测一个变量参数是否设置,如下:


 
  1. Request::instance()->has('id','get');
  2. Request::instance()->has('name','post');
  3.  

或者使用助手函数


 
  1. input('?get.id');
  2. input('?post.name');
  3.  

变量检测可以支持所有支持的系统变量。

变量获取

变量获取使用thinkRequest类的如下方法及参数:

变量类型方法('变量名/变量修饰符','默认值','过滤方法')

变量类型方法包括:

方法 描述
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请求的一种变量获取方式,是系统推荐的获取请求参数的方法,用法如下:


 
  1. // 获取当前请求的name变量
  2. Request::instance()->param('name');
  3. // 获取当前请求的所有变量(经过过滤)
  4. Request::instance()->param();
  5. // 获取当前请求的所有变量(原始数据)
  6. Request::instance()->param(false);
  7. // 获取当前请求的所有变量(包含上传文件)
  8. Request::instance()->param(true);
  9.  

param方法会把当前请求类型的参数和PATH_INFO变量以及GET请求合并。

使用助手函数实现:


 
  1. input('param.name');
  2. input('param.');
  3. 或者
  4. input('name');
  5. input('');
  6.  

因为input函数默认就采用PARAM变量读取方式。

获取GET变量


 
  1. Request::instance()->get('id'); // 获取某个get变量
  2. Request::instance()->get('name'); // 获取get变量
  3. Request::instance()->get(); // 获取所有的get变量(经过过滤的数组)
  4. Request::instance()->get(false); // 获取所有的get变量(原始数组)
  5.  

或者使用内置的助手函数input方法实现相同的功能:


 
  1. input('get.id');
  2. input('get.name');
  3. input('get.');
  4.  

注:pathinfo地址参数不能通过get方法获取,查看“获取PARAM变量”

获取POST变量


 
  1. Request::instance()->post('name'); // 获取某个post变量
  2. Request::instance()->post(); // 获取经过过滤的全部post变量
  3. Request::instance()->post(false); // 获取全部的post原始变量
  4.  

使用助手函数实现:


 
  1. input('post.name');
  2. input('post.');
  3.  

获取PUT变量


 
  1. Request::instance()->put('name'); // 获取某个put变量
  2. Request::instance()->put(); // 获取全部的put变量(经过过滤)
  3. Request::instance()->put(false); // 获取全部的put原始变量
  4.  

使用助手函数实现:


 
  1. input('put.name');
  2. input('put.');
  3.  

获取REQUEST变量


 
  1. Request::instance()->request('id'); // 获取某个request变量
  2. Request::instance()->request(); // 获取全部的request变量(经过过滤)
  3. Request::instance()->request(false); // 获取全部的request原始变量数据
  4.  

使用助手函数实现:


 
  1. input('request.id');
  2. input('request.');
  3.  

获取SERVER变量


 
  1. Request::instance()->server('php_SELF'); // 获取某个server变量
  2. Request::instance()->server(); // 获取全部的server变量
  3.  

使用助手函数实现:


 
  1. input('server.php_SELF');
  2. input('server.');
  3.  

获取SESSION变量


 
  1. Request::instance()->session('user_id'); // 获取某个session变量
  2. Request::instance()->session(); // 获取全部的session变量
  3.  

使用助手函数实现:


 
  1. input('session.user_id');
  2. input('session.');
  3.  

获取Cookie变量


 
  1. Request::instance()->cookie('user_id'); // 获取某个cookie变量
  2. Request::instance()->cookie(); // 获取全部的cookie变量
  3.  

使用助手函数实现:


 
  1. input('cookie.user_id');
  2. input('cookie.');
  3.  

变量过滤

支持对获取的变量进行过滤,过滤方式包括函数、方法过滤,以及php内置的Types of filters,我们可以设置全局变量过滤方法,例如:


 
  1. Request::instance()->filter('htmlspecialchars');
  2.  

支持设置多个过滤方法,例如:


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

也可以在获取变量的时候添加过滤方法,例如:


 
  1. Request::instance()->get('name','','htmlspecialchars'); // 获取get变量 并用htmlspecialchars函数过滤
  2. Request::instance()->param('username','','strip_tags'); // 获取param变量 并用strip_tags函数过滤
  3. Request::instance()->post('name','','orgFilter::safeHtml'); // 获取post变量 并用orgFilter类的safeHtml方法过滤
  4.  

可以支持传入多个过滤规则,例如:


 
  1. Request::instance()->param('username','','strip_tags,strtolower'); // 获取param变量 并依次调用strip_tags、strtolower函数过滤
  2.  

Request对象还支持php内置提供的Filter ID过滤,例如:


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

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


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

采用字符串方式定义FilterID的时候,系统会自动进行一次filter_id调用转换成Filter常量。

具体的字符串根据filter_list函数的返回值来定义。

需要注意的是,采用Filter ID 进行过滤的话,如果不符合过滤要求的话 会返回false,因此你需要配合默认值来确保最终的值符合你的规范。

例如,


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

就表示,如果不是规范的email地址的话 返回空字符串。

如果希望和全局的过滤方法合并的话,可以使用


 
  1. // 获取get变量 并使用全局函数htmlspecialchars函数以及strtolower方法过滤
  2. Request::instance()->get('name','','strtolower',true);
  3.  

获取部分变量

如果你只需要获取当前请求的部分参数,可以使用:


 
  1. // 只获取当前请求的id和name变量
  2. Request::instance()->only('id,name');
  3.  

或者使用数组方式


 
  1. // 只获取当前请求的id和name变量
  2. Request::instance()->only(['id','name']);
  3.  

默认获取的是当前请求参数,如果需要获取其它类型的参数,可以使用第二个参数,例如:


 
  1. // 只获取GET请求的id和name变量
  2. Request::instance()->only(['id','name'],'get');
  3. // 只获取POST请求的id和name变量
  4. Request::instance()->only(['id','name'],'post');
  5.  

排除部分变量

也支持排除某些变量获取,例如


 
  1. // 排除id和name变量
  2. Request::instance()->except('id,name');
  3.  

或者使用数组方式


 
  1. // 排除id和name变量
  2. Request::instance()->except(['id','name']);
  3.  

同样支持指定变量类型获取:


 
  1. // 排除GET请求的id和name变量
  2. Request::instance()->except(['id','name'],'get');
  3. // 排除POST请求的id和name变量
  4. Request::instance()->except(['id','name'],'post');
  5.  

变量修饰符

input函数支持对变量使用修饰符功能,可以更好的过滤变量。

用法如下:

input('变量类型.变量名/修饰符');

或者

Request::instance()->变量类型('变量名/修饰符');

例如:


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

Thinkphp5.0版本默认的变量修饰符是/s,如果需要传入字符串之外的变量可以使用下面的修饰符,包括:

修饰符 作用
s 强制转换为字符串类型
d 强制转换为整型类型
b 强制转换为布尔类型
a 强制转换为数组类型
f 强制转换为浮点类型

如果你要获取的数据为数组,请一定注意要加上 /a 修饰符才能正确获取到。

本节主要讲解了如何获取请求过来的数据,包括全局变量。

更改变量

如果需要更改请求变量的值,可以通过下面的方式:


 
  1. // 更改GET变量
  2. Request::instance()->get(['id'=>10]);
  3. // 更改POST变量
  4. Request::instance()->post(['name'=>'thinkphp']);
  5.  

尽量避免直接修改$_GET 或者 $_POST数据,同时也不能直接修改param变量,例如下面的操作是无效的:


 
  1. // 更改请求变量
  2. 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 请求";
// 是否为 cli
if (Request::instance()->isCli()) echo "当前为 cli";
// 是否为 cgi
if (Request::instance()->isCgi()) echo "当前为 cgi";
助手函数

// 是否为 GET 请求
if (request()->isGet()) echo "当前为 GET 请求";