ThinkPHP的Nginx伪静态核心是用try_files将非静态请求统一转发至index.php处理并透传$query_string;需确保root指向public目录、PHP块中SCRIPT_FILENAME使用$realpath_root拼接,且禁用if+rewrite以防PATH_INFO为空导致白屏。

ThinkPHP 的 Nginx 伪静态规则核心是把所有非静态资源请求(如 JS、CSS、图片等)统一转发给 index.php 入口文件处理,同时保留原始 URL 路径供框架解析路由。
基础通用规则(适用于 ThinkPHP 5/6,默认入口 index.php)
将以下配置放入 Nginx 的 server 块中(如站点配置文件或 nginx.conf 的对应 location 块内):
location / {
try_files $uri $uri/ /index.php?$query_string;
}说明:
-
$uri先尝试匹配真实存在的文件(如 logo.png、style.css) -
$uri/再尝试匹配真实存在的目录(如 /admin/) - 都不命中时,交由
/index.php?$query_string处理,确保 GET 参数(如 ?id=123)不丢失
更严谨的写法(推荐,避免潜在问题)
显式排除静态资源,防止 PHP 错误处理图片或字体等二进制文件:
location / {
try_files $uri $uri/ /index.php?$query_string;
}
<h1>静态资源直接返回,不走 PHP</h1><p>location ~ .(js|css|png|jpg|jpeg|gif|ico|svg|woff2?|ttf|eot)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}</p>注意:
- 正则 location 优先级高于普通 location,所以静态资源会先被拦截并直接返回
- expires 和 Cache-Control 提升前端加载性能
入口文件不是 index.php 怎么办?
比如入口是 public/index.php 或自定义为 start.php:
- 若项目部署在子目录(如
https://example.com/app/),需配合root和重写路径调整 - 入口文件名变了,就改
try_files后面的路径,例如:try_files $uri $uri/ /start.php?$query_string; - ThinkPHP 6 默认使用
public/目录为 Web 根,此时 Nginx 的root应指向/path/to/your/project/public,规则仍用/index.php
验证是否生效
配置完别忘了:
- 执行
nginx -t检查语法 - 运行
nginx -s reload重载配置 - 访问一个带参数的路由(如
/user/list?page=2),确认不报 404 且能正常响应 - 查看 PHP 中
$_SERVER['REQUEST_URI']是否包含完整路径(如/user/list?page=2),这是框架正确解析路由的前提
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











