ThinkPHP 8 的路由是一套完整体系,官方手册《路由》一章下设多个子类:路由定义、路由变量规则、路由绑定、路由到控制器、路由分组、资源路由、MISS 路由、URL 生成、路由中间件、域名路由、路由别名、路由缓存与强制路由。本文按子类逐一整理,可作速查手册使用。参考:ThinkPHP 8 路由。
一、路由定义
路由默认定义在 route/app.php(路由配置项在 config/route.php),用 thinkfacadeRoute 门面注册。支持 get/post/put/delete/patch/options/head/any 等请求类型,Route::rule 可自定义:
use thinkfacadeRoute;
Route::get('blog/:id', 'blog/read');
Route::post('blog', 'blog/create');
Route::put('blog/:id', 'blog/update');
Route::delete('blog/:id', 'blog/delete');
Route::any('blog', 'blog/index');
Route::rule('blog/:id', 'blog/read', 'GET|POST');
二、路由变量规则
路由表达式支持静态路由、动态参数 :id、可选参数 [/:month],参数可以用正则限制:
Route::get('blog/:id<\d+>', 'blog/read');
Route::get('blog/:id', 'blog/read', ['id' => '\d+']); // 数组形式给参数加规则
Route::get('blog/:year<\d{4}>/:month<\d{2}>', 'blog/archive');
Route::get('blog/:year[/:month]', 'blog/archive'); // month 为可选参数
- 表达式末尾加
$表示完整匹配,避免前缀相同互相干扰 - 全局默认参数规则在
config/route.php的default_route_pattern中设置
三、路由绑定
路由支持绑定到模块、控制器或命名空间。绑定之后,路由规则里的目标路径可以进一步简化(例如只写操作方法名)。多模块项目常把路由绑定到指定模块,与下一节的路由到控制器配合使用。
四、路由到控制器与闭包
Route::get('blog/:id', 'blog/read'); // 控制器/操作
Route::get('blog/:id', 'index/blog/read'); // 模块/控制器/操作
Route::get('hello', function () { // 路由到闭包
return 'hello,thinkphp';
});
Route::get('blog/:id', function ($id) { // 闭包接收路由参数
return 'blog id = ' . $id;
});
Route::redirect('blog/:id', 'blog/read/:id', 302); // 路由到重定向
Route::view('hello', 'hello'); // 路由到视图模板
五、路由分组
Route::group('blog', function () {
Route::get(':id', 'blog/read');
Route::post('', 'blog/create');
})->pattern(['id' => '\d+']);
分组统一设置参数规则、前缀、中间件等,避免逐条重复定义。
六、资源路由
Route::resource('blog', 'Blog');
一条规则注册整套 RESTful 操作:index、create、save、read、edit、update、delete,自动对应 GET/POST/PUT/DELETE 等请求类型,标准 CRUD 首选。
七、MISS 路由
Route::miss('index/index');
当所有路由规则都不匹配时执行 miss 路由,常用于 404 页面或统一兜底。
八、URL 生成
url('blog/read', ['id' => 10]); // 按路由规则反向生成地址
url('blog/read');
用 url() 助手函数按路由反向生成 URL:路由规则怎么改,生成的地址自动跟着变;也支持生成带域名、带后缀的完整地址。
九、路由中间件
Route::group('api', function () {
Route::get('user', 'user/index');
})->middleware(['auth']);
路由可以挂载中间件,做登录校验、权限控制、跨域处理等;分组挂载后整组规则统一生效。
十、域名路由
域名路由把某个域名绑定到指定的模块、控制器或路由分组,适合多域名站点和 API 域名分离 —— 不同域名各自维护独立的路由规则,互不影响。
十一、路由别名
Route::alias('user', 'index/user');
别名用一个简短的 URL 名称映射到真实控制器:访问 /user 即等同于 /index/user,对外提供简洁 URL。
十二、路由缓存与强制路由
- 路由缓存:路由规则很多时,在
config/route.php开启route_check_cache相关配置,把路由规则缓存起来提升解析性能;改动路由后记得清缓存。 - 强制路由:设置
'url_route_must' => true后,未定义路由的 URL 直接 404,API 项目用它收紧入口。
十三、综合小实例:博客文章接口的路由设计
把前面各小节串起来,给一个博客文章接口做完整路由设计(route/app.php):
<?php
use thinkfacadeRoute;
// 1. 文章接口:分组 + 请求类型 + 参数规则
Route::group('blog', function () {
Route::get('', 'blog/index'); // 列表:静态路由
Route::get(':id<\d+>', 'blog/read'); // 详情:动态参数 + 正则限制
Route::post('', 'blog/create'); // 发布:POST
})->pattern(['id' => '\d+']); // 分组统一参数规则
// 2. 后台管理:资源路由一把梭 + 中间件鉴权
Route::group('admin', function () {
Route::resource('blog', 'Blog'); // RESTful CRUD 全套
})->middleware(['auth']);
// 3. 兜底:miss 路由
Route::miss('index/miss');
模板里用 url() 反向生成地址,路由规则改动后地址自动跟着变:
url('blog/read', ['id' => 10]); // 生成 /blog/10
访问效果一览:GET /blog 查列表、GET /blog/10 看详情(id 不是数字则不匹配该规则)、POST /blog 发文章、/admin/blog 走带鉴权的后台 CRUD,其余 URL 由 miss 路由兜底。一组小例子,把变量规则、请求类型、分组、资源路由、中间件、URL 生成和 MISS 路由全用上了。
十四、总结
route/app.php 定义规则,:id 与正则控制匹配,绑定和分组组织批量规则,资源路由快速搭 CRUD,miss 兜底,url() 反向生成地址,中间件挂横切逻辑,域名路由做多域分流,别名给简洁 URL,缓存提性能,url_route_must 收紧入口 —— 这就是 ThinkPHP 8 路由的全貌。