输入变量

创建一个测试的控制器：

<?php
namespace app\test\controller;
use think\facade\Request;
class InputVariable
{
}

1. 检验变量是否设置

添加方法：控制器中不能放回 boolean ，要求返回值的类型是 字符串或者是数字

<?php
public function fun1()
{
    return (Request::has('id', 'get')) ? '设置了' : '没设置';
}
public function fun2()
{
    return (Request::has('id', 'post')) ? '设置了' : '没设置';
}

postman 测试：fun2

postman 测试：fun1

2. 变量获取

2.1 获取PARAM变量

PARAM 类型变量是框架提供的用于自动识别当前请求的一种变量获取方式，是系统推荐的获取请求参数的方法，用法如下：

<?php
// 获取当前请求的name变量
Request::param('name');
// 获取当前请求的所有变量（经过过滤）
Request::param();
// 获取当前请求的所有变量（原始数据）
Request::param(false);
// 获取当前请求的所有变量（包含上传文件）
Request::param(true);

实际例子：

<?php
// 获取当前请求的全部变量
public function fun3()
{
    return json(Request::param());
}

postman 测试：

如果你使用了依赖注入的方式，可以更简单的方式获取请求变量。

<?php
//
public function fun4(\think\Request $req)
{
    return $req->name;
}

postman 测试：

param方法会把当前请求类型的参数和路由变量以及GET请求合并，并且路由变量是优先的。

2.2 正确的获取路由变量

postman 测试：

3. 默认值

获取输入变量的时候，可以支持默认值，例如当URL中不包含$_GET['name']的时候，使用下面的方式输出的结果比较。

<?php
Request::get('name'); // 返回值为null
Request::get('name',''); // 返回值为空字符串
Request::get('name','default'); // 返回值为default

前面提到的方法都支持在第二个参数中传入默认值的方式。

4. 变量过滤 (了解)

5. 获取部分变量

5.1 字符串的使用方式

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

<?php
// 只获取当前请求的id和name变量
Request::only('id,name');

5.2 数组方式

<?php
// 只获取当前请求的id和name变量
Request::only(['id','name']);

采用only方法能够安全的获取你需要的变量，避免额外变量影响数据处理和写入。

5.3 支持默认值

V5.1.3+版本开始，only方法可以支持批量设置默认值，如下：

<?php
// 设置默认值
Request::only(['id' => 0,'name' => '']);

5.4 设置请求类型

默认获取的是当前请求参数（PARAM 类型变量），如果需要获取其它类型的参数，可以在第二个参数传入，例如：

<?php
// 只获取GET请求的id和name变量
Request::only(['id','name'], 'get');
// 只获取POST请求的id和name变量
Request::only(['id','name'], 'post');

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

<?php
// 排除id和name变量
Request::except('id,name');

或者使用数组方式

<?php
// 排除id和name变量
Request::except(['id','name']);

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

<?php
// 排除GET请求的id和name变量
Request::except(['id','name'], 'get');
// 排除POST请求的id和name变量
Request::except(['id','name'], 'post');

6. 变量修饰符(了解)

支持对变量使用修饰符功能，可以一定程度上简单过滤变量，更为严格的过滤请使用前面提过的变量过滤功能。用法如下：

默认的变量修饰符是/s（V5.1.16+版本开始取消默认修饰符），因此默认的单个变量的取值返回的都是字符串，如果需要传入字符串之外的变量可以使用下面的修饰符，包括：

下面是一些例子：

<?php
Request::get('id/d');
Request::post('name/s');
Request::post('ids/a');

7. 修改变量

V5.1.12+版本开始，可以（通常是在中间件里面）设置请求变量的值。

<?php
namespace app\http\middleware;
class Check
{
    public function handle($request, \Closure $next)
    {
        if ('think' == $request->name) {
            $request->name = 'ThinkPHP';
        }
        return $next($request);
    }
}

8. 助手函数

为了简化使用，还可以使用系统提供的input助手函数完成上述大部分功能。

8.1 判断变量是否定义

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

8.2 获取PARAM参数

<?php
input('param.name'); // 获取单个参数
input('param.'); // 获取全部参数
// 下面是等效的
input('name'); 
input('');

8.3 获取GET参数

<?php
// 获取单个变量
input('get.id');
// 使用过滤方法获取 默认为空字符串
input('get.name');
// 获取全部变量
input('get.');

8.4 使用过滤方法

<?php
input('get.name','','htmlspecialchars'); // 获取get变量 并用htmlspecialchars函数过滤
input('username','','strip_tags'); // 获取param变量 并用strip_tags函数过滤
input('post.name','','org\Filter::safeHtml'); // 获取post变量 并用org\Filter类的safeHtml方法过滤

8.5 使用变量修饰符

<?php
input('get.id/d');
input('post.name/s');
input('post.ids/a');