ThinkPHPNginx伪静态怎么配置-ThinkPHP-PHP中文网

thinkphp在nginx下伪静态需三者协同：nginx用try_files正确转发至public/index.php、root指向public目录、php fastcgi_param传入$realpath_root和path_info；框架开启路由、pathinfo_depr设为/、url_html_suffix留空；缺一将导致404或白屏。

thinkphpnginx伪静态怎么配置

ThinkPHP 在 Nginx 下实现伪静态，核心就三点：Nginx 正确转发请求到 public/index.php、框架路由真正启用、两者参数逻辑对得上。光改其中一项，大概率 404 或白屏。

Nginx 配置必须用 `try_files`（推荐且稳定）

旧式 if (!-e $request_filename) 写法在 Windows、PHP 8.2+ 和 ThinkPHP 8.x 下容易导致 PATH_INFO 为空，页面直接空白，不报错，极难排查。
请直接替换为以下标准配置：

location / {
    index index.php;
    try_files $uri $uri/ /index.php?$query_string;
}

⚠️ 关键细节：

root 指令必须指向 public/ 目录，例如：
root /www/wwwroot/myapp/public;
若指向项目根目录（如 /myapp/），会找不到 vendor/autoload.php，报 Class 'think\App' not found 并静默白屏。
这段 location / 要放在 server { } 块内，且不能嵌套在其他 if 或 location 中。
若部署在子目录（如 https://site.com/myapp/），把最后一项改为：
/myapp/index.php?$query_string;

PHP 处理块要传对 `SCRIPT_FILENAME`

在同一个配置文件中，找到 location ~ \.php$ { } 块，确保包含这三行（缺一不可）：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param QUERY_STRING $query_string;

✅ 推荐用 $realpath_root（非 $document_root），它能正确解析符号链接，ThinkPHP 8 强依赖此项。
❌ 不要用 $request_filename 拼路径——Windows 下大小写或反斜杠易出错，日志常报 Primary script unknown。

ThinkPHP 框架内必须同步开启并匹配

打开 config/app.php，确认以下三项：

'url_route_on' => true —— 路由开关必须开
'pathinfo_depr' => '/' —— 必须是 /，和 try_files 中 ?$query_string 的分隔逻辑一致
'url_html_suffix' => '' —— 留空，才能支持 /user/list 这类无后缀 URL；设成 .html 就只能访问带后缀的地址

TP6/8 默认开启路由，但检查 app/middleware.php 是否误删了：
think\middleware\ParseUrl::class

验证顺序别跳步

先测带 index.php 的地址：
http://localhost/index.php/index/hello → 能打开，说明 PHP 和框架本身正常
再测伪静态地址：
http://localhost/index/hello → 404？查 Nginx 是否重载、root 是否指对 public、try_files 是否写错位置
白屏（HTTP 200 但空内容）？立刻看 Nginx 错误日志，搜 Primary script unknown 或 No input file specified，90% 是 SCRIPT_FILENAME 拼错了