CI4官方无REST_Controller类，需用原生Controller配合路由方法、getJSON()解析JSON请求体、setJSON()响应，并手动处理状态码与内容协商。
CodeIgniter4 里 REST_Controller 不存在
CodeIgniter4 官方没有 REST_Controller 这个类——它属于 CI3 的第三方库（如 chriskacerguis/codeigniter-restserver），CI4 已彻底移除该设计。直接照搬 CI3 写法会报错 Class "AppControllersREST_Controller" not found。
CI4 的 REST API 应基于原生 Controller + 请求方法路由 + 手动内容协商来实现，不依赖继承式基类。
- CI4 路由支持直接映射 HTTP 方法：
$routes->post('users', 'Users::create') - 请求体解析靠
$this->request->getJSON()或$this->request->getPost()，无需封装层 - 响应统一用
json()方法：return $this->response->setJSON([...])
怎么让一个 Controller 支持标准 REST 响应格式
CI4 不强制“REST 风格”，但你可以用几行代码让控制器输出符合 REST API 惯例的结构（含状态码、data/error 字段）。
常见错误是手动拼 JSON 字符串或滥用 echo json_encode()，这会绕过框架响应生命周期，丢失 Content-Type 和状态码控制。
立即学习“PHP免费学习笔记（深入）”；
- 始终用
$this->response->setStatusCode()显式设状态码，比如 404、422 - 用
$this->response->setJSON()输出，它自动设Content-Type: application/json - 建议封装一个简单响应助手方法，比如
apiResponse($data = [], $code = 200, $message = '')，避免重复写setStatusCode+setJSON
示例：
return $this->response
->setStatusCode(422)
->setJSON(['error' => 'Validation failed', 'details' => $errors]);
如何处理 POST/PUT 的 JSON 请求体
CI4 默认只解析 application/x-www-form-urlencoded 和 multipart/form-data，对 application/json 不自动解析——这是最常踩的坑，$this->request->getPost() 对 JSON 请求永远返回空数组。
必须显式调用 $this->request->getJSON()，且注意它返回的是 stdClass 对象，不是数组。
- 要转成数组用
(array) $this->request->getJSON()，但嵌套对象不会递归转 - 更稳妥是用
json_decode($this->request->getBody(), true)，确保拿到关联数组 - 别忘了检查
Content-Type头是否为application/json，否则可能误读其他格式
为什么不能直接用 CI3 的 restserver 库到 CI4
因为 CI4 的核心机制变化太大：Request / Response 类重构、服务容器注册方式不同、路由解析逻辑重写。强行安装 chriskacerguis/codeigniter-restserver 会导致 Call to undefined method CodeIgniter\HTTP\Request::uri() 等兼容性错误。
它的中间件、钩子、输出格式化逻辑都依赖 CI3 的 Output 类和 Hook 系统，CI4 已弃用这些。
- CI4 推荐用 Filters 做鉴权/日志，而不是在控制器基类里塞逻辑
- 内容类型协商（如 Accept: application/xml）需自行判断，CI4 不内置 XML 响应支持
- 如果真需要快速启动，可参考官方
spark serve+ 自定义响应结构，比硬套旧库更稳
真正麻烦的不是写几个接口，而是把「自动 content-type 切换」「批量验证错误映射」「标准化分页响应」这些细节理清楚——它们不会因为用了某个库就自动变好，反而容易被抽象层掩盖问题。
