php 8.5 并不存在，当前最新稳定版是 8.3，8.4 尚在开发；原生 restful 接口需手动处理请求方法、json 输入、响应头与状态码，路由应先用 switch 搭建骨架并调试。
PHP 8.5 没有官方版本，别被名字骗了
PHP 当前最新稳定版是 8.3（截至 2024 年中），8.4 尚在开发中，8.5 还没影。如果你看到“PHP 8.5 API”，大概率是文档写错了、测试环境标错了，或者有人把自定义版本号当真了。强行按“8.5”去搜扩展、查 RFC 或配 Docker 镜像，会卡在第一步。
- 检查
php -v输出，确认真实版本；Docker 用户重点看FROM php:8.3-apache这类基础镜像，不是8.5 - PHP 主版本升级节奏慢，8.3 → 8.4 的新特性（比如
explicit_octal_notation、json_validate()改进）才是当前真正可用的“新能力” - 很多所谓“8.5 教程”实际只是套了个标题，代码里连
match表达式都没用上，纯属误导
用原生 PHP 写 RESTful 接口，绕不开 $_SERVER['REQUEST_METHOD'] 和 file_get_contents('php://input')
不依赖框架时，HTTP 方法判断和 JSON body 解析这两步最容易出错。PHP 不会自动把 PUT/PATCH 请求体解析进 $_POST，硬读 $_POST 会拿空数组。
-
$_SERVER['REQUEST_METHOD']必须显式判断，不能只靠路由路径区分增删改 - JSON body 要用
file_get_contents('php://input')读取原始流，再json_decode($raw, true)；直接$_POST只对application/x-www-form-urlencoded有效 - 注意
Content-Type头是否为application/json，否则json_decode可能静默失败（返回null），建议加json_last_error() !== JSON_ERROR_NONE校验
状态码、Header、Content-Type 三个地方一错，前端就收不到数据
很多接口明明逻辑跑通了，前端却报 Network Error 或解析失败，问题常出在响应头没设对，而不是业务代码。
- 必须手动
http_response_code(201)或http_response_code(400)，PHP 默认总是200 - 输出 JSON 前要
header('Content-Type: application/json; charset=utf-8')，缺charset在中文场景可能乱码 - 如果接口要支持跨域，
header('Access-Control-Allow-Origin: *')得放在所有echo之前，且不能有空行或var_dump残留输出
别急着写数据库操作，先用 switch + return 把路由骨架撑起来
新手常一上来就拼 SQL、连 PDO，结果 URL 路由错位、方法没分清，连 GET /users 都返回 404。先把最简骨架跑通，比堆功能重要得多。
立即学习“PHP免费学习笔记（深入）”；
- 用
parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH)提取路径，再explode('/', ...)拆段，比正则更稳 - 用
switch ($path) { case '/api/users': ... break; }管住入口，每个case末尾exit;或return，避免流程意外坠入下一个分支 - 调试阶段在每个
case开头error_log("Hit /users with " . $_SERVER['REQUEST_METHOD']);，比var_dump到浏览器更可靠
php://input 只能读一次，比如 header() 发送后不能再 echo，比如 PATH_INFO 和 REQUEST_URI 的差异。这些地方错一点，整个接口就“看起来正常，实则失效”。 
