ThinkPHP响应格式化发生在控制器return之后、输出之前，由框架响应调度器统一处理；json()等方法仅返回Response实例，真正序列化、设header、发送由框架自动完成。
响应格式化发生在控制器 return 之后、输出之前
ThinkPHP 的响应格式化不是在视图层或中间件里“渲染”出来的，而是在控制器方法 return 语句执行后，由框架的响应调度器统一接管处理。你写的 json($data)、response()->xml($data) 或直接 return $array（TP6 API 场景），都只是构造一个 think\Response 实例；真正序列化、设 header、编码、发送，是框架在 return 之后自动完成的。
这意味着：你在控制器里写 echo 'test'; return json($data);，一定会触发 headers already sent 错误——因为 echo 已提前刷出内容，Response 没法再设 header。
- TP5.1 中
json()是“即调即发+exit”，不走完整生命周期，所以它内部自己 handle 了 header 和输出 - TP6 中
json()只返回 Response 对象，框架在 return 后才调用send()，因此更可控，但也更依赖“干净的 return 路径” - 中间件里用
response()->json()必须手动->send()，否则对象被丢弃，响应体为空
Content-Type 和序列化逻辑由 Response 类决定
响应格式化的核心逻辑封装在 think\Response 及其子类中，比如 think\response\Json、think\response\Xml。它们各自重写了 output() 方法：
-
Json::output()调用json_encode($this->data, $this->options)，并默认设置Content-Type: application/json; charset=utf-8 -
Xml::output()做简单数组遍历和标签拼接，不支持嵌套属性，也不自动转义 CDATA —— 所以结构不对就静默失败 - 如果你用
response($data)->contentType('json')，框架会根据类型名匹配到Json类，再走对应逻辑；但若类型名错写成'application/json'，就会 fallback 到原始Raw响应，导致没 JSON 编码
注意：Response::create($data, 'json') 第二个参数是类型名（'json'），不是 MIME 类型字符串（'application/json'）——写错就走 raw 分支。
模型字段格式化不影响响应序列化，除非显式触发
很多人以为给模型加了 getCreateTimeAttr()，API 返回时时间字段就会自动变成 Y-m-d 格式。其实不会。模型获取器只在 ->toArray()、->toJson() 或模板赋值时生效，而 ThinkPHP 默认的 JSON 响应是直接对 $data 调用 json_encode()，并不经过模型的 toJson() 流程。
- 如果
$data是模型实例，TP6 会先调$model->toArray()，这时获取器才起作用 - 如果
$data是普通数组（如['user' => $user]），且$user是模型，则toArray()仍会被递归调用 - 但如果你传的是 Collection 或用了
hidden/append，就得确认这些配置是否在当前上下文生效（比如append不会在json_encode($collection)中自动触发，必须先$collection->append(['xxx'])->toArray()）
换句话说：模型层的格式化是“被动触发”的，响应层不会替你做这一步。
全局配置只影响默认行为，不覆盖显式调用
像 default_return_type（config/app.php）、json_options（config/app.php）、datetime_format（config/database.php）这类配置，只在“框架自动推断格式”时起作用，比如 TP6 中直接 return $array 且请求头带 Accept: application/json。一旦你显式调用 json() 或 response()->json()，这些配置就不再参与决策。
-
json_options默认包含JSON_UNESCAPED_UNICODE（TP6），但如果你手动传json($data, 200, [], 0)，就会丢失中文不转义特性 -
datetime_format只影响数据库查询后对时间字段的自动转换，不影响json()输出时的时间格式——后者取决于你传进去的是 Carbon 实例、时间戳还是字符串 - 跨版本兼容时，别依赖
default_return_type，它在 TP5.1 中不存在，TP6 中也仅限特定场景生效
最不可靠的，就是假设“只要配了 config，所有 return 都会按预期格式化”。真实链路远比配置表层复杂，尤其在混合使用模型、Collection、自定义对象时，格式化点可能分散在数据构造、序列化前、响应输出三个阶段。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
