Nginx1.18里ThinkPHP8.1伪静态root必须指向public目录吗-ThinkPHP-PHP中文网

Nginx 1.18 部署 ThinkPHP 8.1 时 root 必须指向 public/ 目录，因框架入口、autoload 和路由解析均以该目录为基准，错配将导致白屏、404 及类加载失败。

nginx1.18里thinkphp8.1伪静态root必须指向public目录吗

是的，Nginx 1.18 中部署 ThinkPHP 8.1，root 必须指向 public/ 目录。这不是建议，而是强制要求。

ThinkPHP 8.1 沿用了 6.x 和 8.0 的目录结构规范：入口文件 index.php、静态资源（CSS/JS）、以及所有框架自动加载逻辑（如 vendor/autoload.php）都以 public/ 为基准路径。Nginx 的 root 指令决定了 PHP 脚本运行时的“当前工作根”，一旦错配，后果直接且隐蔽：

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

Class 'think\App' not found 错误（不报错、无日志、页面纯白）
所有非首页路由返回 404
路由解析完全失效，伪静态形同虚设

root 指向 public 的硬性依据

vendor/autoload.php 加载路径是相对 public/ 的，不是项目根目录
$realpath_root 在 fastcgi_param 中被框架内部用于定位类文件，它依赖 root 所指的真实物理路径
Nginx 的 try_files 和后续 SCRIPT_FILENAME 拼接均以 root 为起点，错位即断链

正确写法（Nginx 1.18 兼容）

root /var/www/myapp/public;  # Linux，末尾无斜杠，结尾有分号
# 或
root D:/www/myapp/public;    # Windows

常见错误写法（务必避免）

root /var/www/myapp; → 指向项目根，必白屏
root /var/www/myapp/public/; → 末尾多斜杠，部分系统解析异常
root /var/www/myapp/public; + 使用软链接路径 → $realpath_root 失效，autoload 找不到类

配套必须项（仅 root 正确还不够）

location / 块中必须用 try_files $uri $uri/ /index.php?$query_string;
location ~ \.php$ 块中必须含：
- fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;（不能用 $document_root）
- fastcgi_param QUERY_STRING $query_string;
删除所有 if 判断块（尤其是 if (!-e $request_filename)），Nginx 官方已标记为反模式