Тестирование
Назначение и когда использовать
PHPUnit проверяет framework behavior, feature routes/controllers и regression docs. Держите тест рядом с feature, а общие тесты — в tests/.
Пошагово
composer test
./vendor/bin/phpunit --testsuite Features
./vendor/bin/phpunit --testsuite Global
composer cs
Пример unit-теста validator:
use Esora\Validation\Validator;
use PHPUnit\Framework\TestCase;
final class ValidatorTest extends TestCase
{
public function testValidatedIsAllowlisted(): void
{
$validator = new Validator(['name' => 'Ada', 'admin' => true], ['name' => 'required|string']);
self::assertTrue($validator->passes());
self::assertSame(['name' => 'Ada'], $validator->validated());
}
}
Проверяйте passes, fails, errors, 422 response, FormRequest authorization и route dispatch. Для docs проверяйте наличие каждого slug в DocsController::PAGES и файла markdown.
Lifecycle и troubleshooting
Composer script → PHPUnit discovery (app/Features/*/tests и tests) → assertions → exit code. composer cs запускает PHP-CS-Fixer dry-run. При class not found проверьте autoload и namespace; при stale feature route очистите cache; при style diff запустите composer cs:fix только после просмотра diff.