首先创建项目目录结构,包括app、nginx、mysql等子目录,并编写docker-compose.yml文件定义web、php、db和redis四个服务。接着在php目录下编写Dockerfile,基于php:8.2-fpm安装必要扩展并复制代码至容器。然后配置nginx.conf,设置server块监听80端口并将.php请求转发至php:9000。在docker-compose.yml中为db服务使用mysql:8.0镜像,设置环境变量并挂载本地数据目录实现持久化。添加redis服务使用redis:7-alpine镜像,可选挂载dump.rdb实现数据保存。定义自定义网络app-network供所有服务通信,并使用命名卷管理mysql和redis的数据。最后执行docker compose up -d启动服务,通过docker compose ps检查状态,访问localhost验证应用运行正常。

如果您正在构建一个基于PHP的多容器应用,并希望通过Docker Compose实现服务编排与快速部署,您需要配置多个相互协作的容器,如Web服务器、数据库和缓存服务。以下是完成该任务的具体步骤:
本文运行环境:MacBook Pro,macos Sonoma
一、准备项目目录结构
合理的目录结构有助于分离关注点并提升可维护性。将应用程序代码、配置文件和服务定义分开放置。
立即学习“PHP免费学习笔记(深入)”;
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连通性。


