如何在Docker容器中优化配置PHP-FPM与Nginx的通信机制？

本文共计734个文字，预计阅读时间需要3分钟。

如果您在Docker环境中部署PHP应用，但Nginx无法正确将PHP请求转发到PHP-FPM容器，问题通常源于FastCGI通信链路未建立或配置不正确。以下是一些实现稳定通信的配置方法：

一、通过宿主机端口映射实现TCP通信

该方法利用Docker的-p参数将PHP-FPM容器内部的9000端口映射到宿主机可用端口，使宿主机上的Nginx可通过127.0.0.1加映射端口访问PHP-FPM，适用于Nginx独立运行于宿主机的场景。

1、启动PHP-FPM容器，并确保端口映射与代码挂载同时生效：
docker run -d --name php-fpm-container -p 9000:9000 -v /var/www/html:/app bitnami/php-fpm:latest

2、确认宿主机上PHP-FPM服务可达：
curl -I http://127.0.0.1:9000

立即学习“PHP免费学习笔记（深入）”；

3、编辑宿主机Nginx server块，在location ~ \.php$段中配置fastcgi_pass指向宿主机映射地址：
fastcgi_pass 127.0.0.1:9000;

4、确保fastcgi_param SCRIPT_FILENAME路径与挂载路径一致：
fastcgi_param SCRIPT_FILENAME /app$fastcgi_script_name;

二、通过Docker自定义网络与容器IP直连

该方法创建用户定义桥接网络，使Nginx容器与PHP-FPM容器处于同一内网，Nginx可直接使用PHP-FPM容器的固定IP地址通信，避免端口冲突且提升隔离性。

1、创建自定义Docker网络：
docker network create my-php-network

2、启动PHP-FPM容器并加入该网络：
docker run -d --name php-fpm-net --network my-php-network -p 9000 -v /var/www/html:/app bitnami/php-fpm:latest

3、获取PHP-FPM容器在该网络中的IP地址：
docker inspect php-fpm-net | grep '"IPAddress"' | head -1 | awk -F'"' '{print $4}'

4、启动Nginx容器时同样加入my-php-network，并在Nginx配置中使用该IP：
fastcgi_pass 172.18.0.2:9000;

三、通过Docker --link 实现容器名解析（兼容旧版）

该方法依赖Docker内置的--link机制，在Nginx容器的/etc/hosts中自动添加PHP-FPM容器的主机名映射，使Nginx可直接使用容器名作为fastcgi_pass目标，适用于单机轻量部署。

1、先运行PHP-FPM容器并指定名称：
docker run -d --name php-fpm-link -v /var/www/html:/app php:8.1-fpm

2、运行Nginx容器时通过--link关联PHP-FPM容器：
docker run -d --name nginx-link -p 80:80 --link php-fpm-link:php -v /var/www/html:/usr/share/nginx/html:ro -v $(pwd)/conf.d:/etc/nginx/conf.d:ro nginx

3、在Nginx配置中直接使用链接别名php作为主机名：
fastcgi_pass php:9000;

4、确认PHP-FPM监听配置已改为TCP模式而非Unix socket：
在php-fpm.conf或www.conf中设置listen = 0.0.0.0:9000，并注释或删除listen = /run/php/php-fpm.sock行

四、通过Unix Socket文件挂载实现进程间高效通信

该方法将PHP-FPM的Unix socket文件路径挂载至Nginx容器内，利用IPC机制绕过TCP协议栈，降低延迟、提升吞吐，适用于Nginx与PHP-FPM同处一个Docker容器或共享存储卷的高并发场景。

1、修改PHP-FPM容器配置，使其监听本地socket文件：
在www.conf中设置listen = /var/run/php/php-fpm.sock，并设置listen.owner = www-data、listen.group = www-data

2、启动PHP-FPM容器时挂载socket目录为卷：
docker run -d --name php-fpm-sock -v /var/run/php:/var/run/php -v /var/www/html:/app php:8.1-fpm

3、启动Nginx容器时同步挂载同一socket路径：
docker run -d --name nginx-sock -p 80:80 -v /var/run/php:/var/run/php -v /var/www/html:/usr/share/nginx/html:ro nginx

4、在Nginx配置中引用挂载后的socket绝对路径：
fastcgi_pass unix:/var/run/php/php-fpm.sock;

5、确保Nginx worker进程用户与socket文件属主一致：
在nginx.conf中设置user www-data;