Docker PHP项目测试指南：容器化环境下的测试实践-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00382/article/details/148549152

Docker PHP项目测试指南：容器化环境下的测试实践

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

前言

在现代软件开发中，测试是确保代码质量的关键环节。本文将详细介绍如何在Docker环境中为PHP项目执行测试，涵盖本地开发测试和构建时测试两种场景。

准备工作

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

已容器化PHP应用程序
项目目录结构完整，包含测试文件
已安装Docker和Docker Compose

测试类型概述

在PHP项目中，常见的测试类型包括：

单元测试：验证单个函数或方法的行为
集成测试：验证多个组件协同工作的情况
端到端测试：验证整个应用流程

本文主要关注使用PHPUnit进行单元测试的实现方式。

本地开发环境测试

使用Docker Compose运行测试

在本地开发时，最简单的方式是使用Docker Compose运行测试。假设项目目录结构如下：

docker-php-sample/
├── src/
├── tests/
│   └── HelloWorldTest.php
├── composer.json
└── composer.lock

执行以下命令运行测试：

docker compose run --build --rm server ./vendor/bin/phpunit tests/HelloWorldTest.php

命令解析

--build：构建镜像（如果尚未构建）
--rm：测试完成后自动删除容器
server：服务名称（在docker-compose.yml中定义）
./vendor/bin/phpunit：PHPUnit可执行文件路径
tests/HelloWorldTest.php：要运行的测试文件

预期输出

成功执行后，将看到类似以下输出：

Hello, Docker!PHPUnit 9.6.13 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time: 00:00.003, Memory: 4.00 MB

OK (1 test, 1 assertion)

构建时集成测试

为了将测试集成到构建流程中，我们需要修改Dockerfile，添加专门的测试阶段。

多阶段构建Dockerfile示例

# 语法定义
# syntax=docker/dockerfile:1

# 生产依赖安装阶段
FROM composer:lts as prod-deps
WORKDIR /app
RUN --mount=type=bind,source=./composer.json,target=composer.json \
    --mount=type=bind,source=./composer.lock,target=composer.lock \
    --mount=type=cache,target=/tmp/cache \
    composer install --no-dev --no-interaction

# 开发依赖安装阶段
FROM composer:lts as dev-deps
WORKDIR /app
RUN --mount=type=bind,source=./composer.json,target=composer.json \
    --mount=type=bind,source=./composer.lock,target=composer.lock \
    --mount=type=cache,target=/tmp/cache \
    composer install --no-interaction

# 基础镜像阶段
FROM php:8.2-apache as base
RUN docker-php-ext-install pdo pdo_mysql
COPY ./src /var/www/html

# 开发环境阶段
FROM base as development
COPY ./tests /var/www/html/tests
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
COPY --from=dev-deps app/vendor/ /var/www/html/vendor

# 测试阶段
FROM development as test
WORKDIR /var/www/html
RUN ./vendor/bin/phpunit tests/HelloWorldTest.php

# 最终生产镜像
FROM base as final
RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
COPY --from=prod-deps app/vendor/ /var/www/html/vendor
USER www-data

关键点说明

多阶段构建：分离依赖安装、开发环境和测试环境
缓存优化：使用--mount=type=cache加速依赖安装
测试阶段：专门添加test阶段执行测试
环境区分：开发和生产使用不同的php.ini配置

执行构建时测试

运行以下命令执行构建时测试：

docker build -t php-docker-image-test --progress plain --no-cache --target test .

参数说明：

--progress plain：显示详细构建输出
--no-cache：确保每次都会运行测试
--target test：指定构建到测试阶段

预期输出

构建输出中将包含测试结果：

#18 [test 2/2] RUN ./vendor/bin/phpunit tests/HelloWorldTest.php
#18 0.385 Hello, Docker!PHPUnit 9.6.13 by Sebastian Bergmann and contributors.
#18 0.392
#18 0.394 .                                                                   1 / 1 (100%)
#18 0.395
#18 0.395 Time: 00:00.003, Memory: 4.00 MB
#18 0.395
#18 0.395 OK (1 test, 1 assertion)