在容器中运行 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 管道。

配置 CI/CD