Nginx与PHP独立环境的高效搭配教程-php教程-PHP中文网

能高效协同，关键在于fastcgi链路稳定、script_filename路径精准拼接、cgi.fix_pathinfo=1强制启用、php-cgi需后台常驻且配置与nginx的fastcgi_pass严格一致。

nginx与php独立环境的高效搭配教程

独立环境下的 Nginx 与 PHP 能否高效协同，取决于 FastCGI 通信链路是否稳定、路径解析是否准确、配置是否隔离——不是装上就能跑，而是每一步都必须对齐。

fastcgi_pass 地址必须与 php-cgi 监听地址完全一致

Windows 下用 php-cgi.exe -b 127.0.0.1:9000 启动时，Nginx 的 fastcgi_pass 必须写成 127.0.0.1:9000；若改用 Unix socket（Linux 常见），则需确保 PHP-FPM 的 listen 和 Nginx 的 fastcgi_pass 指向同一文件（如 unix:/run/php/php8.4-fpm.sock）且权限匹配。

常见错误：Nginx 配置了 fastcgi_pass 127.0.0.1:9000，但实际运行的是 php-cgi -b 127.0.0.1:9001 → 直接 502
Windows 用户注意：php-cgi.exe 不支持 socket，只能用 TCP；php-fpm 在 Windows 上不可用，别搜“php-fpm windows”
Linux 用户建议优先用 socket：避免端口占用冲突，性能略优，但需确认 listen.owner 和 listen.group 与 Nginx 进程用户（如 www-data）一致

cgi.fix_pathinfo=1 是 Windows + Nginx 场景的硬性要求

PHP 默认值为 0，但在 Nginx 环境下设为 0 会导致 SCRIPT_FILENAME 解析失败，表现为请求 /index.php/test 时返回 404 或空白页。这个参数控制 PHP 是否尝试“修复”不规范的 PATH_INFO，而 Nginx 的 try_files 机制依赖它来拼出真实脚本路径。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

必须在 php.ini 中显式设置：cgi.fix_pathinfo = 1
同时必须配 cgi.force_redirect = 0：Windows 下启用重定向会强制跳转，导致所有 PHP 请求 404
修改后务必用 php --ini 确认加载的是目标 php.ini，再用 php -m | findstr "mysqli"（Windows）或 php -m | grep mysqli（Linux）验证扩展已启用

root 与 SCRIPT_FILENAME 拼接逻辑必须手动对齐

Nginx 不像 Apache 那样自动推导脚本绝对路径。它把 root 和请求 URI 拼给 PHP，而 PHP 用 SCRIPT_FILENAME 去执行。如果 root 写错、URI 匹配不全、或 fastcgi_param SCRIPT_FILENAME 拼接方式有误，就会 404 或报“No input file specified”。

典型正确写法（Windows）：

location ~ \.php$ {
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

关键点：$document_root 必须和 server 块里的 root 值一致；$fastcgi_script_name 是 URI 中的 .php 文件名，不能漏
多站点场景下，每个 server 块的 root 和其内部 location ~ \.php$ 的 SCRIPT_FILENAME 必须各自独立对齐，不能共用一套模板直接复制

Windows 下 php-cgi 启动必须后台常驻且防闪退

php-cgi.exe 是单进程、无守护机制的命令行程序，CMD 窗口关闭即终止。直接双击或普通 CMD 执行会导致服务中断，进而引发 Nginx 502。

推荐用 RunHiddenConsole.exe 启动（轻量、免安装）：

RunHiddenConsole.exe C:\php\php-cgi.exe -b 127.0.0.1:9000 -c C:\php\php.ini

或用 nssm 注册为系统服务：避免手动维护，但配置稍重，适合长期开发环境
不要省略 -c C:\php\php.ini 参数：否则 php-cgi 可能加载错误的 ini 文件，导致扩展未启用、时区不对等问题

最易被忽略的是：Nginx 和 PHP 的路径分隔符、空格、中文字符全部敏感，哪怕 root C:/www 少了个斜杠，或 extension_dir 用了反斜杠且没转义，都会让整个链路静默失败。调试时先看 Nginx error.log 和 PHP 的 stderr 输出，而不是只刷浏览器。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！