ThinkPHP8.1在Docker的Nginx容器里伪静态规则怎么配-ThinkPHP-PHP中文网

ThinkPHP 8.1 在 Docker 的 Nginx 容器中伪静态失效，核心原因是 PATH_INFO 未正确传递、root 未指向 public 父目录、或 Nginx 配置未通过 volume 挂载生效；必须设置 root 为 /var/www/html（public 上级）、location / 中用 try_files $uri $uri/ /public/index.php?$query_string、location ~ \.php$ 中显式配置 fastcgi_param PATH_INFO $fastcgi_path_info 和 fastcgi_split_path_info ^(.+\.php)(/.+)$，并确保 SCRIPT_FILENAME 为绝对路径且 php.ini 中 cgi.fix_pathinfo=1。

thinkphp8.1在docker的nginx容器里伪静态规则怎么配

ThinkPHP 8.1 在 Docker 的 Nginx 容器里伪静态失效，核心不是“规则没写”，而是 PATH_INFO 没传过去、入口路径不对、或配置挂载没生效。直接套用 Apache 的 .htaccess 或简单加个 try_files 往往不行——Nginx 不解析 .htaccess，且 TP8.1 强制走 public/index.php，必须从 root、fastcgi_param、location 三处对齐。

root 必须指向 public 的父目录，不能是项目根

比如你的代码挂载在 /var/www/html，那里面结构是：

/var/www/html/app/
/var/www/html/public/ ← 入口目录（含 index.php）
/var/www/html/runtime/

那么 Nginx 的 root 必须设为 /var/www/html，而不是 /var/www/html/public，否则 CSS/JS 404，且 try_files 找不到静态资源。

验证方式：访问 http://localhost/static/css/app.css 能正常加载，说明 root 设置正确。

location / 块里用 try_files，不依赖 PATH_INFO

TP8.1 默认启用 URL 参数模式（s 参数），推荐用更稳定、无需 PATH_INFO 的写法：

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

注意三点：

Docker Desktop 4.96.1

下载

fallback 是 /public/index.php（带 public），不是 /index.php
末尾用 $query_string，不是 $args（避免特殊字符转义问题）
这条规则必须放在 所有 location ~ \.php$ 块之前，否则 PHP 路由请求会被提前匹配走

location ~ \.php$ 块必须透传 PATH_INFO（兼容路由调试）

虽然 try_files 方式可绕过 PATH_INFO，但 TP8.1 启动检测、部分扩展或自定义路由仍会读取 $_SERVER['PATH_INFO']。漏掉这行，可能触发 “URL pathinfo not supported” 错误：

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass php:9000;  # 指向 PHP-FPM 容器
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME /var/www/html/public/index.php;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
}

关键点：

SCRIPT_FILENAME 必须写死绝对路径，不要用 $document_root/public/index.php —— location 匹配偏差时容易出错
fastcgi_split_path_info 正则末尾用 /.+（非空），不是 /* 或 /.*，否则可能截断错误
确保 PHP-FPM 容器中 php.ini 有 cgi.fix_pathinfo=1（默认开启，但某些 Alpine 镜像会关）