Inštalácia

Testing for Laravel je balík výhradne pre vývoj — inštalujte ho do require-dev. Obsahuje asercie, základný test case, fixtures a Pest expectations. Nemá service provider, konfiguračný súbor ani migráciu a nič z neho nebeží v produkčnom kóde:

composer require --dev roundly-consulting/testing-for-laravel phpunit/phpunit:^13.0 --with-all-dependencies

Nová aplikácia na Laraveli 13 zamyká PHPUnit 12, kým Pest 5 potrebuje PHPUnit 13 — uvedením phpunit/phpunit:^13.0 spolu s --with-all-dependencies (-W) ho Composer môže presunúť. Projekt, ktorý už používa Pest 5, potrebuje len samotný balík.

Pest 5 a Laravel 13

• Balík vyžaduje pestphp/pest ^5.0 a orchestra/testbench ^11.0, takže beží na Laraveli 13 s PHPUnit 13.
• Laravel 12 a Pest 4 už podporované nie sú — kým vaša aplikácia nebude na Laraveli 13 a Peste 5, zostaňte na verzii 1.x.
• CI balíka beží na PHP 8.4, 8.5 a 8.6.

Pest expectations sa registrujú automaticky cez Pest plugin balíka (extra.pest.plugins), takže sú dostupné hneď po inštalácii. Ak má vaša testovacia sada vypnuté objavovanie pluginov, zaregistrujte ich explicitne v tests/Pest.php:

<?php

declare(strict_types=1);

use RoundlyConsulting\Testing\Expectations\Expectations;

uses(Tests\TestCase::class)->in('Arch', 'Feature', 'Unit');

Expectations::register(); // idempotent — a no-op if the Pest plugin already ran

Obe cesty môžu fungovať súčasne: Expectations::register() sa stráži interným príznakom, takže volanie po tom, ako už prebehol plugin, nič nerobí. Expectations::registered() vráti, či registrácia prebehla.

Rovnako ako vyššie naviažte na svoj TestCase aj adresár Arch. Viaceré kontroly čítajú spustenú aplikáciu — okrem iných swappableModelsAreNotFinal, toBeSwappableVia a toBeFakeable — a arch súbor bez TestCase žiadnu nemá; namiesto prázdneho úspechu zlyhajú s návodom.

Tri spôsoby volania

Asercie sú dostupné v troch štýloch. Uprednostnite Pest expectation — je to kanonické, zdokumentované API:

use RoundlyConsulting\Testing\Arch\ArchPresets;
use RoundlyConsulting\Testing\Assert;

// 1. Pest expectation — the canonical API
expect(database_path('migrations'))->toHaveRunnableMigrationOrder();

// 2. Static mirror — for plain PHPUnit test classes
Assert::migrationsRunInDependencyOrder(database_path('migrations'));

// 3. Arch preset — at the top level of a Pest arch file
ArchPresets::strictTypes('App');

Časti pre balíky a pre aplikácie

• Funguje v akejkoľvek Laravel aplikácii bez Testbench: statické Assert, všetky Pest expectations okrem dvoch strážcov publikovaných migrácií a ArchPresets. Vlastný arch test balíka vynucuje, že žiadna z týchto častí neodkazuje na Testbench.
• Len pre balíky: PackageTestCase, concerns LoadsProviderMigrations a UsesPublishSandbox a expectations toNotAutoLoadMigrations / toPublishMigrationsTimestamped — predpokladajú service provider balíka a Testbench.
• Potrebuje PHP s podporou forku a reálnu databázu: Concurrency\Racer — bez Testbench, takže ho použije každá Laravel aplikácia, ktorej testovacie pripojenie je pgsql alebo mysql.