Docker Compose部署PHP/MySQL多容器应用连接失败及Azure适配咨询

本地环境无法连接MySQL的核心配置缺失 #

按照当前配置启动后出现PDO连接报错，本质是三个配置缺口共同导致的：

• PHP运行环境缺失MySQL连接依赖：默认php:7.2-apache基础镜像没有预装pdo_mysql扩展，而RedBeanPHP的数据库连接逻辑完全依赖该扩展完成PDO协议通信。当前webapp目录下的Dockerfile仅做了代码拷贝操作，没有补充扩展安装步骤，就算MySQL容器完全正常运行，PHP侧也发起不了合法的数据库连接请求。
• 缺少数据库服务就绪状态校验：当前配置里的depends_on仅能控制容器的启动先后顺序，不会等待MySQL服务完成初始化、3306端口监听、数据库与账号创建的全流程。MySQL 5.7镜像首次启动时需要数秒到数十秒的初始化周期，这段时间内PHP服务发起的连接请求会被直接拒绝，即便后续MySQL状态完全正常，首次访问触发的连接也会报错。
• 业务依赖文件缺失风险：index.php中通过require 'rb.php'引入RedBeanPHP核心类文件，但当前公开的项目目录结构中未包含该文件，若运行时文件加载逻辑异常，也可能间接抛出数据库连接类的误导性错误。

本地环境修正参考 #

针对以上问题，可直接调整配置完成修复：

1. 替换webapp目录下的Dockerfile，补充pdo_mysql扩展安装步骤：

   FROM php:7.2-apache
   RUN docker-php-ext-install pdo_mysql
   COPY . /var/www/html/
   EXPOSE 80
   

2. 为db服务补充健康检查配置，确保MySQL完全就绪后再启动PHP服务，替代仅靠启动顺序判断的依赖配置。
3. 确认webapp目录下存在rb.php核心类文件，保证业务代码完整。
4. 调整php服务的镜像命名规则，避免本地构建的镜像被覆盖为官方镜像标签，造成配置混淆。

适配Azure App Service多容器部署的必要调整 #

如果要将该应用直接部署到Azure平台，当前配置需要做以下调整才能正常运行：

• 移除本地开发专属的端口映射：Azure App Service的多容器运行环境会自动将容器80端口绑定到公网访问入口，不需要在docker-compose.yml中手动配置80:80、3306:3306这类宿主机端口绑定规则，这类配置在Azure环境下会触发端口冲突，导致容器启动失败。
• 删除宿主机路径的bind挂载配置：Azure Linux容器环境不支持将宿主机本地路径挂载到容器内的配置（也就是当前./webapp:/var/www/html/这类代码挂载规则），这类配置在Azure运行时会直接失效，甚至阻断容器启动。需要将业务代码直接通过Dockerfile打包到镜像层，不要依赖本地挂载同步代码。
• 调整MySQL存储方案：当前配置使用的本地命名卷db_data仅适合本地开发场景，在Azure环境下使用容器内置的MySQL实例会存在容器重启后数据丢失的风险，更适合直接替换为Azure托管MySQL服务，通过环境变量传递数据库连接信息，相比容器化MySQL的稳定性更高、运维成本更低。
• 移除硬编码的敏感配置：不要在docker-compose.yml中硬编码数据库密码、root账号密码这类敏感信息，改为从Azure App Service的应用配置项读取对应环境变量，避免敏感信息随代码或配置文件泄露到代码仓库。
• 校验Compose配置兼容性：Azure App Service对Docker Compose的语法版本和支持的配置项有明确的范围限制，需要调整compose的版本声明和配置语法，确保所有用到的配置项都在平台兼容列表内。

内容的提问来源于stack exchange，提问作者Suisse