nginx配置php教程，nginx配置php环境步骤详解？

Nginx 配置 PHP 的核心结论

Nginx 本身无法直接解析 PHP 动态脚本，必须借助 PHP-FPM（FastCGI Process Manager）进行协同工作。 正确配置的核心在于两点：一是通过 fastcgi_pass 将动态请求精准转发至 PHP-FPM 监听端口或 Socket；二是准确设置 fastcgi_param 中的脚本路径参数，确保 Nginx 能找到并执行对应的 PHP 文件，只要这两条主线清晰，即可搭建一个稳定高效的 Nginx + PHP 运行环境。

基础配置：FastCGI 转发规则

这是 Nginx 配置 PHP 的核心环节，直接决定 Nginx 能否正确识别并处理 PHP 请求。 在 Nginx 的站点配置文件中，针对 PHP 请求的 location 块通常如下：

location ~ .php$ {
    root           /var/www/html;
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    include        fastcgi_params;
}

其核心逻辑在于：

• fastcgi_pass：指定 PHP-FPM 监听地址，使用 0.0.1:9000（TCP 端口）或 unix:/run/php/php8.1-fpm.sock（Unix Socket）。Unix Socket 因省去 TCP 握手开销，在高并发场景下性能更优；TCP 端口则更适合跨服务器分布式部署。 两者必须与 PHP-FPM 配置文件（pool.d/www.conf）中的 listen 参数保持一致，否则会连接失败。
• SCRIPT_FILENAME：这是 FastCGI 协议中最重要的参数，用于告诉 PHP-FPM 要执行的脚本绝对路径，使用 $document_root 拼接 $fastcgi_script_name 是最通用的方案，它能正确将请求 URL 映射到服务器文件系统路径。
• include fastcgi_params：引入 Nginx 自带的 FastCGI 公共参数文件，其中包含了 REQUEST_METHOD、QUERY_STRING 等必要环境变量，确保 PHP 应用能正常获取请求信息。

经验案例：酷番云某客户部署 ThinkPHP 框架时，直接套用网上模板将 root 写死为 /home/www，导致域名访问时 404，我们协助排查后发现，其实际站点根目录为 /var/www/project/public。解决方案是删除 location 块内的 root 指令，仅在 server 层级设置正确的 root，并调整 SCRIPT_FILENAME 为 $realpath_root$fastcgi_script_name，从而彻底规避了路径映射错乱问题。

高级配置：兼容 PATH_INFO 与安全加固

在 Laravel、CodeIgniter 等现代 MVC 框架中，路由常依赖 PATH_INFO 模式。 若直接使用上述基础配置，访问 /index.php/Home/Index 会报 404，此时需通过正则捕获路径信息并手动设置 fastcgi_param：

location ~ ^(.+.php)(.)$ {
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_split_path_info  ^(.+.php)(.)$;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    fastcgi_param  PATH_INFO       $fastcgi_path_info;
    include        fastcgi_params;
}

fastcgi_split_path_info 将请求 URI 拆分为脚本路径与额外路径信息，并赋值给 PATH_INFO 变量，让框架路由组件能正确解析控制器与方法。

安全方面，务必防范恶意 PHP 文件执行。 在实际环境中，用户可能上传带 .php 后缀的图片或文档，攻击者直接访问 /uploads/shell.php，若目录可写且配置疏漏，极易被植入 WebShell，建议采取以下加固方案：

• 限制上传目录的 PHP 执行权限：在 location ~ .(jpg|png|gif|pdf|zip)$ 块中显式关闭 PHP 解析。
• 设置 try_files 兜底：在 PHP location 块内加入 try_files $uri =404;，防止路径解析漏洞。

性能调优：PHP-FPM 池参数优化

Nginx 配置只是门面，真正承接 PHP 处理压力的核心是 PHP-FPM 的进程管理策略。

在 www.conf 中，pm 参数决定了 PHP-FPM 如何调度 worker 进程：

• pm = dynamic（动态模式）：根据并发压力动态调整进程数。pm.max_children 设定最大子进程数，pm.start_servers 设定启动时进程数，适合绝大多数场景，能平衡内存占用与响应速度。
• pm = static（静态模式）：固定 pm.max_children 数量的进程，内存充足且流量平稳时，静态模式可避免频繁 fork 带来的性能波动。
• request_terminate_timeout：建议设为 30-60 秒，防止脚本死循环或外部 API 超时导致 worker 被长期占用。

调优核心指标是 pm.max_children 的计算：

pm.max_children = 可用物理内存 / 单个 PHP 进程平均内存占用（约 30-50MB）

2GB 内存的服务器，预留 1GB 给 Nginx 与数据库，剩余 1GB 分配给 PHP，可设置 pm.max_children = 25 左右。

经验案例：酷番云另一客户部署 WordPress 后频繁出现 502 Bad Gateway，我们通过 top 命令观察负载，发现 PHP-FPM 内存耗尽。将 pm.max_requests 设置为 500，让子进程处理完 500 个请求后自动退出并重建，有效缓解了内存碎片及第三方扩展导致的内存泄漏问题，同时开启 pm.status_path = /status，配合 Nginx 防护规则仅允许内网 IP 访问，实现实时监控 PHP-FPM 健康状态。

常见问题排查与解决方案

遇到白屏或 502 错误时，首要任务是确认 PHP-FPM 服务是否正常运行。 执行 systemctl status php8.1-fpm 检查服务状态，或直接使用 curl -I http://127.0.0.1:9000 测试端口连通性。

排查步骤建议按以下顺序进行：

• 查看 Nginx 错误日志 error.log 和 PHP-FPM 慢日志 slow.log，定位具体报错语句。
• 确认 fastcgi_pass 后是否遗漏了分号，或配置文件语法是否正确：nginx -t。
• 验证运行 Nginx 的用户（如 www-data）对站点目录、PHP 文件是否有读和执行权限。
• 开启 display_errors = On 临时显示 PHP 报错，排查完务必关闭。

相关问答

Nginx 配置 PHP 后访问 PHP 文件出现“Access denied”错误，通常是什么原因？
答：这通常是因 SCRIPT_FILENAME 指向了 Nginx 无权访问的路径，或是 PHP-FPM 的 open_basedir 限制了脚本访问目录，首先核对配置中的 $document_root 与站点实际根目录一致；其次检查 PHP 进程用户是否对该目录有执行权限；最后确认 open_basedir 设置是否过严，必要时在 php.ini 或网站配置中放宽目录白名单，或使用注释方式暂时禁用该指令以快速定位。

为什么 Nginx + PHP 环境在高并发下性能不佳？
答：性能瓶颈多数不在 Nginx，而在 PHP-FPM 进程的调度策略与系统资源分配，建议先检查 php-fpm 的 slow.log，看是否存在大量超过阈值的慢请求；再结合服务器物理内存与进程数，优化 pm.max_children 和 pm.max_requests；可同时开启 Nginx 的 gzip 与 FastCGI 缓存，并为静态资源设置长过期时间，若单台服务器仍无法支撑，则考虑升级至更高配置的云主机（如酷番云高性能云服务器），通过 CDN 分流或负载均衡架构进一步横向拓展。

互动引导：您在实际配置 Nginx + PHP 过程中遇到过哪些棘手问题？是 Location 规则冲突、伪静态失效，还是高频下的性能崩塌？欢迎在评论区留言分享，我们会结合酷番云大规模运维实战经验，为您提供具有针对性的优化方案。