ThinkPHP5域名绑定开启伪静态正确配置-ThinkPHP-PHP中文网

thinkphp5伪静态失效的根本原因是服务器转发路径、框架入口文件（public/index.php）与path_info解析三者未严格匹配；需确保apache的allowoverride all、.htaccess置于public目录、nginx补全fastcgi_param path_info，并配置正确运行目录和路由参数。

thinkphp5域名绑定开启伪静态正确配置

ThinkPHP5 域名绑定后伪静态失效，根本原因不是规则写错了，而是服务器转发路径和框架入口文件不匹配 —— 大多数人漏掉了 public 目录层级或没设对运行目录。

Apache 下 .htaccess 不生效：检查 AllowOverride 和 rewrite_module

phpEnv、宝塔或自建 Apache 环境中，.htaccess 文件放在项目根目录却完全不触发，90% 是因为：AllowOverride 被设为 None，或者 rewrite_module 没启用。

用 phpEnv：进「Apache 设置 → 模块管理」勾选 rewrite_module，再打开对应站点的 vhost 配置（如 phpenv\apache\vhosts\yourdomain.conf），确认存在且路径正确的 <directory></directory> 块，并含 AllowOverride All
不要把 .htaccess 放在项目根目录（即含 application 的那层），TP5.1+ 默认入口是 public/index.php，.htaccess 必须放在 public/ 目录下

规则推荐用这一版（兼容 PATH_INFO）：

<ifmodule mod_rewrite.c>
  Options +FollowSymlinks -Multiviews
  RewriteEngine On
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]
</ifmodule>

注意末尾是 index.php?/$1，不是 index.php/$1；后者在部分 Apache 版本下会丢参数

Nginx 下 404 或报 “URL pathinfo not supported”

错误提示直接指向 PATH_INFO 解析失败。TP5 默认依赖 $_SERVER['PATH_INFO']，但 Nginx 不默认传递它，必须手动补全 fastcgi_param。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

确保 Nginx 的 location ~ \.php$ 块里有这行：
```
fastcgi_param PATH_INFO $fastcgi_path_info;
```
缺了这句，TP5 启动时就会中断并报错
伪静态规则不能只写 try_files $uri $uri/ /index.php?$query_string; —— 因为 TP5 入口在 public/index.php，所以必须写成：
```
location / {
  try_files $uri $uri/ /public/index.php?$query_string;
}
```
宝塔用户注意：网站「设置 → 运行目录」必须选 /public，否则 $_SERVER['DOCUMENT_ROOT'] 指向错误，runtime 目录写入失败，后续所有缓存、日志都会出问题

域名绑定后访问仍带 index.php 或跳转失败

这是框架层配置没对齐服务器行为。即使服务器重写成功，TP5 仍可能主动拼出含 index.php 的 URL，导致前端链接“看起来没伪静态”。

检查 config/app.php 中这几项：
```
'url_route_on' => true,
'url_html_suffix' => '.html',
'pathinfo_depr' => '/',
'route_config_file' => 'route',
```
其中 pathinfo_depr 必须是 '/'（不是 '_' 或 '-'），否则路由解析和服务器重写不一致
在 route/route.php 中定义的规则，比如 Route::rule('article/:id', 'index/article/read');，访问时必须用 https://yourdomain.com/article/123，而不是 https://yourdomain.com/index/article/read/id/123 —— 后者是未启用路由时的原始路径，不会被重写规则捕获
如果用了二级域名绑定（如 admin.yourdomain.com），确保该子域名的 Nginx/Apache 配置也单独设置了伪静态，且 root 指向的是同一份 public 目录