原生PHP实现RESTful路由需手动解析$_SERVER['REQUEST_METHOD']和PATH_INFO，用php://input读取并JSON解码请求体，统一设Content-Type和状态码。
怎么用 PHP 原生写一个能跑通的 RESTful 路由
PHP 本身不内置 REST 路由，得靠自己解析 $_SERVER['REQUEST_METHOD'] 和 $_SERVER['PATH_INFO']（或 $_GET['path']）来分发。框架如 Laravel 是封装了这层，但原生写反而最清楚边界在哪。
常见错误是直接用 $_GET/$_POST 混着收数据，结果 PUT/PATCH 请求体里的 JSON 拿不到——因为 PHP 默认不解析非 application/x-www-form-urlencoded 的请求体。
- 用
file_get_contents('php://input')读原始请求体，再json_decode()解析 JSON - 别依赖
$_POST处理 PUT/PATCH，它只对表单编码有效 - 统一用
$_SERVER['REQUEST_METHOD']判断动词，别用自定义_method参数假装 REST（那不算真 RESTful） - 路径建议用简单前缀隔离，比如
/api/v1/users，避免和前端路由冲突
为什么 status code 不能全写 200，哪怕逻辑跑通了
HTTP 状态码是 RESTful 接口的契约一部分。返回 200 成功却实际是创建资源（应该用 201），或者删完返回 200 而不是 204，前端就很难做正确反馈——比如跳转、清缓存、重置表单。
更隐蔽的问题是代理或 CDN 可能缓存 200 响应，但 201/204/404 默认不缓存，影响一致性。
立即学习“PHP免费学习笔记（深入）”；
- GET 成功 →
200；无数据 →204或404（看业务语义） - POST 创建成功 →
201，并带Locationheader 指向新资源地址 - DELETE 成功 →
204（无响应体）；失败 →404或400 - 用
http_response_code(201)显式设状态，别只 echo JSON
怎么处理 Content-Type 和 Accept 不匹配的请求
很多 PHP 接口只认 application/json，但客户端可能发 text/plain 或漏传 Content-Type，结果 file_get_contents('php://input') 读到的是 raw 字符串，json_decode() 返回 null 却不报错，接口静默失败。
另一个坑是返回时硬写 Content-Type: application/json，但客户端 Accept: application/xml，这就违背了内容协商原则。
- 检查
$_SERVER['CONTENT_TYPE']是否含application/json，否则直接返回415 Unsupported Media Type - 解析前先
trim()php://input内容，避免 BOM 或空格导致json_last_error()为JSON_ERROR_SYNTAX - 返回前可简单判断
$_SERVER['HTTP_ACCEPT']，但不必真支持多格式——明确文档只支持 JSON，就统一返回application/json并忽略 Accept
为什么不要在接口里直接 echo 数组，而要用 json_encode + headers
直接 echo json_encode($data) 看似能用，但缺 header 会导致前端 fetch 的 response.json() 报错（尤其 IE 或某些安卓 WebView），因为 Content-Type 缺失，浏览器当 text/html 解析。
还有个隐形问题：中文字符没设 UTF-8，json_encode() 默认 escape 中文，看着像 \u676e，但其实可以关掉——前提是 header 正确声明编码。
- 必须加
header('Content-Type: application/json; charset=utf-8') - 用
json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)避免无谓转义 - 出错时也走同一套输出逻辑：设
500状态码 + JSON 错误结构，别混用 HTML 或纯文本 - 别在中间
echo调试信息，PHP 输出缓冲没关的话，会破坏 JSON 结构
真正难的不是写几个 endpoint，而是所有接口保持一致的状态码语义、错误结构、空值处理和时间格式（比如统一用 ISO 8601）。这些细节不强制约束，团队协作两周后就会出现五种写法。
