Docker PHP开发环境搭建实战指南

Docker PHP开发环境搭建实战指南

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

前言

在PHP项目开发过程中，使用Docker容器化技术可以极大地简化开发环境的搭建和维护。本文将详细介绍如何基于Docker构建一个完整的PHP开发环境，包含数据库集成、数据持久化、开发依赖管理等关键环节。

环境准备

在开始之前，请确保已完成以下准备工作：

1. 已安装Docker及Docker Compose
2. 已完成PHP应用的基础容器化（参考容器化PHP应用指南）

开发环境架构设计

我们将构建的开发环境包含以下组件：

• PHP应用容器（基于Apache）
• MariaDB数据库容器
• phpMyAdmin数据库管理工具
• 数据持久化卷
• 开发专用容器（包含测试依赖）

数据库集成与数据持久化

1. 安装PHP数据库扩展

首先需要修改Dockerfile，添加对MySQL/MariaDB的支持：

FROM php:8.2-apache as final
RUN docker-php-ext-install pdo pdo_mysql  # 关键扩展安装
RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"

docker-php-ext-install是PHP官方Docker镜像提供的便捷扩展安装命令。

2. 配置数据库服务

更新compose.yaml文件，添加MariaDB服务和数据卷：

services:
  db:
    image: mariadb
    volumes:
      - db-data:/var/lib/mysql  # 数据持久化卷
    environment:
      - MARIADB_ROOT_PASSWORD_FILE=/run/secrets/db-password
      - MARIADB_DATABASE=example
volumes:
  db-data:
secrets:
  db-password:
    file: db/password.txt

关键配置说明：

• 使用volumes确保数据库数据持久化
• 通过secrets安全管理数据库密码
• 配置健康检查确保服务依赖顺序

开发效率优化

1. 添加phpMyAdmin

在compose.yaml中添加phpMyAdmin服务：

services:
  phpmyadmin:
    image: phpmyadmin
    ports:
      - 8080:80
    environment:
      - PMA_HOST=db  # 连接到db服务

通过8080端口即可访问数据库管理界面。

2. 代码热更新配置

使用Compose Watch实现代码变更自动同步：

services:
  server:
    develop:
      watch:
        - action: sync
          path: ./src
          target: /var/www/html

启动命令：

docker compose watch

任何对src目录的修改都会自动同步到容器中。

开发环境容器构建

采用多阶段构建策略，分离开发和生产环境：

# 生产依赖安装阶段
FROM composer:lts as prod-deps
RUN composer install --no-dev

# 开发依赖安装阶段  
FROM composer:lts as dev-deps
RUN composer install

# 基础镜像阶段
FROM php:8.2-apache as base
RUN docker-php-ext-install pdo pdo_mysql

# 开发环境阶段
FROM base as development
COPY --from=dev-deps app/vendor/ /var/www/html/vendor
COPY ./tests /var/www/html/tests

在compose.yaml中指定构建目标：

services:
  server:
    build:
      target: development

验证与测试

1. 数据持久化验证：

docker compose rm
docker compose up

刷新页面验证计数器是否保持状态。

2. 开发工具验证：

• 访问http://localhost:8080 检查phpMyAdmin
• 修改代码验证热更新

最佳实践建议

1. 安全建议：

• 永远不要在代码中硬编码密码
• 使用secrets管理敏感信息
• 开发环境使用单独的数据库凭证

2. 性能优化：

• 合理配置Compose Watch的同步规则
• 对vendor目录使用缓存卷
• 开发环境禁用OPcache

3. 调试技巧：

• 开发容器保留shell访问权限
• 配置Xdebug进行远程调试
• 使用docker compose logs查看实时日志

总结

通过本文的配置，我们建立了一个完整的PHP开发环境，具有以下特点：

• 完整的服务栈（应用+数据库+管理工具）
• 代码修改实时生效
• 数据安全持久化
• 开发生产环境隔离
• 便捷的数据库管理界面

这种容器化的开发环境可以确保团队成员使用完全一致的配置，避免"在我机器上能运行"的问题，显著提高开发效率。

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs