route.php 配置需满足加载路径、命名空间、缓存清理三条件才生效;单应用必须用 route/app.php 并声明 use think\facade\Route,多应用放对应 app/{name}/route/app.php,自定义文件名需修改 config/app.php 中 'route_config_file',改后须执行 php think route:clear。

route.php 配置不是写完就生效,必须满足加载路径、命名空间、缓存清理三个硬性条件,缺一不可。
route.php 文件放哪?加载路径有严格约定
ThinkPHP 6+ 默认只自动加载 route/app.php(单应用)或 app/{name}/route/app.php(多应用)。你随便新建个 route/api.php 或 route/admin.php,只要文件名不是 app.php,且没在配置里显式引入,它就不会被加载。
- 单应用项目:路由必须写在
route/app.php,开头必须有use think\facade\Route; - 多应用项目:每个应用的路由应放在
app/index/route/app.php、app/admin/route/app.php等对应路径下 - 如果想用自定义文件名(如
route/api.php),需在config/app.php中修改'route_config_file' => 'api.php',否则无效
为什么写了 Route::get() 却 404?检查这三件事
最常见的是“写了但没生效”,本质是框架根本没读到你的规则。不是语法错,是加载链断了。
- 确认
config/app.php中'app_route' => true是布尔型true,不是字符串"true" - 改完
route/app.php后,必须执行php think route:clear,否则 runtime 缓存仍用旧规则 - 命令行启动服务(如 Swoole)时,要加
--with-route参数,否则路由不初始化
动态参数和正则约束怎么配才安全?
:id 这种写法默认匹配任意非斜杠字符,/user/abc123 也能过,但控制器里 read($id) 接收到的是字符串,可能引发类型错误或 SQL 注入。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 必须用
->pattern()显式约束:例如Route::get('user/:id', 'user/read')->pattern(['id' => '\d+']) - 多个参数要逐个约束:
->pattern(['id' => '\d+', 'name' => '[a-zA-Z]+']) - 中文支持需手动放开:
[\x{4e00}-\x{9fa5}a-zA-Z0-9_]+,但要注意 XSS 和路径遍历风险
强制路由模式下,漏掉根路径或 MISS 处理会直接 404
设了 'url_route_must' => true 后,框架不再回退到隐式 m/c/a 解析,所有请求都必须命中某条规则。这时两个地方最容易踩坑:
- 首页
/必须显式定义:Route::get('/', 'index/index'),否则访问域名直接 404 - 建议加全局未匹配兜底:
Route::miss(function() { return view('404'); });,避免裸奔报错 - 子域名路由(如
admin.example.com)必须独立注册,不能靠主域名路由继承
真正卡住人的往往不是语法,而是缓存没清、路径写错、配置项类型不对这些“看不见”的环节。每次改完 route.php,先跑一遍 php think route:list 看输出里有没有你写的规则,比反复刷新页面更省时间。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










