Nginx配置ThinkPHP PATHINFO模式详解

核心原理与目标

Nginx默认并不像Apache那样原生处理PATHINFO。要使ThinkPHP正常工作，需完成两件事：一是将非真实文件请求统一重写到入口文件index.php；二是将URI中携带的路径参数提取并传递给后端的PHP-FPM解析器。

第1步：编写Nginx配置文件

以下配置适用于项目位于 /project/ 目录的情况（请根据实际域名或根目录调整前缀）。将其合并至 server 块中即可。

location /project/ {
    index index.php;
    # 如果请求的文件不存在，则重写规则
    if (!-e $request_filename) {
        rewrite ^/project/(.*)$ /project/index.php/$1 last;
        break;
    }
}

# 处理PHP请求
location ~ .+\.php($|/) {
    set $script $uri;
    set $path_info "/";
    # 正则匹配提取脚本名和剩余路径
    if ($uri ~ "^(.+\.php)(/.+)") {
        set $script $1;
        set $path_info $2;
    }

    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php?IF_REWRITE=1;
    include fastcgi_params; # 假设fastcgi_params已在nginx.conf全局引入
    
    # 关键：向PHP传入PATH_INFO变量
    fastcgi_param PATH_INFO $path_info;
    fastcgi_param SCRIPT_FILENAME $document_root/$script;
    fastcgi_param SCRIPT_NAME $script;
}

第2步：理解配置逻辑

• 请求分发：首先将所有对 /project/ 的请求交给 index.php 处理，实现ThinkPHP的单一入口模式。
• 路径解析：第二段代码针对所有包含 .php 的请求，利用正则表达式从原始 $uri 中分离出真实的PHP文件（$script）和附加的路径信息（$path_info）。
• 参数传递：最后通过 fastcgi_param 将计算好的路径信息注入到环境变量中，供ThinkPHP路由层识别。

第3步：应用配置并重启服务

保存配置文件后，执行 nginx -t 检查语法。确认无误后重启Nginx使配置生效。此时可以测试如下格式的URL：

• http://localhost/project/Index/insert
• http://localhost/project/index.php/Index/delete

若能正常访问页面且无报错，说明PATHINFO模式已配置成功。

第4步：常见报错排查

如果在 if 指令中遇到 unknown directive 错误，通常是因为语法格式问题。Nginx要求 if 关键字和后面的左括号 ( 之间必须保留一个空格，即写作 if (...) 而不是 if(...)。

补充说明

上述配置中包含了 include /APMServ/nginx/conf/fastcgi_params;，如果您使用的是系统标准包（如Ubuntu/Debian），通常直接使用 include fastcgi_params; 即可，无需指定完整路径。若项目中使用了特定的环境工具集，请保持对应路径不变。