在容器中运行 PHP 测试
先决条件
从容器化 PHP 应用程序开始,完成本指南前面的所有部分 。
概述
测试是现代软件开发的重要组成部分。测试对于不同的开发团队来说意味着很多事情。有单元测试、集成测试和端到端测试。在本指南中,您将了解在开发和构建时在 Docker 中运行单元测试。
在本地开发时运行测试
示例应用程序的tests
目录中已经有一个 PHPUnit 测试。在本地开发时,您可以使用 Compose 来运行测试。
在目录中运行以下命令docker-php-sample
以在容器内运行测试。
$ docker compose run --build --rm server ./vendor/bin/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)
要了解有关该命令的更多信息,请参阅 docker compose run。
构建时运行测试
要在构建时运行测试,您需要更新 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
运行以下命令以测试阶段为目标构建镜像并查看测试结果。包括--progress plain
查看构建输出、--no-cache
确保测试始终运行以及--target test
针对测试阶段。
$ docker build -t php-docker-image-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)
要了解有关构建和运行测试的更多信息,请参阅 使用 Docker 构建指南。
概括
在本部分中,您了解了如何在使用 Compose 进行本地开发时运行测试以及如何在构建映像时运行测试。
相关信息:
下一步
接下来,您将学习如何使用 GitHub Actions 设置 CI/CD 管道。