升级thinkphp8后nginx伪静态配置需要修改，主要变化是入口文件路径和path_info解析方式。核心做法是将`try_files`指向`index.php`并追加`$query_string`，同时确保`fastcgi_param`正确传递`path_info`。
Nginx try_files 规则如何调整
ThinkPHP8默认使用`public/index.php`作为入口，旧版可能直接指向根目录或不同结构。新版推荐配置将未找到文件的请求重定向到入口脚本，并保留查询参数。
server {
listen 80;
server_name example.com;
root /path/to/your/project/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
# ThinkPHP8 关键：传递 PATH_INFO
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;
}
}
上述配置中，`try_files`指令按顺序尝试匹配URI、带斜杠的URI，最后 fallback 到`/index.php`并附加原始查询字符串。这确保了ThinkPHP的路由系统能接收到正确的URL信息。对于PHP处理块，必须显式设置`PATH_INFO`，因为某些Nginx版本默认不自动传递该变量给FastCGI进程。
PATH_INFO 在 FastCGI 中如何正确传递
ThinkPHP的路由依赖`$_SERVER['PATH_INFO']`来解析路由参数。如果Nginx配置不当，会导致路由失效或404错误。关键在于`fastcgi_param`的设置。
# 在 location ~ \.php$ 块中
location ~ \.php$ {
# ... 其他配置 ...
# 确保 PATH_INFO 被正确提取和传递
set $path_info "";
if ($uri ~ ^(.+\.php)(/.*)$) {
set $path_info $2;
}
fastcgi_param PATH_INFO $path_info;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
# 避免覆盖已有的 PATH_INFO (如果有的话)
fastcgi_param PATH_TRANSLATED $document_root$path_info;
}
这段代码通过正则表达式从`$uri`中提取出SCRIPT_FILENAME之后的部分作为`PATH_INFO`。这是处理ThinkPHP路由最稳健的方式之一，特别是当URL中包含多个路径段时。务必检查PHP-FPM的配置，确保`security.limit_extensions`允许`.php`扩展名，并且`catch_workers_output`等安全设置不会干扰日志记录。
ThinkPHP8 路由缓存对 Nginx 的影响
ThinkPHP8引入了更严格的路由缓存机制。在开发环境下，每次请求都会重新解析路由；在生产环境下，会读取缓存文件。Nginx配置本身不直接影响路由缓存，但错误的伪静态可能导致路由无法命中，从而表现为“缓存未更新”或“路由失效”。例如，如果`try_files`没有正确传递`$query_string`，带有GET参数的路由可能会失败。
// 验证路由是否生效的代码示例
// app/controller/Index.php
namespace app\controller;
class Index
{
public function hello($name = 'World')
{
return 'Hello, ' . $name;
}
}
访问`http://example.com/index/hello/ThinkPHP`应返回`Hello, ThinkPHP`。如果返回404，首先检查Nginx错误日志，确认是否因`PATH_INFO`缺失导致路由解析失败。其次，清除ThinkPHP的路由缓存（通常位于`runtime/route`目录），排除缓存干扰。确保Nginx的`try_files`规则与ThinkPHP的`app.php`配置中的`url_html_suffix`（如果启用）兼容。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
