ThinkPHP伪静态规则全场景覆盖：从入门到企业级部署【教程】-ThinkPHP-PHP中文网

伪静态配不成功90%是服务器规则与框架配置未对齐；必须同时满足入口请求正确转发至index.php、path_info或s参数被识别、路由已开启且定义无误。

thinkphp伪静态规则全场景覆盖：从入门到企业级部署【教程】

伪静态配不成功，90% 不是 ThinkPHP 的问题，而是服务器规则和框架配置没对齐。直接生效的方案必须同时满足三件事：入口请求被正确转发到 index.php、PATH_INFO 或 s 参数能被框架识别、路由本身已开启且定义无误。

常见现象是写了规则但 URL 仍带 index.php，或直接 404。根本原因往往不是规则写错，而是底层支持缺失：

mod_rewrite 模块未启用：Linux 执行 sudo a2enmod rewrite 后必须重启 Apache（sudo systemctl restart apache2）；Windows 需打开 httpd.conf，取消 #LoadModule rewrite_module modules/mod_rewrite.so 注释
AllowOverride 不是 All：在虚拟主机或 <directory></directory> 块中，必须设为 AllowOverride All，设成 FileInfo 或 None 时 RewriteCond/RewriteRule 会被忽略
RewriteBase 缺失或错误：项目部署在子目录（如 /myapp/）时，.htaccess 必须加 RewriteBase /myapp/，否则重写路径会错位

标准可用规则（注意空格与斜杠方向）：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]

用 if (!-e $request_filename) 看似简单，但 Nginx 官方明确不推荐在 location 块中使用 if + rewrite 组合，容易触发意外匹配（比如把 /static/css/app.css 也重写进 PHP）。

可靠写法只有一条：try_files 顺序兜底：

location / {
    try_files $uri $uri/ /index.php?s=$uri&$args;
}

但关键在 FastCGI 参数——若漏配或配错，index.php/user/login 这类 PathInfo 路由必 404：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

必须确保 fastcgi_param PATH_INFO $fastcgi_path_info 存在（TP5/TP6 默认需要）
若用 s 参数模式（即 /index.php?s=/user/login），则无需依赖 PATH_INFO，但框架需设 'url_common' => true
宝塔面板用户注意：默认「ThinkPHP」伪静态模板只适配单应用，多应用必须手动替换为双 rewrite 规则

访问 /admin/login 404，但 /index.php/admin/login 正常？这是典型的应用前缀未被 Nginx 透传的信号。

宝塔或手动配置 Nginx 时，不能沿用单应用规则。必须用两条 rewrite 显式剥离应用名：

if (!-e $request_filename) {
    rewrite ^/([a-z0-9A-Z_\-]+)/(.*)$ /index.php/$1/$2 last;
    rewrite ^/(.*)$ /index.php/$1 last;
}

注意点：

正则中的字符集要覆盖实际应用名：含下划线或短横线就加 _\-，否则 user_api 或 api-v1 会匹配失败
last 不能写成 break：只有 last 才会重新发起内部请求，让 PATH_INFO 正确生成；break 会导致 url() 生成链接丢失应用前缀
框架层同步检查：config/app.php 中 'app_multi' => true 开启，app/multi.php 返回合法应用数组，各应用路由不带冗余前缀（如写 Route::get('login', ...)，而非 Route::get('admin/login', ...)）

子域名（如 admin.example.com）伪静态失败，通常卡在服务器层——请求根本没进到 index.php，框架路由压根没机会执行。

解决逻辑分两层：

Apache：所有子域名 VirtualHost 的 DocumentRoot 必须指向同一项目根目录（含 public/index.php），.htaccess 规则通用，但若子域名映射到子目录（如 public/admin/），则对应 VirtualHost 内必须显式设 RewriteBase /admin/
Nginx：每个子域名需独立 server 块，root 指向项目根目录，并复用相同的 try_files 规则；若用泛域名（*.example.com），则 server_name 写 ~^([a-z0-9\-]+)\.example\.com$，再通过 $1 变量做应用分流
框架内：开启 'url_domain_deploy' => true，用 Route::domain('admin.example.com', function () { ... }) 分组注册路由，否则即使请求进了入口，也会走默认域名逻辑