ThinkPHP路由规则详解

一 核心概念与启用方式

• 路由的作用是将用户友好的 URL 映射到对应的 控制器/方法 或 闭包，实现 URL 美化、SEO 优化 与访问控制。
• 在 ThinkPHP 5.x 中，需在配置中开启路由：设置 ‘URL_ROUTER_ON’ => true，并在路由定义文件（如 application/route.php）中编写规则；规则支持 规则路由 与 正则路由 两类。
• 在 ThinkPHP 6/8 中，路由默认启用，规则统一写在 route 目录（如 route/app.php），通过 use think\facade\Route; 注册，支持 GET/POST/PUT/DELETE/PATCH/HEAD/OPTIONS/ANY 等请求类型的快捷方法。

二 规则定义与匹配机制

• 基本语法：
  • 配置文件方式（TP5 常见）：
    • 格式1：'路由规则' => '分组/模块/操作?额外参数'
    • 格式2：'路由规则' => ['分组/模块/操作', '额外参数']
    • 格式3：'路由规则' => '外部地址'（跳转）
    • 格式4：'路由规则' => ['外部地址', '重定向码']（如 301）
  • 代码方式（TP6/8 推荐）：
    • Route::rule('规则', '地址', '请求类型')，或使用快捷方法如 Route::get()/post()。
• 规则表达式：
  • 静态片段与动态片段组合，动态片段可用 :变量 或 <变量>（官方倾向 <变量>）。
  • 示例：blog/<id>、new/<year>/<month>/<day>。
• 匹配顺序与完全匹配：
  • 系统按注册顺序逐一匹配，命中首个即停止；
  • 默认“前缀匹配”，如需“完整匹配”，在末尾加 $，如 hello/<name?>$。
• 可选参数：
  • 使用 [] 或 <变量?>，如 hello/[:name] 或 hello/<name?>；
  • 可用 default() 设置默认值：->default(['name'=>'world'])。
• 变量规则（约束）：
  • 局部约束：->pattern(['id'=>'\d+'])；
  • 全局约束（TP5）：在路由配置中定义 ‘pattern’；
  • 局部规则优先级高于全局规则。

三 路由地址与参数控制

• 路由地址写法：
  • 控制器/操作：'Index/hello'、'group.Blog/details'；
  • 完整命名空间：'\app\controller\Address@details'；
  • 外部地址或重定向：Route::redirect('ds/:id', 'http://localhost:8000', 302)；
  • 闭包路由：Route::get('think/:name', function($name){ return 'Hello, '.$name; })。
• 额外参数与行为控制（链式调用）：
  • 固定参数：->append(['status'=>1])；前置过滤：->filter(['id'=>5])；
  • 后缀限制：->ext('html|shtml')；协议限制：->https()；
  • 域名限制：->domain('localhost')；请求方式：->ajax()/pjax()/json()；
  • 跨域：->allowCrossDomain(['Access-Control-Allow-Origin'=>'*'])；
  • 批量参数：->option(['ext'=>'html','https'=>true])。
• 静态路由与映射（TP5）：
  • 使用 URL_MAP_RULES 定义完全匹配映射，性能更高，如：'new/top' => 'Index/top?type=top'。

四 分组、资源、注解与 MISS

• 路由分组：为相同前缀路由统一设置前缀、中间件、域名、后缀等。
  • 示例：

    Route::group('address', function(){
        Route::rule('ds/:id', 'details');
        Route::rule('rd/:id', 'read');
    })->prefix('Address')->ext('html');
    

• 资源路由：一键生成 RESTful 路由（TP5 常见）。
  • 示例：Route::resource('blog', 'Blog');（生成 index、read、save、update、delete 等）。
• 注解路由（TP6/8 常用）：在控制器方法上使用注解声明路由与请求类型。
  • 示例：

    /** @route('hello/:name', method='get') */
    public function hello($name){ return 'Hello, '.$name; }
    

• MISS 路由：未匹配到规则时的兜底处理。
  • 全局：Route::miss('public/miss');
  • 分组：Route::group('address', function(){ ... })->miss('miss');。

五 实战示例与常见问题

• 示例一（TP5 配置式，含可选参数与后缀）：

  return [
      // 全局变量规则
      '__pattern__' => [
          'id'   => '\d+',
          'year' => '\d{4}',
          'month'=> '\d{2}',
      ],
      // 可选参数 + 固定参数 + 后缀限制
      'blog/[:id]' => ['blog/read', ['method'=>'get'], ['status'=>1]],
      'blog-<year>-<month>' => 'blog/archive',
  ];
  

• 示例二（TP6/8 代码式，含完全匹配与默认参数）：

  use think\facade\Route;
  
  Route::get('hello/<name?>$', 'Index/hello')
       ->default(['name'=>'world'])
       ->ext('html');
  

• 常见问题与排查：
  • 访问 /hello 却匹配到 /helloabc：忘记在末尾加 $ 做完全匹配；
  • 路由不生效：确认已启用路由、规则顺序正确、请求类型匹配（如 GET/POST）；
  • 美化 URL 未生效：确认 URL 重写 已开启（如 Apache .htaccess 或 Nginx try_files），隐藏入口文件 index.php；
  • 变量类型不符：为参数添加 pattern（如 \d+）。