1. 环境准备与目标设定
1.1 环境前提与版本选择
本教程围绕 Docker 搭建 PHP-FPM 动态服务的完整流程展开，目标是实现一个可扩展、可维护的动态请求处理架构。通过容器化，后续可以在更高效的集群中进行水平扩展，并将前端代理与应用后端解耦。关键点包括明确需求、确定版本、以及建立一致的开发与生产环境。
核心依赖包括 Docker 引擎、Docker Compose、Nginx 作为前端代理，以及 PHP-FPM 作为应用服务器。确保主机具备网络访问、持久化存储能力，以及基本的安全基线。版本选择方面，推荐使用官方稳定镜像系列与最新的 PHP-FPM 长期支持版本，以获得安全与性能更新。
docker --version
docker compose version
php-fpm --version
2. 架构原理与工作流程
2.1 PHP-FPM 与 Nginx 的协作模型
在该 Docker 架构中，Nginx 作为前端反向代理，负责接收外部请求并将 PHP 请求转发给 PHP-FPM，后者则作为工作进程池（pool）处理实际的 PHP 逻辑。通过 动态进程管理，PHP-FPM 可以根据并发压力自动调整工作进程数量，从而实现高并发场景下的稳定性与资源利用率。
通过将应用代码、PHP-FPM、以及 Nginx 放在独立的容器中，可以实现零停机部署、独立扩缩容和便捷的版本回滚。同时，前端代理可以统一接入 TLS、缓存策略和速率限制，减轻后端压力。
server {listen 80;server_name example.local;location / {proxy_pass http://app:9000;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;}
}3. 基础镜像与 Dockerfile 编写
3.1 官方镜像选型与基础配置
本节选用官方 php 系列镜像中的 php:8.x-fpm-alpine 作为基础，以获得较小体积和良好性能。随后安装数据库驱动、常用拓展，以及 OpCache 支持。关键点在于保持镜像尽量精简、并在构建阶段完成大部分依赖。
推荐做法：尽量使用多阶段构建、分离应用与运行时依赖，以及固定版本标签以提升可重复性。
# Dockerfile 示例
FROM php:8.3-fpm-alpine AS base# 安装常用扩展与依赖
RUN apk add --no-cache libxml2-dev icu-dev zlib-dev libpng-dev \&& docker-php-ext-install pdo pdo_mysql mysqli intl mbstring xml gd# 启用并配置 OpCache（在运行时可覆盖环境变量）
COPY php.ini /usr/local/etc/php/php.ini# 设置工作目录
WORKDIR /var/www/html# 将应用代码拷贝到镜像中
COPY src/ /var/www/html/# 启动命令由宿主容器运行时（Docker Compose）指定
4. 使用 Docker Compose 部署
4.1 docker-compose.yml 示例
通过 Docker Compose 将 Nginx、PHP-FPM、以及应用服务进行编排，便于实现跨容器通信、资源限制以及环境变量传递。以下示例展示了一个典型的部署结构，其中 app 服务运行 PHP-FPM，nginx 服务作为前端代理。
version: '3.8'
services:app:build: .volumes:- ./src:/var/www/htmlexpose:- "9000"environment:- PHP_OPCACHE_ENABLE=1- PHP_MEMORY_LIMIT=256Mdepends_on:- dbnginx:image: nginx:1.23-alpineports:- "8080:80"volumes:- ./nginx.conf:/etc/nginx/nginx.conf:ro- ./src:/var/www/htmldepends_on:- app
5. 动态配置与负载均衡
5.1 PHP-FPM 池的动态配置
为了实现动态服务的高效响应，需要对 PHP-FPM 的进程池进行合理配置。pm = dynamic 模式允许进程按需创建，pm.max_children、pm.start_servers、pm.min_spare_servers、pm.max_spare_servers 等参数决定了并发能力和初始启动负载。
示例配置用于 /usr/local/etc/php-fpm.d/www.conf，确保容器内可挂载或覆盖该配置。
[www]
pm = dynamic
pm.max_children = 60
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 15
6. 性能优化策略
6.1 OpCache 与资源优化
性能优化的核心在于提升 PHP 的执行效率与 I/O 等待的并行度。开启 OpCache、减少重复编译、合理分配内存，是提升动态服务性能的基础。通过在 php.ini 中开启 OpCache 并禁用时间戳校验，可以显著降低热启动后的第一次请求延迟。
典型 OpCache 配置如下所示，建议在生产镜像中固定为常用设置，并通过环境变量灵活覆盖。
opcache.enable=1
opcache.validate_timestamps=0
opcache.memory_consumption=128
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=10000
opcache.revalidate_freq=0
此外，Nginx.fastcgi_read_timeout 与缓存策略也对性能有显著影响。通过缓存静态资源、合理的缓存头以及较短的请求转发链路，可以提升整体吞吐。
location ~ \.php$ {fastcgi_pass app:9000;fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;include fastcgi_params;fastcgi_read_timeout 300;
}
7. 安全性加固
7.1 镜像与容器安全实践
在 Docker 化部署中，安全性是长期要点。优选官方镜像、固定版本、最小化层数与依赖，并通过只需要最小权限的容器运行时账户来减少潜在风险。
另外，镜像扫描与最小化权限策略有助于降低漏洞暴露面。定期对镜像进行安全审计、禁用不必要的服务、以及对敏感配置实行环境变量保护，是良好实践。
# 示例：使用固定版本镜像并开启非 root 用户
FROM php:8.3-fpm-alpine
RUN adduser -D appuser
USER appuser
7.2 网络与证书安全
网络层面的保护要点在于将暴露端口控制在最小范围，并通过 TLS 保护对外通信。常用策略包括在 Nginx 层面强制 TLS、配置证书轮换、以及使用仅限必要域名的信任证书。
server {listen 443 ssl;server_name example.com;ssl_certificate /etc/ssl/certs/fullchain.pem;ssl_certificate_key /etc/ssl/private/privkey.pem;ssl_protocols TLSv1.2 TLSv1.3;ssl_ciphers HIGH:!aNULL:!MD5;location / {proxy_pass http://app:9000;}
}
