Тестируйте шаг за шагом: от прототипа до рабочего PHP-кода
Если вы ещё выясняете, какой ответ отдаёт внешний сервис, начните с короткого эксперимента. Если правила уже известны, первый тест можно написать до реализации. В обоих случаях перед слиянием изменений стоит закрепить то поведение, на которое будут рассчитывать пользователи и другие части приложения.
Выберите, что выяснять первым
Порядок работы зависит от того, где находится неопределённость. Если известны входные данные, ожидаемый результат и пограничные случаи, тест помогает уточнить контракт до реализации. Если пока непонятно, подходит ли библиотека, какие поля реально приходят от поставщика или где провести границу транзакции, сначала соберите данные для решения.
- Правило известно. Начните с теста. Например, скидка действует при сумме заказа от заданного порога включительно. Случаи чуть ниже порога и ровно на нём проясняют требование ещё до написания расчёта.
- Нужно проверить предположение. Сделайте короткий эксперимент, затем закрепите выбранное поведение тестами. Такой порядок называют Spike and Stabilize: сначала исследование, затем стабилизация.
- Меняется действующий код. Сначала зафиксируйте поведение, которое нужно сохранить. Если исправляете дефект, добавьте тест, который падает на старой реализации и проходит после исправления.
У раннего теста есть цена: если форма решения меняется каждый час, придётся переделывать фикстуры и тестовые двойники. У отсрочки тоже есть цена: пока теста нет, каждую правку приходится перепроверять вручную, а случайное изменение поведения легко пропустить. Чем дороже ошибка, тем раньше нужна автоматическая проверка. Для повторного списания денег проверка идемпотентности нужна уже при реализации рабочего сценария.
Ограничьте эксперимент одним вопросом
Допустим, нужно импортировать остатки поставщика из CSV. Первый вопрос звучит так: одинаково ли читаются выгрузки из двух его систем? Возьмите несколько обезличенных файлов, проверьте разделитель, заголовок, кодировку и строки с пустым количеством. Короткого CLI-скрипта достаточно, чтобы получить наблюдаемый результат: например, обе системы используют точку с запятой, одна добавляет UTF-8 BOM, а пустое количество встречается в обеих.
Заранее задайте условие остановки. В этом примере эксперимент завершён, когда понятно, какие форматы поддерживать и что делать с неоднозначными данными. Затем решите, какой контракт закрепить. Например, нулевой остаток допустим, пустое количество считается ошибкой, а наличие BOM обрабатывается при чтении заголовка. Подготовьте маленькие фикстуры с такими случаями. Рабочий импорт можно реализовать заново или выделить из прототипа пригодную часть после того, как определены правила обработки ошибок и записи данных.
Закрепите правило тестом PHPUnit
В PHP 8.3–8.5 можно объявить типы входа и результата и включить declare(strict_types=1) в файлах реализации и тестов. Для скалярных аргументов режим определяется файлом, из которого сделан вызов. При этом поле CSV всё равно приходит строкой, а строка может содержать что угодно. Поэтому проверку формата и диапазона стоит держать на границе импорта.
Пусть контракт принимает десятичную запись от 0 до 999999 без пробелов, знака и ведущих нулей. Это правило конкретного импорта. Здесь преобразование в int безопасно, потому что длина и формат проверены заранее.
<?php
declare(strict_types=1);
function parseStock(string $field): int
{
// Преобразуем значение после проверки формата и диапазона.
if (preg_match('/\A(?:0|[1-9][0-9]{0,5})\z/', $field) !== 1) {
throw new InvalidArgumentException('Некорректный остаток');
}
return (int) $field;
}Сохраните функцию в src/stock.php, а тест в tests/StockTest.php. Установите PHPUnit как зависимость для разработки и подберите выпуск, совместимый с версией PHP, на которой запускаете тесты. Этот пример использует атрибут DataProvider.
<?php
declare(strict_types=1);
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\TestCase;
require_once __DIR__ . '/../src/stock.php';
final class StockTest extends TestCase
{
public function testAcceptsBoundaryValues(): void
{
self::assertSame(0, parseStock('0'));
self::assertSame(999999, parseStock('999999'));
}
#[DataProvider('invalidFields')]
public function testRejectsInvalidField(string $field): void
{
$this->expectException(InvalidArgumentException::class);
parseStock($field);
}
public static function invalidFields(): iterable
{
// Каждый набор фиксирует отдельную причину отказа.
yield 'пустое поле' => [''];
yield 'отрицательное число' => ['-1'];
yield 'ведущий ноль' => ['01'];
yield 'пробел' => [' 1'];
yield 'выше максимума' => ['1000000'];
}
}vendor/bin/phpunit tests/StockTest.phpassertSame() проверяет и значение, и тип результата. Чтобы убедиться, что тест чувствителен к нужной ошибке, запустите его на реализации, где эта ошибка присутствует. Например, прямое приведение пустой строки к int даст ноль, и набор «пустое поле» упадёт, потому что ожидает исключение.
Проверьте взаимодействие там, где возникает риск
Тест функции отвечает за разбор одного поля. Для проверки всего импорта подготовьте CSV из двух строк данных: первая корректная, во второй остаток пустой. Если по договорённости файл обрабатывается целиком в одной транзакции, после отказа проверьте содержимое таблицы через отдельный запрос. Так тест обнаружит частичную запись, даже если команда правильно сообщила об ошибке.
| Уровень | Что закрепить в импорте | Что наблюдать |
|---|---|---|
| Модульный | Формат и границы остатка | Точное целое число или исключение |
| Интеграционный | Чтение CSV, запись и откат | Строки в БД после успешного и неуспешного импорта |
| Сквозной | Один запуск через штатную CLI-команду | Код выхода и результат импорта |
Если важны транзакции и ограничения, запускайте интеграционный тест на том же движке БД, что используется в приложении, с актуальными миграциями и изолированными данными. Если импорт начинается с HTTP-запроса, подставьте ответ поставщика через тестовый транспорт. Проверку совместимости с реальным сервисом можно запускать отдельно, чтобы сбои сети не мешали проверять изменения локально и в CI.
Меняйте старый код небольшими шагами
Предположим, старый импорт превращает пустой остаток в ноль. Начните с теста через публичную точку входа, который закрепит соседние сценарии: корректный файл обновляет нужный товар, а явно переданный ноль сохраняется. Затем добавьте сценарий с пустым полем и ожидаемым откатом. Он должен упасть на прежнем коде. Введите проверку поля, добейтесь прохождения тестов и после этого выносите разбор строки в отдельную функцию, если это упрощает код.
Если тест требует подменить цепочку внутренних вызовов, проверьте, можно ли выразить требование через видимый результат. Для импорта это состояние таблицы и код выхода. Проверку числа вызовов имеет смысл оставить там, где повтор сам по себе нарушает контракт, например при отправке уведомления после повторной доставки задания.
Запускайте проверки по мере изменения кода
Во время правки запускайте ближайший тест. Перед открытием запроса на слияние прогоните набор для затронутого сценария. В CI сделайте обязательными быстрые тесты и интеграционные проверки критичных границ. Если приложение заявляет совместимость с PHP 8.3–8.5, включите эти версии в матрицу CI. Так можно обнаружить случайное использование функции, недоступной на минимальной версии, и ошибки, которые проявляются только на другой версии среды.
Добавляйте проверки по наблюдаемым рискам. Если задание очереди может выполниться повторно, проверьте повторную обработку одного идентификатора. Если конкурентные импорты могут перезаписать остаток, воспроизведите конфликт на уровне БД. При исправлении сбоя сохраняйте минимальный пример входа, который его вызвал. Такой тест помогает понять причину падения без восстановления всего набора данных.
Чек-лист перед слиянием изменений
- Сформулируйте ожидаемое поведение на одном конкретном примере. Если ответ пока неизвестен, проведите короткий эксперимент с условием остановки.
- Закрепите успешный сценарий, значимую границу и отказ. Ожидания должны вытекать из требований к функции или операции.
- Для исправления воспроизведите ошибку тестом на прежнем коде и убедитесь, что после правки он проходит.
- Проверьте реальные побочные эффекты там, где важны транзакции, повторные попытки или запись во внешнюю систему.
- Прогоните тесты через штатную точку входа и на заявленных версиях PHP в CI. Разберите падения до слияния.
Частые вопросы
Когда писать тесты до кода, а когда после прототипа?
Начинайте с теста, когда можете назвать вход и ожидаемый результат. Если нужно выяснить свойства библиотеки, внешнего сервиса или формата данных, сначала проведите короткий эксперимент и закрепите выбранное поведение перед слиянием.
Сколько тестов нужно для новой функции на PHP?
Начните с типичного результата, значимой границы и отказа. Добавляйте случаи, когда они отражают разные правила или защищают от конкретных регрессий. Поведение базы данных и других зависимостей проверяйте на соответствующем уровне.
Как начать тестировать существующий PHP-код перед рефакторингом?
Выберите публичную точку входа и закрепите результаты, от которых зависят пользователи и вызывающий код. При исправлении ошибки добавьте отдельный падающий сценарий. Меняйте реализацию небольшими шагами и запускайте тесты после каждого шага.