ThinkPHP如何使用资源路由_资源路由配置方法【详解】-ThinkPHP-PHP中文网

thinkphp6资源路由需控制器结构、注册方式和命名规范三者严格对齐才能生效；必须用php think make:controller --api生成标准资源控制器，route::resource('prefix','controller')参数顺序不可颠倒，且依赖app_route开启和路由缓存清理。

thinkphp如何使用资源路由_资源路由配置方法【详解】

资源路由在 ThinkPHP 6 中不是“开了就能用”的功能，它依赖控制器结构、注册方式和命名规范三者严格对齐；漏掉任一环节，Route::resource() 就会静默失效或只注册部分路由。

资源控制器必须用 `php think make:controller --api` 生成

手动新建控制器类、只写几个方法，Route::resource() 无法识别为标准资源控制器。ThinkPHP 的资源路由是按约定映射的，不是靠反射自动发现方法。

正确命令：php think make:controller index@Order --api（生成 API 风格，无 __construct 和模板逻辑）
错误做法：直接创建 app/index/controller/Order.php 并手写 index/read 等方法——缺少方法签名约束和注释标记，route:list 里可能只显示 2–3 条路由
生成后检查方法是否带完整 PHPDoc 注释，例如 /** * 显示资源列表 */，这是框架判断资源动作的依据之一

`Route::resource()` 的参数顺序不能颠倒

第一个参数是「路由前缀」，第二个才是控制器名；写反会导致所有路由地址错位，且不报错。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

✅ 正确：Route::resource('users', 'User'); → 生成 GET /users、GET /users/:id 等
❌ 错误：Route::resource('User', 'users'); → 生成 GET /User，但控制器类 users 根本不存在，运行时报 Class not found
多应用下控制器名要带应用前缀：Route::resource('admin/users', 'admin/User')，否则默认走 index 应用

资源路由不生效？先查 `app_route` 和缓存

资源路由本质仍是路由规则，受全局路由开关和缓存机制控制，和普通路由一样会卡在这两关。

确认 config/app.php 中 'app_route' => true，否则整个路由层被跳过
修改 app/route/app.php 后必须执行 php think route:clear，否则旧缓存仍生效（Swoole 环境尤其明显）
CLI 下查看注册结果：php think route:list | grep users，若无输出，说明没加载或语法错误
注意：资源路由不会出现在 route:list 的 “Name” 列里，除非你手动加了 ->name('users.index')

中文参数或特殊字符导致 `read` 匹配失败？加正则约束

资源路由默认的 :id 变量只匹配非斜杠字符，但不校验类型；传入中文、Base64 或含 % 的字符串时，URL 解码后可能被截断或匹配不到。

强制约束 ID 类型：Route::resource('articles', 'Article')->pattern(['id' => '\d+']);
支持中文标题：->pattern(['id' => '[\x{4e00}-\x{9fa5}a-zA-Z0-9_-]+'])（需 UTF-8 环境）
避免用 .*：->pattern(['id' => '.*']) 会贪婪匹配到 URL 末尾，吃掉后续查询参数
Apache 用户额外检查：.htaccess 中 RewriteRule 是否带 [QSA]，否则 ?token=xxx 会被丢弃

资源路由最易被忽略的是「控制器方法签名与请求方式强绑定」：比如 delete($id) 必须响应 DELETE 请求，前端发 POST 就 404；而这个限制不会在定义时提示，只在调用时失败。调试时别只看 URL 是否匹配，一定用 curl -X DELETE 或 Postman 显式指定 method。