ТЕСТУВАННЯ

Тести, яким можна вірити

Які бувають тести, що чим перевіряти і як не потонути в моках. Pest, PHPStan і архітектурні тести на прикладах з PHP.

Нічого не знайшли. Спробуйте «mock», «fake» або «PHPStan».

PHPStan з повзунком ↓ Вивід Pest ↓ Маршрут ↓

ФОРМА ТЕСТІВ

↑ ПОВІЛЬНІШЕ, ДОРОЖЧЕЧАСТКА ТЕСТІВ

↓ ШВИДШЕ, ДЕШЕВШЕ

Піраміда Майка Кона (Mike Cohn): багато швидких unit-тестів і мало повільних. Класична порада для коду з багатою доменною логікою.

Трофей Кента Доддса (Kent C. Dodds): найбільше інтеграційних тестів, а в Laravel це feature-тести. Вони швидкі й ловлять те, що бачить користувач. В основі статичний аналіз.

Частки й час приблизні, це орієнтир, а не норма.

E2E у браузері ≈ 1–10 с

ПЕРЕВІРЯЄ

Справжній браузер клікає по сторінці, як користувач.

ЛАМАЄТЬСЯ ВІД

Верстки, JavaScript, усього разом. Іноді й від повільної мережі.

it('shows the vacancy page', function () {
    visit('/jobs/senior-laravel')
        ->assertSee('Відгукнутися')
        ->click('Відгукнутися')
        ->assertPathIs('/login');
});

Feature / HTTP ≈ 50–500 мс

ПЕРЕВІРЯЄ

HTTP-запит крізь увесь Laravel: маршрут, middleware, валідація, контролер, відповідь.

ЛАМАЄТЬСЯ ВІД

Маршруту, валідації, прав доступу, формату відповіді.

it('lets a candidate withdraw an application', function () {
    $application = Application::factory()->create();
 
    actingAs($application->candidate)
        ->post("/applications/{$application->id}/withdraw")
        ->assertRedirect();
 
    expect($application->fresh()->isWithdrawn())->toBeTrue();
});

Integration ≈ 20–200 мс

ПЕРЕВІРЯЄ

Кілька класів разом зі справжньою залежністю: базою, кешем, файлами.

ЛАМАЄТЬСЯ ВІД

Схеми бази, запиту, конфігу драйвера.

it('finds a saved application', function () {
    $repo = app(ApplicationRepository::class);
    $repo->save($application = ApplicationFactory::new()->make());
 
    expect($repo->find($application->id))->not->toBeNull();
});

Unit ≈ 1–10 мс

ПЕРЕВІРЯЄ

Один клас або функцію без бази, мережі й фреймворку.

ЛАМАЄТЬСЯ ВІД

Зміни логіки саме в цьому класі.

it('calculates the Nova Poshta rate', function () {
    $order = new Order(sum: 1200, weight: 3);
 
    expect((new NovaPoshtaRate)->quote($order))->toBe(96);
});

Статичний аналіз ≈ 5–30 с на проєкт

ПЕРЕВІРЯЄ

Код не запускається: PHPStan читає типи й шукає помилки до виконання.

ЛАМАЄТЬСЯ ВІД

Невідомих методів, неправильних типів, викликів на null.

vendor/bin/phpstan analyse --level=8
 
 [OK] No errors

01 — PHPSTAN І РІВНІ

Рухайте повзунок

Один і той самий контролер на різних рівнях аналізу. Кожен рівень додає перевірки до попередніх, і в коді зʼявляються нові помилки.

ProfileController.php приклад рівень 6: 5 помилок

1final class ProfileController

3 public function __construct(private Users $users) {}

5 public function show(int $id): string

6 {

7 $user = $this->users->find($id);

9 return $user->name;

L8 Cannot access property $name on User|null.find() повертає ?User: користувача може не бути. Рівень 8 не дає звертатися до nullable-значення без перевірки на null.

10 }

12 public function welcome(int $id): void

13 {

14 $this->users->findOrFial($id)->notify(new WelcomMail());

L0 Instantiated class WelcomMail not found.Класу WelcomMail ніде немає, схоже на одруківку. Невідомі класи PHPStan бачить уже на нульовому рівні.

L2 Call to an undefined method Users::findOrFial().У Users є findOrFail, а findOrFial немає. Нульовий рівень перевіряє методи лише на $this, а на будь-якому виразі, як $this->users, з рівня 2.

L10 Cannot call method notify() on mixed.Методу findOrFial немає, тож PHPStan не знає, що він повертає: це неявний mixed. Рівень 10 забороняє викликати методи й на ньому.

15 }

17 public function badge($user): string

L6 Method ProfileController::badge() has parameter $user with no type specified.Параметр без типу. Рівень 6 вимагає тип скрізь, де його можна вказати.

18 {

19 return $this->users->rank('42');

L3 Method ProfileController::badge() should return string but returns int.rank() повертає int, а метод обіцяє string. Типи повернення PHPStan звіряє з рівня 3.

L5 Parameter #1 $id of method Users::rank() expects int, string given.rank() чекає int, а сюди передали рядок. Типи аргументів перевіряє рівень 5.

20 }

22 public function title(string $raw): string

23 {

24 $data = json_decode($raw, true);

26 return $data['title'];

L9 Cannot access offset 'title' on mixed.json_decode() повертає mixed. На рівні 9 з mixed нічого не можна робити, доки тип не звужено, навіть узяти елемент масиву.

L9 Method ProfileController::title() should return string but returns mixed.Метод обіцяє string, а віддає mixed. Рівень 9 більше не вважає mixed сумісним з будь-яким типом.

27 }

28}

level: 6 Рівень 6 додає: відсутні типи

0 1 2 3 4 5 6 7 8 9 10

02 — PEST

Тест і те, що він каже

Три тести для перевізників зі сторінки Стратегії. Перемкніть на «Вивід», а потім зламайте тариф Укрпошти й подивіться, що каже Pest.

Що зламали в UkrposhtaRate

- return 35 + $order->weight * 8;
+ return 38 + $order->weight * 8;

Базовий тариф Укрпошти виріс з 35 до 38 грн, і посилка вагою 3 кг тепер коштує 38 + 3 × 8 = 62 замість 59.

PHPUnit, на якому стоїть Pest, спершу називає фактичне значення: «62 is identical to 59» означає «отримали 62, очікували 59».

Рядок зі стрілкою ➜ показує, де саме впала перевірка: восьмий рядок файлу з тестом. Два інші тести лишились зеленими, бо Нову пошту й Checkout зміна не зачепила.

Pest 5

<?php
 
it('calculates the Nova Poshta rate', function () {
    expect((new NovaPoshtaRate)->quote(order(weight: 3)))->toBe(96);
});
 
it('calculates the Ukrposhta rate', function () {
    expect((new UkrposhtaRate)->quote(order(weight: 3)))->toBe(59);
});
 
it('adds the rate to the order sum', function () {
    $checkout = new Checkout(new FakeRate(price: 50));
 
    expect($checkout->total(order(sum: 1200)))->toBe(1250);
});

PASS Tests\Unit\ShippingRateTest

✓ it calculates the Nova Poshta rate 0.01s

✓ it calculates the Ukrposhta rate

✓ it adds the rate to the order sum

Tests: 3 passed (3 assertions)

Duration: 0.10s

FAIL Tests\Unit\ShippingRateTest

✓ it calculates the Nova Poshta rate

⨯ it calculates the Ukrposhta rate

✓ it adds the rate to the order sum

────────────────────────────────────────────────────────────────────────────

FAILED Tests\Unit\ShippingRateTest > it calculates the Ukrposhta rate

Failed asserting that 62 is identical to 59.

at tests/Unit/ShippingRateTest.php:8

4▕ expect((new NovaPoshtaRate)->quote(order(weight: 3)))->toBe(96);

5▕ });

6▕

7▕ it('calculates the Ukrposhta rate', function () {

➜ 8▕ expect((new UkrposhtaRate)->quote(order(weight: 3)))->toBe(59);

9▕ });

10▕

11▕ it('adds the rate to the order sum', function () {

12▕ $checkout = new Checkout(new FakeRate(price: 50));

1 tests/Unit/ShippingRateTest.php:8

Tests: 1 failed, 2 passed (3 assertions)

Duration: 0.08s

$ vendor/bin/pest tests/Unit/ShippingRateTest.php

03 — ТЕМИ

Каталог тем

11 розібрано

Основи

Basics · 5 тем

Що таке тест, які бувають тести й чим підміняти залежності.

Види тестів

Unit, integration, feature, e2e: що кожен перевіряє й скільки коштує.

› vendor/bin/pest --testsuite=Unit

Перший unit-тест домену

Тест без бази й фреймворку: обʼєкт, дія, перевірка.

› expect($order->total())->toBe(1250);

Test doubles

Dummy, stub, spy, mock, fake без плутанини.

› $mailer = Mockery::spy(Mailer::class);

Фейки адаптерів

In-memory репозиторій замість бази й фейковий клієнт замість API.

› $jobs = new InMemoryJobRepository;

Час і випадковість

FrozenClock, seed і тести, що не падають щопʼятниці.

› $this->travelTo(now()->startOfWeek());

Інструменти

Tools · 3 теми

Pest, вбудовані фейки Laravel і тести в Symfony.

Pest

expect(), datasets, архітектурні й браузерні тести.

› composer require pestphp/pest --dev

Фейки Laravel

Mail::fake, Queue::fake, Http::fake, Storage::fake.

› Http::fake(['novaposhta.ua/*' => Http::response($rates)]);

Тести в Symfony

KernelTestCase, WebTestCase і тестовий контейнер.

› php bin/phpunit --testdox

Якість коду

Code quality · 3 теми

Перевірки, які ловлять помилки без жодного написаного тесту, і тести для самих тестів.

Архітектурні тести

Домен не імпортує фреймворк, контролери не лізуть у базу.

› arch()->expect('App\Domain')->not->toUse('Illuminate');

PHPStan і рівні

Від нуля до десяти без болю: baseline і поступовий підйом.

› vendor/bin/phpstan analyse --level=8

Мутаційне тестування

Чи справді тести ловлять зміни в коді.

› vendor/bin/pest --mutate

04 — СПІЛЬНИЙ МАРШРУТ

Архітектура й тести разом

Щойно зʼявляється нова ідея, ви одразу вчитеся її перевіряти. Цей самий маршрут є й на хабі архітектури.

АрхітектураТестування

9 кроків · 9 вже є

// ЯК У PHP UKRAINE

Що перевіряють перед кожним деплоєм цього сайту

deploy/deploy.sh Перед кожним деплоєм запускає PHPStan і весь набір тестів Pest. Якщо хоч щось червоне, деплой зупиняється.

tests/Architecture/LayersTest.php Не пускає Illuminate й Livewire у доменний і прикладний шари, домену забороняє ще й App, а в усьому src/ вимагає strict_types.

src/Shared/Clock/FrozenClock.php Підміняє годинник у тестах: advance('+30 days') замість місяця очікування.

tests/Support/InMemoryJobRepository.php In-memory JobRepository для unit-тестів домену, без жодної бази.

phpstan.neon PHPStan рівня 8 з Larastan перевіряє app/ і src/.