Nginx在宿主机代理Docker容器内PHP-FPM程序的实践指南-php教程-PHP中文网

Nginx在宿主机代理Docker容器内PHP-FPM程序的实践指南

本教程详细阐述了如何在宿主机上运行的Nginx服务代理Docker容器内的PHP-FPM程序。文章涵盖了两种主要场景：在Kubernetes环境下通过Nginx Ingress Controller进行代理，以及在宿主机上使用独立的Nginx实例直接代理。内容包括详细的配置示例、关键参数解释以及实现网络连通性的注意事项，旨在帮助读者构建稳定高效的Web服务架构。

引言

在现代web开发中，docker容器化技术已成为部署应用的主流方式。php-fpm作为php应用的进程管理器，通常运行在独立的容器中。而nginx作为高性能的web服务器和反向代理，可能选择运行在宿主机上，或者作为kubernetes集群中的ingress控制器。本文旨在提供一份全面的指南，详细说明如何在nginx运行于docker外部时，有效代理docker容器内部的php-fpm程序，确保请求能够正确路由和处理。

场景一：Kubernetes环境下的Nginx Ingress代理PHP-FPM

在Kubernetes集群中，Nginx Ingress Controller是实现外部流量路由到集群内部服务的常用组件。通过配置Ingress资源，我们可以指示Nginx Ingress将HTTP请求转发给PHP-FPM服务。

1. 定义PHP-FPM Pod

首先，我们需要一个运行PHP-FPM应用的Pod。这个Pod会暴露一个端口（通常是9000）供FastCGI通信。

apiVersion: v1
kind: Pod
metadata:
  name: example-app
  labels:
    app: example-app
spec:
  containers:
  - name: example-app
    image: example-app:1.0 # 替换为你的PHP-FPM镜像
    ports:
    - containerPort: 9000
      name: fastcgi # 定义一个端口名称，方便Service引用

登录后复制

在这个Pod定义中，example-app:1.0是你包含PHP-FPM程序的Docker镜像。containerPort: 9000指定了PHP-FPM监听的端口。

2. 定义Service

为了让Nginx Ingress能够稳定地访问到Pod，我们需要创建一个Service来抽象Pod的网络访问。

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

apiVersion: v1
kind: Service
metadata:
  name: example-service
spec:
  selector:
    app: example-app # 匹配Pod的label
  ports:
  - port: 9000 # Service暴露的端口
    targetPort: 9000 # Pod监听的端口
    name: fastcgi # 引用Pod中定义的端口名称

登录后复制

Service通过selector匹配具有app: example-app标签的Pod，并将9000端口的流量转发到这些Pod的9000端口。

3. 定义ConfigMap (可选，用于FastCGI参数)

Nginx Ingress Controller允许通过ConfigMap来配置FastCGI参数，例如SCRIPT_FILENAME。这有助于统一管理和维护。

apiVersion: v1
kind: ConfigMap
metadata:
  name: example-cm
data:
  SCRIPT_FILENAME: "/example/index.php" # 根据你的应用路径调整

登录后复制

此ConfigMap定义了一个名为SCRIPT_FILENAME的参数，其值是/example/index.php。在实际应用中，你可能需要根据你的PHP应用入口文件路径进行调整。

4. 定义Ingress

最后，我们创建Ingress资源来配置Nginx Ingress Controller，使其将特定域名的请求代理到PHP-FPM服务。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    kubernetes.io/ingress.class: "nginx" # 指定使用Nginx Ingress Controller
    nginx.ingress.kubernetes.io/backend-protocol: "FCGI" # 告知Nginx后端是FastCGI协议
    nginx.ingress.kubernetes.io/fastcgi-index: "index.php" # FastCGI的默认索引文件
    nginx.ingress.kubernetes.io/fastcgi-params-configmap: "example-cm" # 引用ConfigMap
  name: example-app
spec:
  rules:
  - host: app.example.com # 你的域名
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: example-service
            port:
              name: fastcgi # 引用Service中定义的端口名称

登录后复制

关键注解解释：

nginx.ingress.kubernetes.io/backend-protocol: "FCGI"：这是最重要的注解，它告诉Nginx Ingress将请求以FastCGI协议转发到后端服务。
nginx.ingress.kubernetes.io/fastcgi-index: "index.php"：指定FastCGI处理的默认索引文件。
nginx.ingress.kubernetes.io/fastcgi-params-configmap: "example-cm"：引用了我们之前定义的ConfigMap，用于传递FastCGI参数。

通过以上配置，当访问app.example.com时，Nginx Ingress Controller会将请求代理到example-service，并以FastCGI协议与PHP-FPM容器进行通信。

Giiso写作机器人

Giiso写作机器人，让写作更简单

查看详情

场景二：宿主机Nginx直接代理Docker容器内PHP-FPM

如果Nginx运行在宿主机上，而非Kubernetes集群中，我们可以通过配置Nginx服务器块来直接代理Docker容器内的PHP-FPM。

1. Docker容器的网络配置

为了让宿主机上的Nginx能够访问到Docker容器内的PHP-FPM，你需要确保PHP-FPM容器的端口已正确暴露并可从宿主机访问。最常见的方式是在运行Docker容器时将容器端口映射到宿主机的某个端口。

例如，运行PHP-FPM容器时：

docker run -d --name php-fpm-app -p 9000:9000 bitnami/php-fpm:latest # 示例镜像

登录后复制

这会将容器内部的9000端口映射到宿主机的9000端口。此时，宿主机上的Nginx可以通过127.0.0.1:9000或宿主机的IP地址:<宿主机端口>来访问PHP-FPM。

注意事项：

如果你的Docker环境是Docker Desktop (macOS/Windows)，并且Nginx运行在宿主机上，可以使用host.docker.internal:9000来访问容器。
如果Docker容器运行在自定义网络中，并且Nginx也需要访问该网络，可能需要更复杂的网络配置，或者将Nginx也放入同一Docker网络。最简单的方式是直接进行端口映射。
在Linux宿主机上，如果Docker容器没有显式发布端口，但Nginx和Docker容器都在同一宿主机上，Nginx可以通过Docker bridge网络的IP地址（如172.17.0.x）直接访问容器，但这需要Nginx能够解析或知道该IP。通常建议使用端口映射。

2. Nginx服务器块配置

以下是一个Nginx服务器块的配置示例，用于代理PHP-FPM。

server {
    listen  80; # Nginx监听的端口

    server_name localhost; # 你的域名或IP
    root /var/www/test; # Nginx的文档根目录，应与PHP-FPM容器内的应用路径匹配

    error_log /var/log/nginx/localhost.error.log;
    access_log /var/log/nginx/localhost.access.log;

    location / {
        # 尝试直接服务文件，如果不存在则回退到index.php
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ ^/.+\.php(/|$) {
        # FastCGI代理到PHP-FPM
        # 这里的IP地址和端口需要替换为PHP-FPM容器可访问的地址和端口
        # 如果端口映射到宿主机，通常是 127.0.0.1:9000
        fastcgi_pass 127.0.0.1:9000; # 示例：192.168.59.103:9000 或 host.docker.internal:9000

        fastcgi_split_path_info ^(.+\.php)(/.*)$; # 分割PHP脚本路径和额外路径信息
        include fastcgi_params; # 包含Nginx默认的FastCGI参数

        # 设置SCRIPT_FILENAME参数，告知PHP-FPM要执行的脚本路径
        # $document_root 对应 Nginx 的 root 指令，与 PHP-FPM 容器内的应用根目录保持一致
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param HTTPS off; # 根据实际情况设置，如果Nginx接收HTTPS请求，这里应为 on
    }
}

登录后复制

配置详解：

fastcgi_pass 127.0.0.1:9000;：这是核心指令，它指示Nginx将FastCGI请求转发到指定的IP地址和端口。你需要将127.0.0.1:9000替换为你的PHP-FPM容器实际可访问的地址和端口。如果通过docker run -p 9000:9000映射到宿主机，那么127.0.0.1:9000通常是正确的。
root /var/www/test;：Nginx的文档根目录。重要提示： 这个路径应该与PHP-FPM容器内部的Web应用根目录相匹配。例如，如果你的PHP文件在容器的/app目录下，并且你希望通过Nginx的/路径访问，那么Nginx的root指令也应该指向/app（如果Nginx和PHP-FPM共享同一个文件系统，或者Nginx通过某种方式访问到容器内的文件系统，这通常不是直接的，而是通过SCRIPT_FILENAME参数来传递）。更常见的情况是，root指令定义Nginx提供静态文件的路径，而SCRIPT_FILENAME则负责告诉PHP-FPM脚本的实际位置。
fastcgi_split_path_info ^(.+\.php)(/.*)$;：这个正则表达式用于将请求URI分割成PHP脚本路径（$fastcgi_script_name）和额外的路径信息（$fastcgi_path_info），这对于处理像example.com/index.php/some/path这样的请求非常有用。
include fastcgi_params;：引入Nginx自带的FastCGI参数配置，包含了许多必要的环境变量。
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;：这是一个非常关键的参数。它告诉PHP-FPM要执行的PHP脚本的完整路径。$document_root是Nginx配置中root指令的值，$fastcgi_script_name是fastcgi_split_path_info解析出的PHP脚本名。确保这个组合路径在PHP-FPM容器内部是有效的。

总结与注意事项

无论选择哪种方式，成功代理Docker容器内的PHP-FPM程序都离不开以下几个关键点：

网络连通性： 确保Nginx能够通过正确的IP地址和端口访问到PHP-FPM容器。在宿主机Nginx场景中，端口映射是最直接有效的方式。
FastCGI协议： Nginx与PHP-FPM之间通过FastCGI协议通信。正确配置fastcgi_pass（或Kubernetes Ingress的backend-protocol: FCGI）至关重要。
路径匹配： root指令（Nginx）和SCRIPT_FILENAME参数需要与PHP-FPM容器内部的实际文件路径结构相匹配，以确保PHP-FPM能找到并执行正确的脚本。
错误排查： 仔细检查Nginx和PHP-FPM的日志文件（如Nginx的error_log和PHP-FPM的access.log/error.log），它们是诊断问题的关键信息来源。
安全性： 在生产环境中，应考虑Nginx的HTTPS配置、防火墙规则以及Docker容器的最小权限原则。