ThinkPHP 6.0 开发 RESTful API 需手动完成控制器创建、资源路由注册、JSON 显式返回及请求方法重写；控制器需用 php think make:controller api/User 生成并继承 think\Controller，路由须在 app/route/app.php 中写 Route::resource('user', 'api.User')，方法名严格为 index/read/save/update/delete，所有返回必须用 json() 函数，前端 PUT/DELETE 请求需加 X-HTTP-Method-Override 头。
ThinkPHP 6.0 开发 RESTful API 并不难，但官方命令不提供“一键生成”，很多关键步骤必须手动补全，否则路由不通、方法不触发、返回空白或报错。下面用新手能跟上的节奏，把从零到可运行的全流程说清楚。
创建控制器要按路径命名，不能加 --api 参数
TP6 的 php think make:controller 命令根本不支持 --api 或 --resource 参数。运行 php think make:controller User --api 会直接报错：Unknown option --api——这不是你配错了，是框架压根没实现这个功能。
正确做法是用命名空间路径方式生成：
php think make:controller api/User
这会在 app/controller/api/User.php 创建文件，类名默认是 UserController，你需要手动确认它继承自 think\Controller（不是 think\facade\Controller），并确保不加载视图（TP6 默认可能尝试渲染模板）：
立即学习“PHP免费学习笔记（深入）”；
- 在控制器顶部写
use think\Controller; - 类定义为
class UserController extends Controller - 不需要手动设
$this->view = null，因为think\Controller已禁用视图
资源路由必须显式注册，且位置和写法有硬要求
生成控制器后，不会自动绑定任何路由。必须在 app/route/app.php（不是 api.php，也不是中间件分组里）添加：
Route::resource('user', 'api.User');
注意两点：
- 第二个参数写
'api.User'（点号分隔），不是'api/User'或'api\UserController' - 如果用了多应用模式，要先确认
api是已在app/multi.php中启用的应用名，否则解析失败直接 404
这条语句会映射：
-
GET /user→api\UserController::index() -
POST /user→api\UserController::save() -
GET /user/1→api\UserController::read($id) -
PUT /user/1→api\UserController::update($id) -
DELETE /user/1→api\UserController::delete($id)
方法名必须严格为 index、read、save、update、delete——写成 show、list、store 都不会被识别。
每个方法都要手动返回 JSON，不能只写 return 数组
TP6 默认响应类型是 HTML，即使你访问的是 API 路由，写 return ['data' => $user]; 也会导致空白页、500 错误，甚至输出未格式化的数组文本。
必须显式调用 json() 辅助函数：
-
return json(['code' => 0, 'data' => $users]);（列表） -
return json(['code' => 0, 'data' => $user], 201);（新建成功，建议返回 201） -
return json(['code' => 1, 'msg' => '用户不存在'], 404);（错误状态码也建议带上）
不要用 echo json_encode() + exit，会破坏框架生命周期；也不要用 Response::create(..., 'json')，json() 更简洁、更推荐。
前端发 PUT/DELETE 请求失败？加请求头就行
浏览器表单、部分 SDK（如 Axios 默认配置）只支持 GET/POST，发不出原生 PUT/DELETE，服务端收到会直接返回 405 Method Not Allowed。
解决方案很简单：前端在 POST 请求中加一个 header：
X-HTTP-Method-Override: PUTX-HTTP-Method-Override: DELETE
TP6 路由层原生识别该 header，并自动重写请求方法，后端代码完全不用改。测试时用 curl 最可靠：
curl -X POST -H "X-HTTP-Method-Override: PUT" http://localhost/user/1 -d "name=test"
