在容器中執行 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)

摘要

在本節中，您學習了如何在本地開發時使用 Compose 執行測試，以及如何在建置映像時執行測試。

相關資訊

後續步驟

接下來，您將學習如何使用 GitHub Actions 設定 CI/CD 流程。

設定 PHP 應用程式的 CI/CD »