PHP配置Nginx环境方法与技巧

PHP在Nginx上运行的核心是配置Nginx将.php请求通过fastcgi_pass转发给PHP-FPM处理，需确保PHP-FPM已启动、监听地址与Nginx配置一致，并正确设置fastcgi_params及SCRIPT_FILENAME等关键参数。

PHP 要在 Nginx 上跑起来，核心不是改 PHP 配置，而是让 Nginx 知道怎么把 .php 请求转给 PHP-FPM 处理——漏掉这一步，页面直接下载或 502 是常态。

确认 PHP-FPM 已安装并运行

很多“配置失败”其实卡在底层服务没起来。Nginx 本身不解析 PHP，全靠 php-fpm 进程监听 socket 或端口。

• 检查服务状态：systemctl status php-fpm（CentOS/RHEL）或 systemctl status php8.1-fpm（Ubuntu/Debian，版本号需匹配）
• 确认监听地址：查看 /etc/php/*/fpm/pool.d/www.conf 中的 listen 行，常见值为 listen = /run/php/php8.1-fpm.sock 或 listen = 127.0.0.1:9000
• 若改过 listen，记得同步更新 Nginx 配置里的 fastcgi_pass，否则 502 错误必现

Nginx server 块中必须包含 fastcgi_pass 和相关参数

只写 location ~ \.php$ 而不配 fastcgi_pass，Nginx 就不会转发请求，浏览器可能直接下载 .php 文件。

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;  # 必须与 php-fpm 的 listen 一致
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

• include fastcgi_params 是基础变量集，不能省；但其中的 SCRIPT_FILENAME 默认值常不生效，所以必须显式重写
• 用 unix: socket 比 127.0.0.1:9000 更快且避免端口冲突，但路径权限要对：php-fpm 进程用户（如 www-data）需有读写 socket 文件权限
• 如果站点用到 PATH_INFO（如 ThinkPHP 的 index.php/a/b），还需加 fastcgi_split_path_info 和对应参数，否则路由失效

PHP 本身的配置影响运行结果但不决定能否启动

很多人花时间调 php.ini 却忽略 Nginx+PHP-FPM 协作逻辑。真正导致“白屏”“500”的常见 PHP 配置项只有几个：

• display_errors = Off → 开发时建议设为 On，配合 error_log = /var/log/php/error.log 查问题
• max_execution_time 和 memory_limit 在处理大文件或复杂逻辑时才关键，刚配环境时不用急着调
• date.timezone 不设会导致 getdate() 等函数警告，但不阻断执行
• 扩展是否启用（如 mysqli、pdo_mysql）取决于应用需求，Nginx 启动不依赖它们

最容易被忽略的是 socket 文件路径权限和 SCRIPT_FILENAME 的拼接逻辑——$document_root 必须真实指向 PHP 文件所在目录，否则 File not found 错误会静默发生，日志里只显示 “Primary script unknown”。