Юнит-тестирование в PHP: от основ до продвинутых техник

Расширенные примеры юнит-тестирования PHP

Рассмотрим более сложные сценарии, которые часто встречаются в реальных проектах.

Пример 1. Тестирование класса с зависимостью от базы данных (репозиторий)

Предположим, имеется класс UserService, который использует UserRepository для сохранения пользователя. Изолируем тест с помощью мока:

<?php
use PHPUnit\Framework\TestCase;

class UserServiceTest extends TestCase
{
    public function testCreateUser()
    {
        $repository = $this->createMock(UserRepository::class);
        $repository->expects($this->once())
                   ->method('save')
                   ->willReturn(1); // возвращаем ID

        $service = new UserService($repository);
        $user = $service->createUser('john@example.com', 'John');
        $this->assertInstanceOf(User::class, $user);
        $this->assertEquals(1, $user->getId());
    }
}

Результат: тест выполняется без реальной базы данных, проверяется, что метод save вызван ровно один раз.

Пример 2. Использование Prophecy для мокирования

Prophecy - альтернативная библиотека, встроенная в PHPUnit (через трейт MockObject). Пример:

use Prophecy\PhpUnit\ProphecyTrait;

class ShippingServiceTest extends TestCase
{
    use ProphecyTrait;

    public function testCalculateCost()
    {
        $rateProvider = $this->prophesize(RateProvider::class);
        $rateProvider->getRate('US')->willReturn(5.0);
        $service = new ShippingService($rateProvider->reveal());
        $this->assertEquals(15.0, $service->calculateCost(3, 'US'));
    }
}

Prophecy отличается лаконичным синтаксисом promises и prophecies.

Пример 3. Тестирование кода, работающего с файловой системой (vfsStream)

Для эмуляции файловой системы используется пакет mikey179/vfsstream. Настройка:

composer require --dev mikey179/vfsstream

Тест:

use org\bovigo\vfs\vfsStream;

class FileUploaderTest extends TestCase
{
    public function testUpload()
    {
        $root = vfsStream::setup('uploads');
        $uploader = new FileUploader(vfsStream::url('uploads'));
        $result = $uploader->store(new UploadedFile('test.txt', 'hello'));
        $this->assertTrue($result);
        $this->assertTrue($root->hasChild('test.txt'));
    }
}

Проблема: vfsStream не поддерживает все функции потоковой работы, но для большинства сценариев достаточно.

Пример 4. Тестирование HTTP-клиента с Guzzle Mock

Используем guzzlehttp/guzzle и встроенный MockHandler:

use GuzzleHttp\Client;
use GuzzleHttp\Handler\MockHandler;
use GuzzleHttp\HandlerStack;
use GuzzleHttp\Psr7\Response;

class ApiClientTest extends TestCase
{
    public function testFetchData()
    {
        $mock = new MockHandler([
            new Response(200, [], '{"status":"ok"}'),
        ]);
        $handlerStack = HandlerStack::create($mock);
        $client = new Client(['handler' => $handlerStack]);
        $api = new ApiClient($client);
        $this->assertEquals(['status' => 'ok'], $api->fetch());
    }
}

Результат: реальный HTTP-запрос не выполняется, тест быстр и детерминирован.

Пример 5. Тестирование команд Symfony Console

Команды можно тестировать через ApplicationTester:

use Symfony\Component\Console\Application;
use Symfony\Component\Console\Tester\CommandTester;

class GreetCommandTest extends TestCase
{
    public function testExecute()
    {
        $application = new Application();
        $application->add(new GreetCommand());
        $command = $application->find('app:greet');
        $commandTester = new CommandTester($command);
        $commandTester->execute(['name' => 'Alice']);
        $output = $commandTester->getDisplay();
        $this->assertStringContainsString('Hello, Alice', $output);
    }
}

Это позволяет тестировать консольные приложения без запуска процесса.

Пример 6. Тестирование с использованием контейнера внедрения зависимостей (PHP-DI)

В сложных проектах можно создать контейнер для тестовой среды:

use DI\ContainerBuilder;

$containerBuilder = new ContainerBuilder();
$containerBuilder->addDefinitions([
    // заменяем реальный репозиторий на мок
    UserRepository::class => function () {
        $mock = $this->createMock(UserRepository::class);
        $mock->method('find')->willReturn(new User('test'));
        return $mock;
    },
]);
$container = $containerBuilder->build();
$service = $container->get(UserService::class);

Такой подход удобен для интеграционного тестирования с заменой только части зависимостей.

Пример 7. Data Provider с повторным использованием фикстур

Создаём провайдер, который возвращает экземпляры объектов, чтобы не создавать их в каждом тесте:

public function discountDataProvider(): array
{
    $user = new User('VIP');
    $user->setDiscount(10);
    return [
        [$user, 100, 90],
        [new User('Regular'), 100, 100],
    ];
}

/** @dataProvider discountDataProvider */
public function testDiscount(User $user, $price, $expected)
{
    $calc = new PriceCalculator();
    $this->assertEquals($expected, $calc->calculate($user, $price));
}

Результат: код становится чище, а тесты - более модульными.

Пример 8. Тестирование асинхронных вызовов (Guzzle Promises)

Если используется GuzzleHttp\Promise, можно мокировать промис:

$promise = new FulfilledPromise('response');
$client = $this->createMock(Client::class);
$client->method('sendAsync')->willReturn($promise);
$service = new AsyncService($client);
$result = $service->process();
$this->assertEquals('response', $result->wait());

Проблема: не все библиотеки поддерживают промисы, но для Guzzle это штатное решение.