Docker Compose搭建PHP环境多服务配置教程

Docker Compose通过YAML文件定义PHP开发环境中的Nginx、PHP-FPM、MySQL、Redis等服务，解决环境一致性、隔离性及配置复杂性问题。1. 它提供声明式配置，确保多服务协同时的可复现性；2. 通过卷挂载实现代码实时更新与数据持久化；3. 支持服务依赖管理，自动处理启动顺序；4. 简化环境搭建流程，提升团队协作效率；5. 提供基础重启策略增强容错能力。这些特性使PHP开发更高效、稳定，并为生产环境部署打下基础。

使用Docker Compose构建PHP环境，核心在于通过一个简单的YAML文件定义并启动PHP应用所需的所有服务，例如Nginx、PHP-FPM、MySQL和Redis等，极大地简化了开发环境的搭建与管理，尤其是在处理多服务协同工作时，它提供了一种声明式、可复现的解决方案。

解决方案

要构建一个典型的PHP多服务环境，我们通常会用到Nginx作为Web服务器，PHP-FPM处理PHP脚本，以及MySQL或PostgreSQL作为数据库，可能还会加上Redis或Memcached作为缓存服务。以下是一个常见的docker-compose.yml配置示例，它涵盖了这些核心组件：

version: '3.8'

services:
  nginx:
    image: nginx:stable-alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d:ro # Nginx配置
      - ./src:/var/www/html:ro # 应用代码
    depends_on:
      - php-fpm
    networks:
      - app-network

  php-fpm:
    build:
      context: .
      dockerfile: Dockerfile.php
    volumes:
      - ./src:/var/www/html:rw # 应用代码，可读写
      - ./php/php.ini:/usr/local/etc/php/php.ini # PHP配置
    expose:
      - "9000"
    depends_on:
      - mysql
      - redis
    networks:
      - app-network

  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root_password
      MYSQL_DATABASE: my_database
      MYSQL_USER: my_user
      MYSQL_PASSWORD: my_password
    volumes:
      - db_data:/var/lib/mysql # 数据库数据持久化
    ports:
      - "3306:3306" # 仅供本地调试，生产环境不建议暴露
    networks:
      - app-network

  redis:
    image: redis:alpine
    ports:
      - "6379:6379" # 仅供本地调试
    volumes:
      - redis_data:/data # Redis数据持久化
    networks:
      - app-network

networks:
  app-network:
    driver: bridge

volumes:
  db_data:
  redis_data:

同时，为了php-fpm服务，你可能需要一个自定义的Dockerfile.php文件，比如：

# Dockerfile.php
FROM php:8.2-fpm-alpine

# 安装常用扩展
RUN apk add --no-cache \
    libzip-dev \
    libpng-dev \
    jpeg-dev \
    freetype-dev \
    icu-dev \
    libpq \
    git \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) pdo_mysql pdo_pgsql opcache gd zip bcmath intl

# 安装Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

WORKDIR /var/www/html

以及Nginx的配置nginx/conf.d/default.conf：

# nginx/conf.d/default.conf
server {
    listen 80;
    index index.php index.html;
    root /var/www/html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass php-fpm:9000;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }

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

将这些文件放置在你的项目根目录，并在src目录下放置你的PHP应用代码。然后，在项目根目录执行 docker-compose up -d 即可启动整个环境。

Docker Compose在PHP开发中究竟能解决哪些痛点？

说实话，第一次接触Docker Compose的时候，我真是觉得找到了救星。以前搭建PHP开发环境，那简直是噩梦。不同的项目可能需要不同的PHP版本，不同的扩展，甚至不同的数据库版本。我的机器上跑着PHP 7.4的项目，新接一个项目需要PHP 8.1，怎么办？要么装一堆PHP版本管理器，要么就得小心翼翼地切换，一个不小心就冲突了。这种“我的机器能跑，你机器不能跑”的问题，在团队协作中更是家常便饭。

Docker Compose最直接的痛点解决能力，就是环境的“一致性”和“隔离性”。它把所有服务及其依赖都打包在容器里，每个人、每台机器跑起来都是同一个环境。这就像是给每个项目都配了一个独立的、定制化的迷你操作系统，里面只装了它需要的东西，互不干扰。我再也不用担心PHP扩展没装对，或者MySQL版本不对导致的问题了。

再一个就是“简化配置”和“快速启动”。以前装个Nginx、PHP、MySQL，得一步步来，配路径，改端口，设权限，每一步都可能出错。现在，一个docker-compose.yml文件，几行配置，docker-compose up一敲，整个环境就起来了。对于新成员加入团队，或者我需要快速切换项目时，这简直是效率飞升。它还帮我们处理了服务间的依赖关系，比如PHP-FPM必须等MySQL起来才能正常工作，Compose能帮你管理这些启动顺序。这不只是方便，更是把那些重复、易错的体力活自动化了。

如何优化Docker Compose配置以提升PHP应用性能与开发效率？

优化Docker Compose配置，我觉得最关键的在于权衡“开发便利性”和“模拟生产环境”。毕竟开发环境和生产环境的需求点不一样。

首先，卷（Volumes）的使用是提升开发效率的重中之重。在开发阶段，我们肯定希望代码改动能立即生效，所以通常会使用bind mount（绑定挂载），把宿主机的代码目录直接挂载到容器里，比如示例中的./src:/var/www/html。这样你本地修改代码，容器里立马就更新了，非常方便。但要注意，在macOS或Windows上，大项目或者文件I/O频繁时，绑定挂载可能会有性能瓶颈，这是Docker Desktop的底层实现决定的。对于数据库数据、Redis数据这些需要持久化的，我们应该用named volumes（命名卷），比如db_data:/var/lib/mysql。命名卷由Docker管理，性能更好，而且数据不会因为容器删除而丢失。

其次，PHP-FPM的配置也很重要。开发时，你可能需要开启Xdebug进行调试。在Dockerfile.php里安装Xdebug扩展，然后在php.ini里配置好Xdebug的远程调试参数，比如xdebug.mode=debug和xdebug.client_host=host.docker.internal（这是Docker Desktop里指向宿主机的特殊域名，Linux下可能需要配置为宿主机IP）。调试效率高了，开发效率自然就上去了。同时，opcache在开发环境也建议开启，它可以缓存PHP编译后的字节码，显著提升PHP脚本执行速度，虽然开发阶段代码变动频繁会影响缓存命中率，但对于稳定运行的部分还是有益的。

另外，网络（Networks）的合理规划也能提升效率和清晰度。虽然默认的bridge网络对大多数情况够用，但如果你有多个应用或服务组，创建自定义网络能让服务间的通信更清晰，也避免了端口冲突。比如我在示例中用了app-network，这样Nginx和PHP-FPM之间就可以直接通过服务名php-fpm来通信，而不是IP地址，这更具可读性。

最后，别忘了资源限制。虽然Docker Compose主要用于开发，但如果你发现某个服务特别吃资源（比如MySQL），可以在docker-compose.yml中为服务设置mem_limit或cpus，这有助于避免某个服务占用过多宿主机资源，影响整体开发体验。当然，这更多是为模拟生产环境或资源受限的开发机考虑。

多服务协同下，Docker Compose如何保障PHP应用的数据持久性与高可用？

谈到数据持久性，这在任何应用中都是核心。Docker Compose在这方面做得相当不错，主要就是通过命名卷（Named Volumes）来实现的。你看到示例中的db_data和redis_data就是命名卷。它们是Docker管理的数据存储区域，独立于容器的生命周期。即使你删除了MySQL或Redis容器，只要命名卷不被手动删除，数据依然会保留下来。这意味着你的数据库内容、Redis缓存数据等关键信息不会因为容器的重建、更新而丢失。我个人觉得，对于数据库这种核心数据，使用命名卷是必须的，否则你每次启动环境都得重新初始化数据库，那简直是灾难。

至于高可用性（High Availability, HA），这里得明确一点：Docker Compose本身并不是一个生产级的高可用解决方案。它主要用于单主机上的多容器编排，是开发和测试环境的利器。它的“高可用”能力，更多体现在服务重启策略上。比如，你可以在服务配置中加入restart: always，这样如果容器因为某种原因崩溃了，Docker会自动尝试重启它。这确实能在一定程度上提供基础的容错能力，避免服务意外停止导致整个应用不可用。

但是，真正的生产环境高可用，通常意味着需要跨多台主机进行负载均衡、故障转移和自动伸缩。Docker Compose无法直接提供这些能力。如果你需要部署一个高可用的PHP应用集群，你可能需要考虑更高级的容器编排工具，比如Docker Swarm或者Kubernetes。它们能让你在多台服务器上运行容器，并提供自动服务发现、负载均衡、滚动更新、故障自动恢复等功能。

尽管如此，Docker Compose为构建高可用系统打下了基础。通过定义清晰的服务、网络和卷，你实际上是在为未来迁移到更复杂的生产环境做准备。你可以在Compose文件中定义健康检查（healthcheck），确保服务真正“准备好了”才对外提供服务，这对于多服务协同来说非常重要，可以避免某个服务还没完全启动，依赖它的服务就尝试连接导致错误。例如，可以为MySQL服务添加一个健康检查，确保它能接受连接后，PHP-FPM才开始启动。这种细致的配置，虽然不能直接提供跨主机的HA，但能让单机环境下的服务协同更加健壮。