【修复指南】解决宝塔面板 Windows 版 Nginx 的 Pathinfo 兼容性问题
在使用宝塔面板（Windows版）并选择 Nginx 作为 Web 服务器时，许多开发者会发现经典的 PHP Pathinfo
模式失效，导致依赖此模式的框架（如 ThinkPHP、Laravel）路由全部返回 404
错误。本文将详细记录排查和解决此问题的全过程，希望能为你提供一个清晰的修复思路。
一、问题现象
网站配置了伪静态规则后，访问 https://yourdomain.com/index.php/some/path 这样的 URL 时，期望由 index.php 文件处理
/some/path 这部分路径信息，但服务器直接响应 404 Not Found 错误。
二、诊断与排查过程
我们的排查思路是自顶向下，从 Nginx 的主配置开始，逐步深入到具体站点的 PHP 配置。
1. 定位 Nginx 主配置
首先，我们进入宝塔的 Nginx 安装目录，找到了配置文件所在的位置：D:\BtSoft\nginx\conf。
2. 分析主配置文件 `nginx.conf`
通过阅读 nginx.conf 文件，我们在文件末尾发现了一行关键指令：
1 include vhost/*.conf;
这行代码告诉我们，Nginx 会加载 D:\BtSoft\nginx\conf\vhost\ 目录下的所有 .conf 文件作为虚拟主机（即网站）的独立配置。
3. 深入 Vhost 网站配置
接着，我们查看 vhost 目录，找到了具体站点的配置文件，例如
plat.shop.localhost.wlphp.com.conf。打开该文件后，我们没有直接看到处理 PHP 的 location 块，而是发现了另一行 include 指令：
1 # PHP-INFO-START
2 include php/73.conf;
3 # PHP-INFO-END
这表明，所有使用 PHP 7.3 版本的网站，其 PHP 解析逻辑都由 D:\BtSoft\nginx\conf\php\73.conf
这个共享文件来控制。问题范围被进一步缩小。
4. 锁定最终目标 `php/73.conf`
最后，我们打开了 php/73.conf 文件，看到了导致问题产生的原始配置：
1 # 错误的原始配置
2 location ~ \.php(.*)$ {
3 try_files $uri =404;
4 fastcgi_pass 127.0.0.1:20073;
5 fastcgi_index index.php;
6
7 fastcgi_split_path_info ^((?U).+\.php)(/?.+)$;
8 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
9 fastcgi_param PATH_INFO $fastcgi_path_info;
10
11 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
12 include fastcgi_params;
13 }
三、根本原因分析
上述配置中的 try_files $uri =404; 是导致 Pathinfo 失效的罪魁祸首。
* 工作原理：当请求的 URL 为 /index.php/some/path 时，Nginx 将整个字符串视为 $uri。
* 错误行为：try_files 指令会检查服务器磁盘上是否存在一个与 $uri 完全同名的文件。由于 index.php/some/path
这个文件路径在磁盘上必然不存在，Nginx 便直接返回了 404 错误，请求流程被提前中断，根本没有机会将 PATH_INFO 传递给
PHP-FPM 进行处理。
四、解决方案
我们的目标是移除错误的 try_files 指令，并对配置进行清理和优化，使其能正确地拆分和传递 Pathinfo。
我们将 php/73.conf 文件的内容修改为如下：
1 # 正确的修复后配置
2 location ~ \.php(/.*)?$ {
3 fastcgi_pass 127.0.0.1:20073;
4 fastcgi_index index.php;
5
6 # 核心：拆分URL，分离出脚本名和PATH_INFO
7 fastcgi_split_path_info ^(.+?\.php)(/.*)$;
8
9 # 设置传递给PHP的参数
10 # SCRIPT_FILENAME 指向实际的脚本文件路径
11 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
12 # PATH_INFO 包含URL中脚本名之后的部分
13 fastcgi_param PATH_INFO $fastcgi_path_info;
14
15 # 加载通用的fastcgi配置，代替易产生冲突的 fastcgi_params
16 include fastcgi.conf;
17 }
修改点解析：
1. 删除了 `try_files $uri =404;`：这是最关键的一步，确保了请求不会被提前中断。
2. 优化了 `location` 正则：\.php(/.*)?$ 能更好地匹配 .../index.php 和 .../index.php/path 两种形式。
3. 清理了参数：移除了重复的 SCRIPT_FILENAME 定义。
4. 替换为 `include fastcgi.conf;`：fastcgi.conf 文件通常比 fastcgi_params
包含更完整的参数设置，且不易与自定义参数冲突，提高了配置的健壮性。
五、操作总结
1. 找到文件：根据你的 PHP 版本，找到 D:\BtSoft\nginx\conf\php\XX.conf 文件（例如 73.conf、74.conf等）。
2. 替换内容：用上面提供的【正确的修复后配置】完全替换该文件的所有内容。
3. 重载服务：在宝塔面板的软件管理中，找到 Nginx 服务，点击“重载”或“重启”。
完成以上步骤后，Nginx 便能完美支持 PHP 的 Pathinfo 模式，你的 Web 应用路由问题也就迎刃而解。
版权声明：若无特殊注明，本文皆为《菜鸟站长》原创，转载请保留文章出处。
本文链接：【修复指南】解决宝塔面板 Windows 版 Nginx 的 Pathinfo 兼容性问题 - http://www.wlphp.com/?post=501
