响应参数

1. 设置数据

1.1 data() 方式设置原始数据

data() 相关的代码，貌似啥也没干

<?php
/**
 * 输出数据设置
 * @access public
 * @param  mixed $data 输出数据
 * @return $this
 */
public function data($data)
{
    $this->data = $data;
    return $this;
}

控制器：

<?php
namespace app\test\controller;
use think\Response;
class ResInfo
{
    public function index(Response $res)
    {
        $data = '向上;24';
        return dump($res->data($data));
    }
}

postman 测试：

1.2 json() 方式将数据设置为JSON字符串

控制器：

<?php
// json
public function json(Response $res)
{
    return json()->data([
        'name' => 'xs',
        'age' => 24
    ]);
}

postman 测试：

如果要获取当前响应对象实例的实际输出数据可以使用getContent方法。

2. 设置状态码

Response基类提供了code方法用于设置响应数据，但大部分情况一般我们是直接在调用助手函数的时候直接传入状态码，例如：

<?php
json($data,201);
view($data,401);

或者在后面链式调用code方法是等效的：

<?php
json($data)->code(201);

除了redirect函数的默认返回状态码是302之外，其它方法没有指定状态码都是返回200状态码。

如果要获取当前响应对象实例的状态码的值，可以使用getCode方法。

3. 设置头信息

可以使用Response类的header设置响应的头信息

<?php
json($data)->code(201)->header(['Cache-control' => 'no-cache,must-revalidate']);

header方法支持两种方式设置，如果传入数组，则表示批量设置，如果传入两个参数，第一个参数表示头信息名，第二个参数表示头信息的值，例如：

<?php
// 单个设置
header('Cache-control', 'no-cache,must-revalidate');
// 批量设置
header([
    'Cache-control' => 'no-cache,must-revalidate',
    'Last-Modified' => gmdate('D, d M Y H:i:s') . ' GMT',
]);

除了header方法之外，Response基类还提供了常用头信息的快捷设置方法：

除非你要清楚自己在做什么，否则不要随便更改这些头信息，每个Response子类都有默认的contentType信息，一般无需设置。
你可以使用getHeader方法获取当前响应对象实例的头信息。

4. 设置额外参数

有些时候，响应输出需要设置一些额外的参数，例如：
在进行json输出的时候需要设置json_encode方法的额外参数，jsonp输出的时候需要设置jsonp_handler等参数，这些都可以使用options方法来进行处理，例如：

<?php
json($data)
    ->options(['json_encode_param' => JSON_NUMERIC_CHECK | JSON_UNESCAPED_UNICODE]);

也可以支持传入数组作为参数：

<?php
jsonp($data)
    ->options([
        'var_jsonp_handler'     => 'callback',
        'default_jsonp_handler' => 'jsonpReturn',
        'json_encode_param'     => JSON_PRETTY_PRINT,
    ]);

5. 关闭当前的请求缓存

V5.1.5+版本开始，支持使用allowCache方法动态控制是否需要使用请求缓存。

<?php
// 关闭当前页面的请求缓存
json($data)->code(201)->allowCache(false);

6. 自定义响应

如果需要特别的自定义响应输出，可以自定义一个Response子类，并且在控制器的操作方法中直接返回。又或者通过设置响应参数的方式进行响应设置输出。