响应参数
最后更新于：2022-04-02 01:49:50
`Response`对象提供了一系列方法用于设置响应参数，包括设置输出内容、状态码及header信息等，并且支持链式调用以及多次调用。
## 设置数据
`Response`基类提供了`data`方法用于设置响应数据。
~~~
response()->data($data);
json()->data($data);
~~~
不过需要注意的是`data`方法设置的只是原始数据，并不一定是最终的输出数据，最终的响应输出数据是会根据当前的`Response`响应类型做自动转换的，例如：
~~~
json()->data($data);
~~~
最终的输出数据就是`json_encode($data)`转换后的数据。
如果要获取当前响应对象实例的实际输出数据可以使用`getContent`方法。
## 设置状态码
`Response`基类提供了`code`方法用于设置响应数据，但大部分情况一般我们是直接在调用助手函数的时候直接传入状态码，例如：
~~~
json($data,201);
view($data,401);
~~~
或者在后面链式调用`code`方法是等效的：
~~~
json($data)->code(201);
~~~
>[info] 除了`redirect`函数的默认返回状态码是`302`之外，其它方法没有指定状态码都是返回`200`状态码。
如果要获取当前响应对象实例的状态码的值，可以使用`getCode`方法。
## 设置头信息
可以使用`Response`类的`header`设置响应的头信息
~~~
json($data)->code(201)->header(['Cache-control' => 'no-cache,must-revalidate']);
~~~
`header`方法支持两种方式设置，如果传入数组，则表示批量设置，如果传入两个参数，第一个参数表示头信息名，第二个参数表示头信息的值，例如：
~~~
// 单个设置
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`基类还提供了常用头信息的快捷设置方法：
|方法名|作用|
|---|---|
|`lastModified`|设置`Last-Modified`头信息|
|`expires`|设置`Expires`头信息|
|`eTag`|设置`ETag`头信息|
|`cacheControl`|设置`Cache-control`头信息|
|`contentType`|设置`Content-Type`头信息|
除非你要清楚自己在做什么，否则不要随便更改这些头信息，每个`Response`子类都有默认的`contentType`信息，一般无需设置。
你可以使用`getHeader`方法获取当前响应对象实例的头信息。
## 设置额外参数
有些时候，响应输出需要设置一些额外的参数，例如：
在进行`json`输出的时候需要设置`json_encode`方法的额外参数，`jsonp`输出的时候需要设置`jsonp_handler`等参数，这些都可以使用`options`方法来进行处理，例如：
~~~
json($data)
->options(['json_encode_param' => JSON_NUMERIC_CHECK | JSON_UNESCAPED_UNICODE]);
~~~
也可以支持传入数组作为参数：
~~~
jsonp($data)
->options([
'var_jsonp_handler' => 'callback',
'default_jsonp_handler' => 'jsonpReturn',
'json_encode_param' => JSON_PRETTY_PRINT,
]);
~~~
## 关闭当前的请求缓存（`V5.1.5+`）
`V5.1.5+`版本开始，支持使用`allowCache`方法动态控制是否需要使用请求缓存。
~~~
// 关闭当前页面的请求缓存
json($data)->code(201)->allowCache(false);
~~~
## 自定义响应
如果需要特别的自定义响应输出，可以自定义一个`Response`子类，并且在控制器的操作方法中直接返回。又或者通过设置响应参数的方式进行响应设置输出。
';