Как вы тестируете PHP код с помощью PHPUnit?

Question

Accepted Answer

**PHPUnit** — это стандартный фреймворк тестирования для PHP, используется для написания модульных и интеграционных тестов, которые проверяют корректность работы кода. В сочетании с внедрением зависимостей (для создания mock-объектов) и такими инструментами, как поставщики данных, он обеспечивает комплексное и поддерживаемое тестирование.

## Базовый тест

```php
<?php
use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase {
    public function testAdd(): void {
        $calc = new Calculator();
        $result = $calc->add(2, 3);
        $this->assertEquals(5, $result);          // assertion
        $this->assertIsInt($result);
    }

public function testDivideByZeroThrows(): void {
        $this->expectException(DivisionByZeroError::class);   // assert it throws
        (new Calculator())->divide(1, 0);
    }
}
// run with: ./vendor/bin/phpunit
```

Тестовые классы наследуют `TestCase`, методы тестов начинаются с `test` (или используют атрибут `#[Test]`), и используют методы `assert*` для проверки ожиданий (`assertEquals`, `assertTrue`, `assertCount` и т. д.). `expectException` тестирует обработку ошибок.

## Создание mock-объектов (изоляция через внедрение зависимостей)

```php
public function testSendsWelcomeEmail(): void {
    // create a MOCK of a dependency — no real mailer needed
    $mailer = $this->createMock(MailerInterface::class);
    $mailer->expects($this->once())          // assert it's called exactly once
           ->method('send')
           ->with('ann@x.com', $this->stringContains('Welcome'));

$service = new UserService($mailer);     // INJECT the mock (DI makes this easy)
    $service->register('ann@x.com');
}
```

Mocking в PHPUnit позволяет заменять зависимости (почтовые сервисы, репозитории, API) контролируемыми заменителями — а внедрение зависимостей делает их внедрение тривиальным. Вы можете проверить, что mock-объекты вызваны правильно. Это основа быстрых, изолированных модульных тестов.

## Поставщики данных (тестирование множества случаев)

```php
public static function additionCases(): array {
    return [[1, 1, 2], [0, 5, 5], [-1, 1, 0]];   // [a, b, expected]
}

#[DataProvider('additionCases')]
public function testAdd(int $a, int $b, int $expected): void {
    $this->assertEquals($expected, (new Calculator())->add($a, $b));
}
```

**Поставщики данных** запускают один и тот же тест с множеством наборов входных данных — чистое покрытие нескольких случаев без дублирования.

## Лучшие практики

```text
✓ Test behavior/public API, not implementation details (so refactors don't break tests)
✓ Mock external dependencies (DB, APIs, mailers) for fast, isolated unit tests
✓ Use a test database for integration tests; setUp/tearDown for fixtures
✓ Measure coverage; test edge cases and error paths, not just the happy path
✓ Frameworks (Laravel, Symfony) build on PHPUnit with extra testing helpers
```

## Почему это важно

Тестирование — это необходимо для создания надежных, поддерживаемых PHP приложений, и **PHPUnit** — это стандартный инструмент — поэтому понимание того, как тестировать PHP, важно как для качества кода, так и в качестве профессионального требования.

Знание того, как писать тесты (наследование `TestCase`, использование утверждений, тестирование путей обработки исключений), является фундаментальным, но наиболее ценный вывод — это то, как **внедрение зависимостей обеспечивает чистое тестирование**: поскольку хорошо спроектированные PHP классы получают свои зависимости, mocking в PHPUnit позволяет заменять реальные зависимости (базы данных, почтовые сервисы, внешние API) контролируемыми заменителями — обеспечивая быстрые, изолированные модульные тесты без реальной инфраструктуры, и позволяя проверить взаимодействие (убедиться, что mock был вызван правильно).

Эта связь между внедрением зависимостей и тестируемостью — это именно то, почему паттерн внедрения зависимостей имеет такое большое значение.

Понимание mocking, **поставщиков данных** (эффективное тестирование многих входных случаев) и лучших практик тестирования (тестирование поведения, а не реализации, создание mock-объектов внешних зависимостей, покрытие пограничных случаев и путей ошибок, использование тестовых баз данных для интеграционных тестов) охватывает практическую область эффективного тестирования PHP.

Хорошо протестированный PHP ловит регрессии, обеспечивает уверенный рефакторинг и документирует ожидаемое поведение, и поскольку современные фреймворки (Laravel, Symfony) строят своё тестирование на PHPUnit, знание его широко применимо.

Овладение PHPUnit — особенно использование mocking и внедрения зависимостей для изолированных тестов — это важные знания для старших разработчиков, которые отличают разработчиков, создающих надежные, поддерживаемые, хорошо протестированные приложения, от тех, кто поставляет непротестированный, хрупкий код, что делает это часто актуальной, профессионально важной темой.