PHP原生实现RESTful API的核心难点在于HTTP协议层细节：需用file_get_contents('php://input')读取JSON数据并校验，严格设置Content-Type与状态码（如201/204/404），解析路径拆分资源段，统一错误响应格式，确保无前置输出破坏header。
PHP 原生实现 RESTful API 的核心难点不在逻辑，而在 HTTP 协议层的细节控制——$_POST 拿不到 PUT/DELETE 的 JSON 数据、header() 被前置输出破坏、状态码全写 200 导致前端无法判断操作类型，这些问题会直接让接口在真实联调中卡住。
怎么正确读取 POST/PUT 请求体里的 JSON 数据
前端用 fetch 或 axios 发送 application/json 请求时，PHP 不会自动解析到 $_POST，这是最常踩的坑。必须绕过表单解析机制，直读原始输入流。
- 用
file_get_contents('php://input')获取原始请求体，不是$_POST，也不是$_GET - 读完立刻
trim()，避免 BOM 或空格导致json_decode()返回null - 用
json_decode($raw, true)解析，并检查json_last_error() === JSON_ERROR_NONE，否则返回400 Bad Request - 如果
$_SERVER['CONTENT_TYPE']不含application/json，直接返回415 Unsupported Media Type
为什么不能只 echo json_encode() 就完事
不设响应头、不设状态码，等于把契约交给运气。浏览器或代理可能缓存错误响应，前端 fetch().json() 会直接抛错，Axios 也拿不到结构化错误信息。
- 必须在任何输出前调用
header('Content-Type: application/json; charset=utf-8')，漏掉charset=utf-8中文就乱码 - 用
http_response_code(201)显式设状态码，而不是依赖默认的200；创建资源用201，删除成功用204，无数据查询可用204或404（看语义） - 确保没有空白、BOM、
echo或print出现在header()之前，否则触发Headers already sent - 空响应体也要合法 JSON，比如
json_encode([])或json_encode(null)，别返回空字符串
如何设计路由分发才不混乱
硬编码 switch($_SERVER['REQUEST_METHOD']) 只适合单文件原型，但路径解析稍一复杂就会失控。关键是把 URL 路径和动词解耦，明确资源边界。
立即学习“PHP免费学习笔记（深入）”；
- 用
parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH)提取路径，再explode('/', trim($path, '/'))拆成段，比如/api/users/123→['api', 'users', '123'] - 资源名用复数名词，如
/users、/posts，避免/getUsers或/user/list - ID 段必须是纯数字或 UUID 格式校验，防止注入；非 ID 段（如
/users/export）应视为动作，不符合 RESTful 原则，建议改用查询参数或另设端点 - 未匹配路径统一返回
404 Not Found，不支持的方法返回405 Method Not Allowed，并带Allow: GET, POST响应头
真正难的不是写通一个 GET /users，而是当你要加权限校验、日志、输入过滤、数据库事务回滚时，这些逻辑是否还能干净地插进现有结构里。原生实现的价值在于边界清晰，一旦开始堆砌 if-else 处理各种异常分支，就该考虑抽离成中间件或换框架了。
