thinkphp实现restful api核心在于路由映射精准、控制器方法严格对齐http动词、数据收发全程json化、响应格式统一；tp6与tp8在命令支持、路由写法（tp6用'api.user'，tp8用'api.usercontroller'）、方法命名（read/save/update/delete）及中间件机制上差异显著，混用文档易踩坑。
ThinkPHP 实现 RESTful API 接口，核心不在“能不能”，而在“怎么对”——路由映射要准、控制器方法要严、数据收发要稳、响应格式要统一。版本差异明显，TP6 和 TP8 的命令支持、默认行为、中间件机制都不同，踩坑多源于混用文档或跳过关键约束。
资源路由必须手动注册，且写法不能错
ThinkPHP 不会自动生成 RESTful 路由，哪怕你用了 make:controller 命令。必须在 app/route/app.php（TP6）或 app/route.php（TP8）里显式写：
-
TP6 写法：
Route::resource('users', 'api.User');—— 第二个参数用点号分隔，不是斜杠也不是反斜杠 -
TP8 写法：
Route::resource('users', 'api.UserController');—— 类名需带 Controller 后缀，且命令支持--api参数 - 路径前缀不自动加
/api，如需统一前缀，得套一层分组：Route::group('api', function () { Route::resource('users', ...); }); - 多应用模式下，确保
api是已启用的应用名，否则路由解析失败直接 404
控制器方法名和语义必须严格对齐
RESTful 不是靠注释或配置生效的，而是靠方法名与 HTTP 动词硬绑定。ThinkPHP 按约定调用固定名称的方法：
-
index()→ GET /resources（列表） -
read($id)→ GET /resources/:id（单条）；TP8 中直接用$this->request->param('id')取值 -
save()→ POST /resources（创建）；不是store() -
update($id)→ PUT /resources/:id（全量更新） -
delete($id)→ DELETE /resources/:id（删除） - TP6 不支持
show()或destroy()这类 Laravel 风格命名，用错就 404 或调不到方法
请求与响应必须全程 JSON 化
API 接口不是网页，不渲染模板、不返回 HTML，所有环节都要围绕 JSON 展开：
- 接收数据时，前端发 JSON 就设
Content-Type: application/json，后端统一用$this->request->param()（TP8 自动解析 JSON body + query + form） - 表单提交可用
$this->request->post()，但注意 TP8 默认过滤空值，调试建议先打印$this->request->param() - 所有返回必须调用
json()函数，不能只return ['data' => ...]；否则可能输出裸数组、触发视图渲染或返回空白 - 推荐在基础控制器里重写
success()和error()方法，统一结构如['code'=>0, 'msg'=>'', 'data'=>[]]，并强制设置Content-Type: application/json; charset=utf-8
绕过浏览器限制：PUT/DELETE 请求要带头
多数前端环境（尤其表单或旧版 JS）无法原生发出 PUT/DELETE 请求，ThinkPHP 默认不开启方法伪造支持：
- 前端必须在请求头中添加
X-HTTP-Method-Override: PUT或DELETE - TP6 需确保请求走的是 POST 方法，再靠 header 重写语义；TP8 已内置支持，但也要确认未被中间件拦截
- 测试时用 Postman 或 curl 直接发原生 PUT/DELETE 更可靠，避免因伪造逻辑出问题误判接口故障
- 跨域场景下，
X-HTTP-Method-Override属于自定义头，需在 CORS 中间件里显式允许：Access-Control-Allow-Headers: X-HTTP-Method-Override, Content-Type
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
