PHPTime

Как начать писать тесты для PHP

Возьмите правило, которое легко сломать при следующей правке, и запишите его в виде автоматического теста. Разберём этот подход на расчёте доставки, а затем применим его к зависимостям, старому коду и проверкам в CI.

Выберите поведение для первого теста

Начните с правила, для которого можно назвать входные данные и ожидаемый результат. Хорошие кандидаты — расчёт комиссии, истечение срока промокода, переход заказа в другой статус. Если в проекте уже есть баг, возьмите сценарий из отчёта об ошибке. Конкретный пример легче проверить и обсудить, чем абстрактное требование «покрыть корзину тестами».

Сформулируйте правило до написания кода. Допустим, доставка стоит 300 ₽, а при заказе от 5 000 ₽ она бесплатна. Суммы хранятся в копейках. Здесь полезны три значения: 499_999, 500_000 и 500_001. Случай ровно на пороге отличает правильное условие >= от ошибочного >. Если отрицательная сумма запрещена, это отдельное правило, которое тоже можно выразить тестом.

Напишите первый юнит-тест с PHPUnit

В Composer-проекте добавьте PHPUnit в зависимости разработки командой composer require --dev phpunit/phpunit. Для приложения, которое поддерживает PHP 8.3–8.5, разрешайте зависимости с учётом нижней границы PHP 8.3, чтобы набор тестов запускался на всей заявленной матрице. В существующем проекте используйте его конфигурацию и расположение файлов. Для примера ниже достаточно минимальной конфигурации в корне проекта и двух файлов в папке tests и рядом с ней.

HTML
<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="vendor/autoload.php">
    <testsuites>
        <testsuite name="Application">
            <directory>tests</directory>
        </testsuite>
    </testsuites>
</phpunit>

Сохраните конфигурацию как phpunit.xml, а функцию — как shipping.php в корне проекта.

PHP
<?php

declare(strict_types=1);

function shippingCost(int $subtotal): int
{
    if ($subtotal < 0) {
        throw new InvalidArgumentException('Сумма заказа не может быть отрицательной');
    }

    // Все суммы в копейках.
    return $subtotal >= 500_000 ? 0 : 30_000;
}

Сохраните тест в tests/ShippingTest.php. В примере функция подключается явно. В приложении с настроенной автозагрузкой классов достаточно загрузчика Composer из конфигурации PHPUnit.

PHP
<?php

declare(strict_types=1);

use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\TestCase;

require_once dirname(__DIR__) . '/shipping.php';

final class ShippingTest extends TestCase
{
    #[DataProvider('thresholdCases')]
    public function testCostAtThreshold(int $subtotal, int $expected): void
    {
        self::assertSame($expected, shippingCost($subtotal));
    }

    public static function thresholdCases(): array
    {
        // Имена наборов отображаются в отчёте PHPUnit.
        return [
            'на копейку ниже порога' => [499_999, 30_000],
            'ровно на пороге' => [500_000, 0],
            'на копейку выше порога' => [500_001, 0],
        ];
    }

    public function testRejectsNegativeSubtotal(): void
    {
        $this->expectException(InvalidArgumentException::class);

        shippingCost(-1);
    }
}

Запустите из корня проекта php vendor/bin/phpunit. assertSame() сравнивает значение и тип, поэтому строка '0' не пройдёт как целое число. Поставьте expectException() непосредственно перед вызовом, который должен выбросить исключение. Тогда сбой при подготовке данных не сможет случайно удовлетворить это ожидание. Директива strict_types для скалярных аргументов действует со стороны вызывающего файла, поэтому в примере она есть и в тесте.

Сделайте зависимости управляемыми

Если расчёт скидки сам берёт текущее время, читает настройки из окружения и запрашивает базу, для проверки одного условия придётся воспроизвести работу всего приложения. Разделите получение данных и принятие решения. Для правила истечения промокода часто достаточно передать два значения DateTimeImmutable: срок действия и время проверки. Тест задаст оба и проверит, действует ли промокод ровно в момент окончания.

Если время нужно в нескольких местах одного сервиса, передайте часы через конструктор. В рабочем приложении они возвращают текущее время, а в тесте — фиксированное. Так же можно передать клиент платёжного шлюза. Заглушка вернёт заранее заданный отказ, а тест проверит, что заказ остался неоплаченным. Если правило требует, чтобы при повторной обработке успешного платежа шлюз вызывался только один раз, проверка вызовов тоже уместна.

Оставляйте закрытые методы закрытыми и проверяйте их через публичное поведение. Статический метод, который предсказуемо преобразует входные данные, легко тестировать. Создание DateTimeImmutable из переданной даты внутри метода тоже не мешает. Выносить стоит зависимости, которые открывают соединение, читают глобальное состояние или делают результат зависимым от окружения. Выделяйте компоненты вокруг самостоятельных правил, которые можно назвать и проверить отдельно.

Выберите уровень проверки по риску

УровеньЧто проверяетПример
Юнит-тестПравило на управляемых входных данныхБесплатная доставка ровно от 5 000 ₽
Интеграционный тестВзаимодействие с реальной инфраструктурой или компонентомРепозиторий сохраняет заказ и читает его из тестовой PostgreSQL
Сквозной тестПрохождение ключевого пользовательского сценария через приложениеПокупатель оформляет заказ и видит подтверждение

Проверяйте поведение на самом узком уровне, где может проявиться проблема. Для арифметики достаточно юнит-теста. Если риск связан с SQL, миграцией или ограничением уникальности, используйте изолированную базу того же типа, что и в рабочем окружении. Заглушка PDO позволит проверить реакцию приложения на исключение, а совместимость запроса с PostgreSQL покажет запуск запроса в PostgreSQL.

Для стороннего API проверьте обработку успешного ответа, отказа и тайм-аута на управляемых ответах. Совместимость реального клиента с контрактом провайдера проверяйте отдельно в его тестовой среде, если она доступна. Сквозные тесты оставьте для нескольких важных маршрутов, где сбой может возникнуть на стыке маршрутизации, авторизации, хранения и отображения результата.

Добавляйте тесты к старому коду через баги

Предположим, в рабочем коде доставка ошибочно платная при заказе ровно на 5 000 ₽. Сначала добавьте тест для 500_000 и запустите его на текущей реализации. Убедитесь, что он упал по нужной причине: вместо нуля функция вернула 30_000. Затем исправьте условие и запустите тест ещё раз. Оставьте его в наборе, чтобы следующая правка не вернула ошибку.

Если расчёт спрятан в контроллере и зависит от базы, начните с теста доступной границы, например HTTP-запроса к тестовому приложению. Зафиксируйте поведение соседних сценариев, которое нужно сохранить. Затем выделите расчёт в отдельную функцию или класс и добавьте быстрые проверки границ. Такой порядок помогает отличить исправление дефекта от изменений, которые появились при переносе кода.

Для новой функции тот же цикл можно начать с теста на требуемое поведение. Посмотрите, как он падает, реализуйте правило и после успешного запуска упростите код. Если тест сложно подготовить, проверьте, нельзя ли сделать входные данные явными или перенести побочные эффекты на границу приложения. Сложность теста часто указывает на то, что метод взял на себя слишком много задач.

Запускайте тесты локально и в CI

Используйте одну команду запуска на компьютере разработчика и в CI. Для приложения храните composer.lock в репозитории и устанавливайте зависимости через composer install, включая зависимости разработки для тестового задания. На каждом pull request прогоняйте набор на заявленных версиях PHP. Если приложение поддерживает PHP 8.3–8.5, отдельные задания на этих версиях покажут, где возникла несовместимость. Проверяйте версии расширений и настройки там, где они влияют на результат.

Создавайте тестовую схему миграциями и подготавливайте исходные записи для каждого сценария. Тест должен одинаково проходить сам по себе и в составе всего набора. При параллельном запуске выделяйте отдельную схему или базу каждому процессу, если тесты меняют общие таблицы. Случайные падения разбирайте по причине: общее состояние, реальное время, фоновые задачи или сетевые обращения. Для асинхронного сценария проверяйте наблюдаемое состояние с ограниченным ожиданием вместо фиксированной паузы.

Отчёт о покрытии помогает найти ветки, которые ни разу не выполнились. Чтобы оценить качество проверки, посмотрите на утверждения: тест может исполнить всю функцию и пропустить ошибку, если проверяет только тип результата. Для критичных правил полезно один раз внести обратимую ошибку в условие, запустить тест и убедиться, что он её ловит. При обновлении библиотек прогоняйте собственные сценарии на тех вызовах, от которых зависит приложение.

Чек-лист для следующей правки

  1. Запишите ожидаемое поведение на конкретных входных данных. Добавьте граничный случай, если правило содержит порог, дату или ограничение.
  2. Выберите уровень теста, на котором проявится ошибка. Время, сеть и хранилище сделайте управляемыми там, где они только мешают проверить правило.
  3. Воспроизведите баг до исправления и прочитайте сообщение о падении. После правки запустите этот тест и весь связанный набор.
  4. Дайте сценарию имя, по которому будет понятно, какое правило нарушено. Проверьте, что он проходит отдельно и не зависит от порядка запуска.
  5. Включите тест в CI. При следующем изменении добавьте сценарий, который защищает именно изменившееся поведение.

Частые вопросы

С чего начать тестирование старого PHP-проекта?

Возьмите известный баг и воспроизведите его тестом через ближайшую доступную границу, например публичный метод или HTTP-обработчик. Убедитесь, что тест падает по ожидаемой причине, исправьте баг и сохраните тест для следующих изменений.

Когда в PHPUnit использовать заглушку, а когда реальную базу?

Заглушка подходит, когда нужно проверить реакцию сервиса на заданный ответ хранилища. Изолированная база того же типа, что и в рабочем окружении, нужна для проверки SQL, миграций, ограничений и транзакций.

Нужно ли добиваться 100% покрытия PHP-кода тестами?

Универсального порога нет. Начните с критичных правил, граничных условий и сценариев, где уже возникали ошибки. Покрытие помогает найти пропуски, а точные утверждения в тестах определяют, заметите ли вы регрессию.

Справка по теме

Ещё в разделе «Архитектура и практика»

Эффективный рефакторинг PHP-кода

Практическое руководство по рефакторингу в PHP 8.3–8.5. Как зафиксировать поведение тестами, усилить типизацию, разделить обязанности и удалить мёртвый код.

7 мин

Декаплинг и фреймворки в PHP: как перестать зависеть от чужих обновлений

Как отделить бизнес-логику от фреймворка в современных PHP-проектах. Интерфейсы, DTO, адаптеры, DI-контейнеры и стратегии миграции без остановки разработки.

7 мин

Как задать вопрос по PHP, чтобы получить ответ

Как задать вопрос по PHP: соберите минимальный воспроизводимый пример, укажите версии и условия запуска, приложите текст ошибки и выберите площадку.

7 мин

Учимся по видеозаписям конференций PHP Frameworks Day: практический гид

Как системно учиться по записям выступлений с PHP-конференций: выбирать доклады, конспектировать код, внедрять практики в проект.

5 мин