ThinkPHP不会自动根据Accept请求头切换响应格式，需手动解析并分支处理：用$request->header('accept')获取原始值，再通过str_starts_with()判断类型，分别调用json()或view()等方法返回对应格式。
ThinkPHP 不会自动根据 Accept 请求头做响应格式切换，它只读取、不解释——你得自己解析、自己决定返回 JSON 还是 HTML，否则默认走视图渲染。
Request::header('accept') 能拿到但不会自动生效
框架确实提供了获取方式：Request::header('accept') 或 $request->header('accept')，返回类似 application/json, text/html;q=0.9 的原始字符串。但它只是“摆在那里”，框架本身不会据此调用 json() 或切换模板引擎。
- 常见错误现象：前端发
Accept: application/json，后端却仍返回 HTML 页面（或 500 错误），因为控制器没做任何判断 - 注意大小写和分隔符：
accept、Accept、ACCEPT都能取到，框架内部做了标准化处理 - 若值为空（
null或空字符串），说明客户端根本没带这个头，别假设它一定存在
手动解析 Accept 并分支响应的典型写法
最直接可控的方式是在控制器里主动判断，再调用对应响应方法。不依赖中间件，逻辑清晰，调试方便。
- 用
str_starts_with()判断前缀更可靠，比正则或strpos少踩坑：str_starts_with($accept, 'application/json') - 记得 fallback：没匹配到任何已知类型时，应明确返回
406 Not Acceptable或降级为默认格式（如 JSON） - 示例片段：
public function index(Request $request)
{
$accept = $request->header('accept', '');
if (str_starts_with($accept, 'application/json')) {
return json(['code' => 0, 'data' => []]);
}
if (str_starts_with($accept, 'text/html') || $accept === '') {
return view('index');
}
return abort(406, 'Not Acceptable');
}
Accept 与 API 版本控制混用时的优先级问题
如果你同时用 Accept 做版本控制（如 application/vnd.example.v2+json），解析逻辑必须先提取版本号，再决定响应结构，不能只看 MIME 类型主干。
立即学习“PHP免费学习笔记（深入）”；
- 别直接用
explode('/', $accept)[1]—— 它可能含参数，比如v2+json; charset=utf-8 - 推荐用正则提取版本段：
preg_match('/v(\d+)\+json/i', $accept, $matches)，然后取$matches[1] - 注意：
Accept可包含多个类型并用逗号分隔，需按q值排序后再取第一个有效匹配，但多数场景只需检查首个非通配项
响应对象 header() 不该在这里设 Accept 相关头
Response::header() 是设「响应头」，不是「请求头」。你在响应里写 header('Accept: ...') 没有意义，浏览器不会读这个；真正要设的是 Content-Type，且框架通常已自动设置（json() 设 application/json，view() 设 text/html）。
- 容易踩的坑：误以为要手动
header('Accept-Ranges: bytes')—— 这是服务器能力声明，跟客户端Accept无关，静态资源才需考虑 - 若需透传或修改原始
Accept值（极少见），只能存到日志或上下文，不能塞进响应头
真正关键的不是怎么读 Accept，而是读完之后是否立刻做了响应决策。很多问题其实出在控制器里漏了分支，而不是解析逻辑本身有多复杂。
