⚡ Esora Документация

Тестирование

Назначение и когда использовать

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.