ThinkPHP资源路由对应的控制器目录?RESTful风格结构设计

ThinkPHP资源路由匹配失败需检查五点：控制器命名与路径、RESTful方法名、手动注册路由、参数名必须为$id、CSRF配置。任一环节不符（如类名、方法名、参数名错误或未调用Route::resource）均导致404/405。

资源路由匹配不到控制器，先查命名和目录结构

ThinkPHP 的 Route::resource() 默认按约定找控制器，不是按你随便起的类名或路径。它要求控制器必须在 appcontroller 下（或你配置的 app_namespace），且类名必须是资源名首字母大写的单数形式 + Controller 后缀。

• 比如 Route::resource('users', 'UserController') → 会去找 appcontrollerUserController.php，类名为 UserController
• 如果控制器放在子目录如 appcontrollerapiv1UserController.php，就必须显式写全命名空间：Route::resource('users', 'apiv1UserController')
• 类里方法名必须是标准 RESTful 动词：index、create、save、read、edit、update、delete —— 少一个或拼错，对应路由就 404

RESTful 方法不生效？检查是否启用了资源路由自动注册

ThinkPHP 默认不会自动加载资源路由，得手动调用 Route::resource() 或在路由文件里显式注册。光写 use thinkRoute; 不够，也不靠注解或配置文件自动发现。

• 常见错误：只在 route/app.php 里写了 return [];，但没调用 Route::resource()
• 正确姿势是在路由定义处直接写：Route::resource('posts', 'PostController');
• 如果用了多模块，注意资源路由默认绑定到当前模块；跨模块需加前缀，例如 Route::domain('admin')->group(function () { Route::resource('users', 'adminUserController'); });

参数绑定失败或 ID 总是 null，重点看路由变量名和方法签名

ThinkPHP 资源路由对主键参数有强约定：所有带 ID 的操作（read、edit、update、delete）默认期望 URL 中含 :id，且控制器方法第一个参数必须叫 $id —— 名字不对就收不到值。

• URL 示例：/users/123 → 匹配到 read($id)，参数名必须是 $id，不能是 $uid 或 $user_id
• 如果想换参数名，得改路由规则，比如 Route::resource('users', 'UserController')->param(['id' => 'uid']);
• 复合主键或非数字 ID（如 UUID）也能用，但中间件或验证逻辑要自己处理，框架不额外做类型转换

POST/PUT 请求返回 405 Method Not Allowed，其实是 CSRF 或请求头问题

这不是资源路由本身的问题，而是 ThinkPHP 默认开启 CSRF 防护，且对 PUT/DELETE 等非标准方法做了额外限制。浏览器表单原生只支持 GET 和 POST，所以常通过隐藏字段伪造，但容易漏掉关键点。

立即学习“PHP免费学习笔记（深入）”；

• 表单中必须带 <input type="hidden" name="_method" value="PUT">，且这个字段要在 CSRF token 字段之后（否则 token 校验可能提前失败）
• CSRF token 必须用 {:token()} 或 csrf_token() 输出，且不能被 JS 动态删掉或覆盖
• API 场景建议关闭 CSRF：'var_method' => '_method' 配置保留，但把 'token_on' => false 加到 app/middleware.php 的 VerifyToken 配置里

RESTful 结构看着简洁，但 ThinkPHP 的实现依赖严格命名和固定参数签名，少一个下划线、多一个空格、参数名差一个字母，都会让路由静默失效。最麻烦的是错误不报具体原因，只返回 404 或 405，得从 URL、类路径、方法名、参数名、表单字段这五处挨个对齐。