PHP开发中是否应该自定义HTTP响应码用于服务端返回？

首选方案：标准HTTP状态码搭配自定义业务错误信息 #

• 优先保留HTTP状态码的通用语义：4xx类对应客户端请求错误（如参数非法、无权限、资源不存在等），5xx类对应服务端处理错误，2xx类对应请求正常受理。这部分语义是全球通用的，浏览器、代理服务、客户端SDK都可以直接识别，不会出现兼容问题。
• 业务层面的自定义错误标识和提示文案全部放到响应体中传递，比如返回JSON格式的响应示例：

{
  "http_code": 400,
  "biz_code": 10003,
  "msg": "用户余额不足，无法完成下单",
  "data": null
}

• 这种方案完全不受PHPhttp_response_code()函数的可用码范围限制，你可以根据业务需求自定义任意数量的业务错误码，提示文案可以直接给客户端展示给用户，是目前前后端分离架构的通用最佳实践。

备选方案：手动设置自定义HTTP状态码 #

如果确实需要在HTTP状态行层面返回自定义编码，可以直接用header()函数手动声明状态行，示例代码如下：

<?php
// 注意必须在输出任何内容之前调用header函数，否则会报错
header("HTTP/1.1 418 I'm A Teapot");
// 后续输出响应内容

使用该方案需要注意两点：

• 如果服务端有Nginx、WAF等反向代理/安全组件，需要提前验证这些组件是否会拦截不识别的HTTP状态码，避免响应被篡改。
• 部分老旧的客户端可能对非标准HTTP状态码的处理逻辑异常，建议优先用第一种方案。

内容的提问来源于stack exchange，提问作者Mawg