技术 · 思考 · 实践 · 成长

首页/ThinkPHP8/正文

ThinkPHP 8 路由完全指南:定义、变量规则、分组、中间件与 URL 生成

ThinkPHP813 次阅读

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 路由的全貌。

日子是崭新的,不要回头看,如果今年还掉眼泪,希望是喜极而泣。

评论交流

0 条评论 · 支持多级回复
验证码
暂无评论,来说说你的想法吧

相关文章

继续阅读