Docker Compose部署多容器PHP应用教程

本文手把手教你如何使用Docker Compose在macOS环境下高效部署一个完整的多容器PHP应用栈——涵盖Nginx反向代理、PHP-FPM（基于php:8.2定制镜像并预装常用扩展）、MySQL 8.0（支持数据持久化与环境变量配置）以及Redis 7（可选RDB持久化），通过清晰的目录结构、自定义网络app-network和命名卷管理实现服务解耦与稳定通信，最后仅需一条docker compose up -d命令即可一键启动全栈服务，并快速验证本地访问与组件连通性，是PHP开发者迈向容器化生产部署的实用入门指南。

如果您正在构建一个基于PHP的多容器应用，并希望通过Docker Compose实现服务编排与快速部署，您需要配置多个相互协作的容器，如Web服务器、数据库和缓存服务。以下是完成该任务的具体步骤：

本文运行环境：MacBook Pro，macOS Sonoma

一、准备项目目录结构

合理的目录结构有助于分离关注点并提升可维护性。将应用程序代码、配置文件和服务定义分开放置。

1、在本地创建项目根目录，例如 my-php-app。

2、在根目录下建立 app 子目录用于存放PHP源码。

3、创建 nginx 目录存放Nginx配置文件，mysql 目录用于MySQL数据持久化。

4、在根目录创建 docker-compose.yml 文件以定义服务。

二、编写Docker Compose配置文件

Docker Compose使用YAML文件来定义多个容器服务及其依赖关系。通过此文件可以声明网络、卷和端口映射。

1、打开文本编辑器，创建 docker-compose.yml 文件。

2、定义四个服务：web（Nginx）、php（PHP-FPM）、db（MySQL）和 redis（缓存）。

3、为每个服务设置镜像名称、容器名称、端口暴露、卷挂载及启动顺序依赖。

4、确保所有服务连接到同一个自定义网络，以便内部通信。

三、配置PHP-FPM容器

PHP应用逻辑由PHP-FPM处理，需定制Docker镜像以安装必要扩展并复制代码。

1、在项目根目录创建 php/Dockerfile。

2、基于 php:8.2-fpm 镜像进行构建，安装常用扩展如pdo_mysql、gd、zip等。

3、使用COPY指令将本地 app/ 目录内容复制到容器内的 /var/www/html。

4、设置工作目录为 /var/www/html，并更改文件权限以避免运行错误。

四、配置Nginx服务器

Nginx作为反向代理接收HTTP请求，并将PHP请求转发给PHP-FPM容器处理。

1、在 nginx 目录中创建 nginx.conf 配置文件。

2、定义server块监听80端口，指定root目录为 /var/www/html。

3、配置location块将所有.php文件请求代理到 http://php:9000。

4、在docker-compose.yml中将本地nginx.conf挂载到容器的/etc/nginx/nginx.conf位置。

五、设置MySQL数据库服务

MySQL容器用于存储应用数据，需预设数据库名、用户和密码，并支持数据持久化。

1、在docker-compose.yml中为db服务选择官方 mysql:8.0 镜像。

2、通过environment字段设置 MYSQL_ROOT_PASSWORD、MYSQL_DATABASE 等变量。

3、将本地 ./mysql/data 挂载到容器的 /var/lib/mysql 实现数据持久化。

4、暴露容器3306端口到主机以便外部工具访问。

六、集成Redis缓存服务

Redis可用于会话存储或应用级缓存，提高响应速度并减轻数据库负载。

1、在docker-compose.yml中添加名为redis的服务，使用 redis:7-alpine 镜像。

2、无需额外配置即可运行，但建议启用持久化RDB快照功能。

3、在PHP代码中通过host为 redis、端口为6379连接实例。

4、可选地，在redis服务中挂载本地dump.rdb文件路径以实现数据保存。

七、定义共享网络与卷

确保各容器可通过自定义桥接网络相互通信，并使用命名卷管理持久化数据。

1、在docker-compose.yml的networks部分声明名为 app-network 的内部网络。

2、将所有服务加入该网络，设置driver为bridge模式。

3、在volumes部分定义 mysql_data 和 redis_data 命名卷。

4、在对应服务中引用这些卷，替代部分本地路径绑定以增强可移植性。

八、启动并验证多容器应用

完成所有配置后，使用Docker Compose命令启动整个栈并检查运行状态。

1、在终端进入项目根目录，执行 docker compose up -d 构建并后台运行所有服务。

2、使用 docker compose ps 查看各容器是否处于running状态。

3、访问 http://localhost 测试Nginx是否成功返回PHP页面。

4、进入PHP容器执行 php artisan tinker 或类似命令测试数据库和Redis连通性。

理论要掌握，实操不能落！以上关于《Docker Compose部署多容器PHP应用教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！