`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`方法之外,`Response`基类还提供了常用头信息的快捷设置方法:
| 方法名 | 作用 |
| --- | --- |
| `lastModified` | 设置`Last-Modified`头信息 |
| `expires` | 设置`Expires`头信息 |
| `eTag` | 设置`ETag`头信息 |
| `cacheControl` | 设置`Cache-control`头信息 |
| `contentType` | 设置`Content-Type`头信息 |
除非你要清楚自己在做什么,否则不要随便更改这些头信息,每个`Response`子类都有默认的`contentType`信息,一般无需设置。
你可以使用`getHeader`方法获取当前响应对象实例的头信息。
## 写入Cookie
```
response()->cookie('name', 'value', 600);
```
## 设置额外参数
有些时候,响应输出需要设置一些额外的参数,例如:
在进行`json`输出的时候需要设置`json_encode`方法的额外参数,`jsonp`输出的时候需要设置`jsonp_handler`等参数,这些都可以使用`options`方法来进行处理,例如:
~~~
jsonp($data)->options([
'var_jsonp_handler' => 'callback',
'default_jsonp_handler' => 'jsonpReturn',
'json_encode_param' => JSON_PRETTY_PRINT,
]);
~~~
## 关闭当前的请求缓存
支持使用`allowCache`方法动态控制是否需要使用请求缓存。
~~~
// 关闭当前页面的请求缓存
json($data)->code(201)->allowCache(false);
~~~
## 自定义响应
如果需要特别的自定义响应输出,可以自定义一个`Response`子类,并且在控制器的操作方法中直接返回。又或者通过设置响应参数的方式进行响应设置输出。
- 序言
- 基础
- 安装
- 开发规范
- 目录结构
- 配置
- 架构
- 请求流程
- 架构总览
- 入口文件
- 多应用模式
- URL访问
- 容器和依赖注入
- 服务
- 门面
- 中间件
- 事件
- 路由
- 路由定义
- 变量规则
- 路由地址
- 路由参数
- 路由中间件
- 路由分组
- 资源路由
- 注解路由
- 路由绑定
- 域名路由
- MISS路由
- 跨域请求
- URL生成
- 控制器
- 控制器定义
- 基础控制器
- 空控制器
- 资源控制器
- 控制器中间件
- 请求
- 请求对象
- 请求信息
- 输入变量
- 请求类型
- HTTP头信息
- 伪静态
- 参数绑定
- 请求缓存
- 响应
- 响应输出
- 响应参数
- 重定向
- 文件下载
- 数据库
- 连接数据库
- 分布式数据库
- 查询构造器
- 查询数据
- 添加数据
- 更新数据
- 删除数据
- 查询表达式
- 链式操作
- where
- table
- alias
- field
- strict
- limit
- page
- order
- group
- having
- join
- union
- distinct
- lock
- cache
- cacheAlways
- comment
- fetchSql
- force
- partition
- failException
- sequence
- replace
- extra
- duplicate
- procedure
- 聚合查询
- 分页查询
- 时间查询
- 高级查询
- 视图查询
- JSON字段
- 子查询
- 原生查询
- 获取查询参数
- 查询事件
- 获取器
- 事务操作
- 存储过程
- 数据集
- 数据库驱动
- 模型
- 定义
- 模型字段
- 新增
- 更新
- 删除
- 查询
- 查询范围
- JSON字段
- 获取器
- 修改器
- 搜索器
- 数据集
- 自动时间戳
- 只读字段
- 软删除
- 类型转换
- 模型输出
- 模型事件
- 模型关联
- 一对一关联
- 一对多关联
- 远程一对多
- 远程一对一
- 多对多关联
- 多态关联
- 关联预载入
- 关联统计
- 关联输出
- 虚拟模型
- 视图
- 模板变量
- 视图过滤
- 模板渲染
- 模板引擎
- 视图驱动
- 错误和日志
- 异常处理
- 日志处理
- 调试
- 调试模式
- Trace调试
- SQL调试
- 变量调试
- 远程调试
- 验证
- 验证器
- 验证规则
- 错误信息
- 验证场景
- 路由验证
- 内置规则
- 表单令牌
- 注解验证
- 杂项
- 缓存
- Session
- Cookie
- 多语言
- 上传
- 命令行
- 启动内置服务器
- 查看版本
- 自动生成应用目录
- 创建类库文件
- 清除缓存文件
- 生成数据表字段缓存
- 生成路由映射缓存
- 输出路由定义
- 自定义指令
- Debug输出级别
- 扩展库
- 数据库迁移工具
- Workerman
- think助手工具库
- 验证码
- Swoole
- 附录
- 助手函数
- 升级指导
- 更新日志