必须开启config/route.php中的'rest_action_as_method' => true配置，否则ThinkPHP8资源路由不匹配PUT/DELETE请求；Route::resource()默认生成7条规则，如PUT /api/users/:id→update()，控制器方法名须严格对应且为public。
ThinkPHP 8 默认不启用 PUT/DELETE 等动词的路由匹配，直接写 Route::resource('users', 'UserController') 后发起 PUT 请求返回 404，是配置缺失导致的，不是代码写错了。
必须开启 rest_action_as_method 配置
ThinkPHP 8 的资源路由默认走“隐式映射”（比如把 /users/1 + POST 当作创建），而 PUT/DELETE 方法能否正确绑定到控制器的 update() 和 delete()，取决于这个开关：
-
config/route.php中必须显式设置'rest_action_as_method' => true - 若该配置不存在或为
false，框架会忽略 HTTP 动词，只按路径和参数匹配，PUT /users/1就找不到对应方法 - 该配置影响所有资源路由，不是单个路由可覆盖的选项
Route::resource() 生成的 7 条路由要核对清楚
执行 Route::resource('api/users', 'UserController') 后，实际注册的是这 7 条规则（注意 URI 和 Method 的组合）：
-
GET /api/users→index() -
GET /api/users/create→create()（API 场景通常不用，可忽略） -
POST /api/users→store() -
GET /api/users/:id→read()（注意：不是show()，ThinkPHP 8 用read()） -
GET /api/users/:id/edit→edit()（API 场景通常不用） -
PUT /api/users/:id→update() -
DELETE /api/users/:id→delete()
常见错误是控制器里写了 show() 却没写 read()，或前端请求了 /api/users/1 但用了 GET 却期望进 update() —— 这本质是动词和路径不匹配。
立即学习“PHP免费学习笔记（深入）”；
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
中间件和服务器环境可能拦截非标准方法
即使 ThinkPHP 路由配置正确，请求也可能在到达框架前就被拦下：
- Nginx 默认允许
GET、HEAD、POST，但有些精简配置会禁用PUT、DELETE；需检查nginx.conf中是否有limit_except或if ($request_method !~ ^(GET|HEAD|POST)$)类规则 - Apache 下确保
mod_rewrite已启用，且.htaccess没有重写掉非 GET/POST 请求 - 如果前端用表单模拟 PUT/DELETE，务必通过
X-HTTP-Method-Override头传递真实动词，且确认中间件（如AllowCrossDomain）没有过滤该 header
控制器必须继承 think\Controller 且方法名严格对应
生成 API 控制器时推荐用 --api 参数：
php think make:controller api/UserController --api
这样生成的类自动继承 think\Controller，并预置了 index、read、save、update、delete 五个方法。注意：
- 不要手动改成
show()或destroy()—— ThinkPHP 8 不识别这些 Laravel 风格命名 - 方法必须是
public，且不能加任何参数类型声明（如public function update(int $id)），否则 PHP 8.0+ 可能因签名不匹配导致调用失败 - 返回值建议统一用
json()：return json(['code' => 200, 'data' => $user]);
最易被忽略的一点：资源路由的动词绑定依赖于控制器方法名与 HTTP 方法的字面映射，而不是注释或配置；一旦方法名拼错或少写一个，就彻底断连，且不会报错，只会 404。
