ThinkPHP6.1伪静态如何兼容路由分组-ThinkPHP-PHP中文网

ThinkPHP6.1伪静态真正兼容路由分组的关键在于服务器重写规则、框架路由解析、分组定义逻辑三者严丝合缝；需确保Nginx/Apache透传原始路径、分组显式绑定命名空间与路由名、修复旧URL入口逻辑，并通过三步验证确认生效。

thinkphp6.1伪静态如何兼容路由分组

ThinkPHP6.1伪静态要真正兼容路由分组，关键不是“让URL变干净”，而是确保服务器重写规则、框架路由解析、分组定义逻辑三者严丝合缝。常见问题如 /admin/user/list 404、/api/v2/users 匹配到错误控制器、语言前缀（如 /zh/about）被忽略，根源几乎都出在这三层没对齐。

一、服务器层：Nginx/Apache 必须把请求正确送进分组上下文

TP6.1 默认依赖 PATH_INFO 或 REQUEST_URI 解析路径，而路由分组（如 Route::group('admin', ...)）的前缀是在 PHP 层拼接的，服务器不能把它当普通路径截断。

Nginx 正确写法（放在 location / 块内，且必须在 location ~ \.php$ 之前）：
```
location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /public/index.php?s=$1 last;
    }
}
```
- ✅ /public/index.php 是硬性路径，不能省略
- ✅ s=$1 把原始路径（如 /admin/user/list）作为 s 参数传入，TP6.1 路由器能据此还原出完整 pathinfo
- ❌ 不要用 rewrite ^/admin/(.*)$ /public/index.php?s=admin/$1 —— 这会把分组逻辑提前下放到服务器，反而绕过 TP 的分组中间件和命名空间控制
Apache .htaccess（必须放在 public/ 目录下）：
```
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php?s=$1 [QSA,L]
```
- ✅ s=$1 同样保证路径原始结构透传
- ✅ QSA 保留原有 query 参数（如 ?page=2）
- ❌ 避免用 index.php/$1（PATH_INFO 模式），TP6.1 在多分组场景下易因 fastcgi_split_path_info 配置不一致导致前缀丢失

二、框架层：分组定义必须显式承载前缀与语义边界

光写 Route::group('admin', [...]) 不够，TP6.1 不会自动把 admin 当作模块或命名空间，它只负责拼 URL 前缀和统一中间件。

必须手动绑定命名空间与控制器路径：

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

下载
```
Route::group('admin', function () {
    Route::get('user/list', 'admin.UserController@list')->name('admin.user.list');
    Route::post('user/add', 'admin.UserController@add')->name('admin.user.add');
})->middleware('check.admin')->option(['url_html_suffix' => '']);
```
- ✅ admin.UserController 中的 admin. 是命名空间前缀，不是目录路径（需确认 app/controller/admin/UserController.php 存在）
- ✅ ->name() 不可省略：权限校验、URL 生成（如 url('admin.user.list')）全靠它
- ✅ ->option(['url_html_suffix' => '']) 防止分组内所有路由被自动加 .html（全局配置可能开启）

多级分组（如 API 版本隔离）要避免前缀叠加错乱：

Route::group('api', function () {
    Route::group('v2', function () {
        Route::get('users', 'api.v2.UserController@list')->name('api.v2.users');
    })->option(['domain' => 'api.example.com']); // 可选：限定域名
});

最终访问地址是 /api/v2/users，不是 /v2/users 或 /api/users/v2
外层 api 分组的中间件（如 CORS）会先执行，内层 v2 的 option 才覆盖

三、兼容旧 URL（如 `/index.php/admin/user/list`）需额外修复入口逻辑

部分老项目迁移时保留 index.php/xxx 形式，TP6.1 默认不识别。需在 public/index.php 开头补修复：

// public/index.php 第一行开始插入
if (!empty($_SERVER['PATH_INFO']) && strpos($_SERVER['PATH_INFO'], '/index.php/') === 0) {
    $_SERVER['PATH_INFO'] = substr($_SERVER['PATH_INFO'], 10);
}

同时确保 config/app.php 中：

'url_common_param' => true,   // 允许 s= 参数模式
'url_route_must'     => false, // 避免未匹配路由直接报错

再配合路由兜底：

// route/app.php 末尾
Route::any('[:module]/[:controller]/[:action]/[:id]', function () {
    $m = request()->param('module', 'index');
    $c = request()->param('controller', 'index');
    $a = request()->param('action', 'index');
    return redirect("/{$m}/{$c}/{$a}");
});

四、验证是否真兼容：三个必查点

请求 /admin/user/list 时，$request->rule()->getName() 应返回 'admin.user.list'，不是空或 app\controller\admin\UserController@list
中间件 check.admin 必须已注册且在分组内生效（可在中间件 handle() 中 dump($request->url()) 看原始路径）
执行 php think route:list，输出中该路由的 Name、Method、Rule、Route 四列应完整显示分组前缀与命名