Docker搭建PHP环境教程详解

还在为搭建PHP测试环境烦恼吗？本文为你提供一套高效、便捷的解决方案：利用Docker Compose快速构建PHP测试环境。通过创建`docker-compose.yml`文件，定义包括PHP-FPM、Nginx、MySQL在内的服务及依赖关系，轻松配置Nginx处理PHP请求，并编写`Dockerfile.php`定制PHP环境，灵活支持不同版本和扩展。只需简单的`docker-compose`命令，即可快速启动、销毁环境，结合数据卷实现数据库数据的持久化与重置。告别繁琐的本地配置，享受环境隔离、快速部署和一致性的优势，显著提升开发和测试效率。本文还详细介绍了如何定制PHP版本和扩展，以及管理数据库和测试数据，助你打造高效、可控的PHP测试环境。

最直接高效的方式是使用Docker Compose构建PHP测试环境。1. 创建docker-compose.yml文件定义服务（如PHP-FPM、Nginx、MySQL）及依赖关系；2. 配置Nginx处理PHP请求；3. 编写Dockerfile.php定制PHP环境，支持版本和扩展的灵活配置；4. 通过docker-compose命令快速启动、销毁环境，结合数据卷实现数据库数据的持久化与重置；5. 利用初始化脚本或应用程序工具管理测试数据。这种方式实现了环境隔离、快速部署和环境一致性，显著提升了开发和测试效率。

用Docker构建PHP测试环境，最直接高效的方式是利用Docker Compose。它能让你在几分钟内搭建一个隔离、可重复的开发或测试环境，无需污染本地机器，完美解决了版本冲突和环境配置的各种痛点。对我来说，这简直是解放生产力的利器。

解决方案

要用Docker构建一个PHP测试环境，核心是一个docker-compose.yml文件，它定义了你的服务（PHP-FPM、Nginx、数据库等）以及它们之间的连接。

首先，在你的项目根目录下创建一个docker-compose.yml文件：

# docker-compose.yml
version: '3.8'
services:
  nginx:
    image: nginx:alpine
    ports:
      - "8080:80" # 将容器的80端口映射到本地的8080端口
    volumes:
      - ./www:/var/www/html # 将本地的www目录映射到容器的Web根目录
      - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf # 映射Nginx配置文件
    depends_on:
      - php
    networks:
      - app-network

  php:
    build:
      context: . # 构建上下文为当前目录
      dockerfile: Dockerfile.php # 使用自定义的Dockerfile.php
    volumes:
      - ./www:/var/www/html # 将本地的www目录映射到容器的Web根目录
    networks:
      - app-network

  mysql:
    image: mysql:8.0 # 使用MySQL 8.0版本
    environment:
      MYSQL_ROOT_PASSWORD: root_password # 根用户密码
      MYSQL_DATABASE: test_db # 默认数据库
      MYSQL_USER: test_user # 默认用户
      MYSQL_PASSWORD: test_password # 默认用户密码
    volumes:
      - db_data:/var/lib/mysql # 数据持久化
    networks:
      - app-network

volumes:
  db_data: # 定义一个持久化卷，用于存储MySQL数据

networks:
  app-network: # 定义一个网络，让所有服务可以在其中通信
    driver: bridge

接着，你需要一个简单的Nginx配置文件来处理PHP请求。在项目根目录创建docker/nginx/default.conf：

# docker/nginx/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:9000; # 将PHP请求转发给php服务（容器名）的9000端口
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

为了定制PHP环境（比如安装特定扩展），我们创建一个Dockerfile.php文件：

# Dockerfile.php
FROM php:8.2-fpm-alpine # 基于PHP 8.2 FPM Alpine版本

# 安装必要的系统依赖和PHP扩展
RUN apk add --no-cache \
    libzip-dev \
    libpng-dev \
    jpeg-dev \
    freetype-dev \
    icu-dev \
    git \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) pdo_mysql gd zip intl opcache

# 设置工作目录
WORKDIR /var/www/html

# 可以在这里添加composer安装等步骤，如果你的项目需要
# COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
# RUN composer install --no-dev --no-interaction --optimize-autoloader

最后，在项目根目录创建一个www文件夹，并在其中放一个index.php文件进行测试：

Hello from PHP in Docker!";

// 尝试连接数据库
$servername = "mysql"; // Docker Compose中数据库服务的名称
$username = "test_user";
$password = "test_password";
$dbname = "test_db";

try {
    $conn = new PDO("mysql:host=$servername;dbname=$dbname", $username, $password);
    // 设置PDO错误模式为异常
    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    echo "
Connected to MySQL database successfully!
";

    // 简单查询示例
    $stmt = $conn->query("SELECT VERSION() as version");
    $row = $stmt->fetch(PDO::FETCH_ASSOC);
    echo "
MySQL Version: " . $row['version'] . "
";

} catch(PDOException $e) {
    echo "
Connection failed: " . $e->getMessage() . "
";
}
?>

现在，打开你的终端，进入项目根目录，运行：

docker compose up -d

稍等片刻，当所有服务都启动后，访问 http://localhost:8080，你应该能看到PHP的输出和数据库连接成功的提示。当你测试完成后，只需运行 docker compose down 就能干净地移除所有容器和网络。如果需要清掉数据库数据，就用 docker compose down -v。

为什么选择Docker来搭建PHP测试环境？

说实话，以前我为了测试一个PHP项目，总得在本地装Apache、PHP、MySQL，版本一多就乱套，有时候还得折腾WAMP/XAMPP，那配置起来真是一言难尽。现在有了Docker，我发现它简直是为这种临时或隔离环境而生的。

首先，环境隔离是最大的优势。每个项目都可以有自己独立的PHP版本、扩展和数据库，互不干扰。你不用担心A项目的PHP 7.4和B项目的PHP 8.2打架。其次，快速启动与销毁。一个docker-compose.yml文件就能定义整个环境，up一下就起来了，down一下就没了，特别适合做一次性的功能测试或代码验证。那种用完即弃的便捷感，是传统虚拟机或本地安装无法比拟的。再来，环境一致性。团队成员之间，或者从开发到测试再到生产，大家用的都是同一个Docker镜像，避免了“在我机器上没问题”的尴尬。这玩意儿，真能大幅提升开发效率和团队协作的顺畅度。

如何快速定制PHP版本或扩展？

定制PHP环境是Docker的强项。我们的Dockerfile.php就是干这个用的。你想用PHP 7.4？把FROM php:8.2-fpm-alpine改成FROM php:7.4-fpm-alpine就行。需要redis扩展？在Dockerfile.php里，找到RUN docker-php-ext-install那一行，加上redis。

比如，如果你需要安装redis和xdebug用于调试：

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

# 安装必要的系统依赖和PHP扩展
RUN apk add --no-cache \
    libzip-dev \
    libpng-dev \
    jpeg-dev \
    freetype-dev \
    icu-dev \
    git \
    redis-dev # Redis扩展的依赖包
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) pdo_mysql gd zip intl opcache redis

# 安装Xdebug
RUN pecl install xdebug \
    && docker-php-ext-enable xdebug

# 配置Xdebug (可选，根据你的调试需求调整)
COPY ./docker/php/xdebug.ini /usr/local/etc/php/conf.d/xdebug.ini

WORKDIR /var/www/html

然后，在docker/php/目录下创建xdebug.ini文件：

; docker/php/xdebug.ini
[xdebug]
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=host.docker.internal ; 或者你的宿主机IP
xdebug.client_port=9003
xdebug.log_level=0

每次修改Dockerfile.php后，记得重新构建镜像：

docker compose build php
docker compose up -d

这样，你就能根据项目需求，非常灵活地调整PHP环境，不用在本地机器上安装一堆乱七八糟的东西。

如何管理数据库数据和测试数据？

对于测试环境，数据库数据的管理通常需要兼顾持久化和快速重置。Docker Compose在这方面提供了很好的支持。

首先是数据持久化。在我们的docker-compose.yml中，mysql服务下面定义了一个volumes：

    volumes:
      - db_data:/var/lib/mysql # 数据持久化

这里的db_data是一个Docker卷（volume），它会把MySQL容器内部/var/lib/mysql目录的数据映射到Docker管理的一个宿主机目录。这意味着即使你停止或移除了mysql容器，只要不删除db_data这个卷，你的数据库数据就不会丢失。下次启动容器时，它会重新挂载到这个卷上，数据依然存在。

其次是测试数据管理。对于测试环境，我们经常需要一个干净的、预填充了特定测试数据的数据库。有几种做法：

1. 初始SQL脚本导入：你可以在mysql服务启动后，通过docker exec进入容器手动导入SQL文件，或者更自动化一点，在docker-compose.yml中为MySQL服务添加一个./initdb.d:/docker-entrypoint-initdb.d的卷映射。Docker官方的MySQL镜像会在启动时自动执行这个目录下的.sql、.sh或.sh脚本。你把你的测试数据SQL文件放进去，每次容器启动时就会自动导入。

   # docker-compose.yml (mysql service部分)
   mysql:
     # ...
     volumes:
       - db_data:/var/lib/mysql
       - ./docker/mysql/initdb.d:/docker-entrypoint-initdb.d # 自动导入SQL脚本

   然后在docker/mysql/initdb.d/目录下放你的test_data.sql。

2. 应用程序层面的数据填充：如果你的PHP项目有自己的数据迁移或数据填充工具（比如Laravel的Seeder），你可以在容器启动后，通过docker compose exec php php artisan migrate --seed这样的命令来填充数据。这通常更适合管理复杂的测试数据。

3. 快速重置：当你需要一个全新的数据库状态时，最简单粗暴但也最有效的方法就是删除数据卷。运行docker compose down -v，这里的-v参数会移除所有定义的匿名卷和具名卷（包括我们的db_data）。下次再docker compose up -d时，MySQL容器会从一个完全空白的状态重新启动，并执行initdb.d中的脚本（如果有的话），非常适合进行重复性的测试。

管理好这些，你的PHP测试环境就能在数据层面也做到随心所欲，想清空就清空，想预置就预置。

以上就是《Docker搭建PHP环境教程详解》的详细内容，更多关于dockercompose,Dockerfile,PHP测试环境,数据卷,环境隔离的资料请关注golang学习网公众号！