本文围绕 Docker Compose 配置 PHP 多服务环境详解与实战 的主题，介绍如何用 Docker Compose 搭建包含 PHP-FPM、Nginx、数据库等多服务的现代化 PHP 应用栈，并通过实战案例给出可直接落地的配置与调优要点。
通过本文，读者将理解 多服务化架构 的核心思路、如何设计易维护的目录结构、以及如何在实际生产中实现 高并发、低耦合、可扩展的部署。
1. Docker Compose 与 PHP 多服务架构的核心作用
1.1 为什么选择 Docker Compose 架构
在 PHP 多服务环境中，Docker Compose 可以以一份 yaml 配置文件就完整描述应用的服务、网络和数据卷，显著提升部署的一致性与可重复性。它让开发、测试和生产在同一范式下运行，减少环境引起的差异与问题。
通过 服务编排，可以将前端的 Nginx、后端的 PHP-FPM、数据存储的数据库以及缓存组件等拆分成独立的容器，避免模块之间的耦合，从而实现灵活的扩展与平滑替换。
1.2 组件与职责分工
典型的 PHP 多服务栈通常包含 Nginx 作为反向代理和静态资源服务器、PHP-FPM 处理 PHP 请求、MySQL/MariaDB 作为关系型数据库、以及如 Redis 的缓存/队列中间件等。使用 Docker Compose 可以将这些服务在同一个网络中协同工作，确保 低时延的前后端交互。
此外，容器化还带来 环境隔离与版本可控，确保不同阶段的应用在一致的依赖版本下运行，降低了环境带来的不可预期问题，提升了部署的稳健性。
2. 环境设计与目录结构
2.1 目录结构与约定
一个清晰的目录结构能够提升开发效率与运维效率，常见的约定包括 src / nginx.conf / php.ini / docker-compose.yml、以及用于数据持久化的 db_data 卷。通过将代码、配置和数据分离，可以实现更好的版本控制和回滚能力。
下面给出一个简化的目录示例以帮助理解：src 保存应用代码，nginx.conf 定义站点规则，php.ini 调整 PHP 行为，docker-compose.yml 描述服务编排，db_data 作为数据库数据卷。
.
├── docker-compose.yml
├── nginx.conf
├── php.ini
├── src
│ └── index.php
└── db_data (volume, 持久化数据库数据)
2.2 服务拆分与网络隔离
将应用拆分为独立的服务有助于按需扩展与独立升级，服务间通过内网网络通信，避免暴露不必要的端口。合理的网络划分还可以提升安全性，最小化暴露面。
在实际设计中，应通过 depends_on、aliases、 networks 等配置实现清晰的依赖关系和稳定的服务发现，确保在一个容器启动完成后再启动需要的后续服务，达到更高的可用性。
2.3 数据持久化与备份策略
数据库数据需要通过 命名卷（volumes）进行持久化，确保容器重建后数据依然可用；同时应规划定期备份与还原策略，如导出 SQL 快照或将数据备份到独立的存储。实践中，备份的自动化和测试恢复能力，是系统稳定性的关键之一。
在部署阶段，应明确 数据库初始化脚本、权限设置以及数据导入路径，以确保首次启动时能够正确初始化应用所需的数据库结构和基础数据，降低上线风险。
3. 实战案例：一个典型的 PHP 多服务环境
3.1 docker-compose.yaml 样例
下面给出一个简化但可落地的 docker-compose.yaml 样例，其中包含 PHP-FPM、Nginx、MariaDB 和 Redis 四个核心服务。通过此示例，您可以快速搭建一个本地开发或测试环境，并据此扩展为生产级别的部署。
version: "3.8"services:php-fpm:image: php:8.1-fpmcontainer_name: php-fpmvolumes:- ./src:/var/www/html- ./php.ini:/usr/local/etc/php/conf.d/custom.ininetworks:- appnetnginx:image: nginx:1.25container_name: nginxdepends_on:- php-fpmports:- "80:80"volumes:- ./src:/var/www/html- ./nginx.conf:/etc/nginx/conf.d/default.confnetworks:- appnetdb:image: mariadb:10.9container_name: mariadbenvironment:MYSQL_ROOT_PASSWORD: secretMYSQL_DATABASE: appdbMYSQL_USER: appuserMYSQL_PASSWORD: apppassvolumes:- db_data:/var/lib/mysqlnetworks:- appnetredis:image: redis:7-alpinecontainer_name: redisnetworks:- appnetvolumes:db_data:networks:appnet:
3.2 Nginx 与 PHP-FPM 的协作配置
要实现高效的 PHP 请求处理，Nginx 需要将 PHP 请求转发给 PHP-FPM，通常通过 fastcgi_pass 指定 PHP-FPM 容器的服务名及端口。确保静态资源直接由 Nginx 提供，动态请求交给 PHP-FPM 处理，以实现最佳性能。
server {listen 80;server_name localhost;root /var/www/html/public;index index.php index.html;location / {try_files $uri $uri/ /index.php?$query_string;}location ~ \\.php$ {try_files $uri =404;fastcgi_pass php-fpm:9000;fastcgi_index index.php;include fastcgi_params;fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;}location ~ /\\.ht {deny all;}
}
注意：在 Nginx 配置中通过 fastcgi_pass 指向 php-fpm:9000，其中 php-fpm 是 docker-compose.yml 中的服务名，端口 9000 是容器内的默认 FastCGI 端口。这样即可实现 Nginx 直接调用 PHP-FPM 引擎执行 PHP 代码。
3.3 数据库初始化与迁移
为了让数据库在首次启动时拥有基本结构，可以添加初始化脚本，将常用账户和数据库结构在容器启动时执行。以下示例展示一个简单的初始化 SQL，用于创建基础用户、数据库以及权限。
-- 初始化数据库
CREATE USER 'appuser'@'%' IDENTIFIED BY 'apppass';
CREATE DATABASE IF NOT EXISTS appdb;
GRANT ALL PRIVILEGES ON appdb.* TO 'appuser'@'%';
FLUSH PRIVILEGES;
实践要点：将初始化脚本放置在容器内的特定目录，并在 docker-compose 的 db 服务中通过 volumes 将脚本挂载到 /docker-entrypoint-initdb.d，从而在容器首次启动时自动执行。
3.4 运行、调试与性能优化要点
启动时只需执行 docker-compose up -d，即可在后台启动所有服务。调试阶段，可以通过 docker-compose logs -f 实时查看日志，定位启动或运行时的问题。
# 启动多服务栈
docker-compose up -d# 查看日志
docker-compose logs -f# 进入 PHP-FPM 容器进行调试
docker exec -it php-fpm bash
性能优化方面，OpCache 的开启与配置、数据库连接池和慢查询日志的启用、以及静态资源的缓存策略等，都是提升 PHP 多服务环境性能的关键点。此外，合理设置 Nginx 的 worker_processes、worker_connections、以及 PHP-FPM 的 pm.max_children，可以在高并发场景下避免资源争抢与瓶颈。
