引言
将PHP-FPM应用程序部署在Docker容器中已成为现代Web开发中的常见实践，它提供了环境隔离和部署便捷性。然而，在某些场景下，例如为了利用宿主机Nginx的现有配置、性能优势或集成特定模块，我们可能选择在宿主机上独立运行Nginx作为Web服务器和反向代理，而非将其也容器化。本文将深入探讨如何配置宿主机上的Nginx，以实现对Docker容器内部PHP-FPM服务的高效代理。
核心工作原理
Nginx与PHP-FPM之间的通信基于FastCGI协议。当Nginx接收到对PHP文件的请求时，它会通过FastCGI协议将请求转发给PHP-FPM进程。PHP-FPM处理完请求后，将生成的动态内容返回给Nginx，Nginx再将最终的HTTP响应发送给客户端。在Docker环境中，核心挑战在于Nginx如何通过宿主机网络连接到运行在隔离容器内部的PHP-FPM服务。这通常通过Docker的端口映射机制来实现。
步骤一：准备PHP-FPM Docker容器
首先，需要确保PHP-FPM容器正确运行，并且其FastCGI端口（默认为9000）已映射到宿主机。
1. 启动PHP-FPM容器
立即学习“PHP免费学习笔记（深入）”；
以下示例使用Bitnami的php-fpm镜像，你也可以替换为其他PHP-FPM镜像或自定义镜像。关键在于通过-p参数将容器的9000端口映射到宿主机的9000端口。
docker run -d \ --name my-php-fpm-app \ -p 9000:9000 \ -v /path/on/host/to/your/php/app:/app \ bitnami/php-fpm:latest
- -d: 使容器在后台运行。
- --name my-php-fpm-app: 为容器指定一个易于识别的名称。
- -p 9000:9000: 这是核心配置，它将容器内部的9000端口（PHP-FPM监听的端口）映射到宿主机的9000端口。Nginx将通过此宿主机端口与PHP-FPM通信。
- -v /path/on/host/to/your/php/app:/app: 将宿主机上包含PHP应用程序代码的目录挂载到容器内部的/app目录。确保此宿主机路径与Nginx配置中的root指令保持一致。
2. 验证PHP-FPM服务状态
容器启动后，可以通过以下命令检查其运行状态：
启科网络商城系统由启科网络技术开发团队完全自主开发，使用国内最流行高效的PHP程序语言，并用小巧的MySql作为数据库服务器，并且使用Smarty引擎来分离网站程序与前端设计代码，让建立的网站可以自由制作个性化的页面。 系统使用标签作为数据调用格式，网站前台开发人员只要简单学习系统标签功能和使用方法，将标签设置在制作的HTML模板中进行对网站数据、内容、信息等的调用，即可建设出美观、个性的网站。
docker ps -a
若要进一步确认PHP-FPM服务是否可达，可以在宿主机上尝试连接映射的端口：
nc -vz 127.0.0.1 9000
如果连接成功（通常显示succeeded!），则表示PHP-FPM服务已在宿主机9000端口上可用。
步骤二：配置宿主机Nginx进行代理
接下来，在宿主机上的Nginx配置文件中添加一个server块，以定义如何代理对PHP应用程序的请求。
1. Nginx配置示例
在Nginx的配置目录（例如/etc/nginx/sites-available/或/etc/nginx/conf.d/）中创建一个新的配置文件，例如my_php_app.conf。
server {
listen 80; # Nginx监听HTTP请求的端口
server_name your_domain.com www.your_domain.com; # 你的域名，或使用localhost进行本地测试
root /path/on/host/to/your/php/app; # 宿主机上PHP代码的根目录，必须与Docker挂载的宿主机路径一致
index index.php index.html index.htm; # 默认索引文件
error_log /var/log/nginx/my_php_app.error.log; # 错误日志路径
access_log /var/log/nginx/my_php_app.access.log; # 访问日志路径
# 处理所有非PHP文件的请求，尝试直接提供文件，否则重写到index.php
location / {
try_files $uri $uri/ /index.php?$query_string;
}
# 处理所有以.php结尾的请求
location ~ \.php$ {
# 重要的安全措施：确保只有实际存在的PHP文件才会被发送到PHP-FPM处理
try_files $uri =404;
# 将FastCGI请求转发给PHP-FPM服务
# 使用宿主机的loopback地址和映射的端口
fastcgi_pass 127.0.0.1:9000;
# FastCGI参数配置
fastcgi_split_path_info ^(.+\.php)(/.+)$; # 分割PHP脚本路径和额外路径信息
include fastcgi_params; # 引入Nginx默认的FastCGI参数集
# 重新定义SCRIPT_FILENAME，确保PHP-FPM能正确找到并执行脚本
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param HTTPS off; # 根据实际情况设置HTTPS状态
# fastcgi_param PATH_INFO $fastcgi_path_info; # 如果应用程序需要PATH_INFO，可启用此行
}
# 阻止对隐藏文件和目录的访问
location ~ /\. {
deny all;
}
}配置详解：
- listen 80;: Nginx监听HTTP默认端口。
- server_name your_domain.com;: 定义此虚拟主机的域名。
- root /path/on/host/to/your/php/app;: 至关重要！ 此路径必须与你在docker run命令中挂载到PHP-FPM容器的宿主机路径完全一致。Nginx将在此目录中查找静态文件和PHP脚本。
- location / { ... }: 定义了如何处理非PHP文件的请求。try_files指令会尝试按顺序查找文件，如果找不到，则将请求内部重写到index.php，以便PHP应用程序处理路由。
- location ~ \.php$ { ... }: 这是处理所有以.php结尾的请求的核心块。
- try_files $uri =404;: 确保只有真实存在的PHP文件才会被发送到PHP-FPM，防止不必要的处理和潜在的安全问题。
- fastcgi_pass 127.0.0.1:9000;: 核心代理指令。它指示Nginx将FastCGI请求发送到宿主机上的9000端口。由于我们已将Docker容器的9000端口映射到宿主机的9000端口，Nginx就能通过此地址访问到PHP-FPM服务。
