Laravel TDD Workflow

Освойте тестирование Laravel с навыком Laravel TDD Workflow для Claude Code. Реализует PHPUnit, Pest и покрытие 80%+ для высококачественной PHP-разработки.

Безопасность и тестирование ★ 172,010 GitHub (172,010 ★)

Навык Laravel TDD Workflow предоставляет Claude специализированные знания для выполнения строгого цикла «Красный-Зелёный-Рефакторинг» в экосистеме Laravel. Он даёт экспертные рекомендации по структурированию модульных, функциональных и интеграционных тестов, используя мощные инструменты тестирования Laravel: фабрики Eloquent, подделки сервисов и стратегии изоляции базы данных. Строите ли вы новые API-эндпоинты, рефакторите сложную бизнес-логику или обеспечиваете безопасную аутентификацию с Sanctum — этот навык помогает поддерживать детерминированную кодовую базу с целевым уровнем покрытия тестами 80% и выше.

Ключевые возможности

01Комплексное мокинго для очередей, почты и внешних HTTP-сервисов

02Продвинутое тестирование базы данных с использованием RefreshDatabase и фабрик

03Поддержка двух фреймворков тестирования: Pest и PHPUnit

04Специализированные помощники для тестирования Laravel Sanctum и Inertia.js

05Автоматизированная реализация цикла TDD «Красный-Зелёный-Рефакторинг»

06172 010 звёзд на GitHub

Примеры использования

01Рефакторинг устаревших моделей Eloquent с сохранением функциональной целостности через модульные тесты

02Создание новых API-эндпоинтов с валидированной формой запроса/ответа и авторизацией

03Достижение высоких показателей покрытия тестами для готовых к продакшену CI/CD-пайплайнов

name	laravel-tdd
description	Test-driven development for Laravel with PHPUnit and Pest, factories, database testing, fakes, and coverage targets.
origin	ECC

Laravel TDD Workflow

Test-driven development for Laravel applications using PHPUnit and Pest with 80%+ coverage (unit + feature).

When to Use

New features or endpoints in Laravel
Bug fixes or refactors
Testing Eloquent models, policies, jobs, and notifications
Prefer Pest for new tests unless the project already standardizes on PHPUnit

How It Works

Red-Green-Refactor Cycle

Write a failing test
Implement the minimal change to pass
Refactor while keeping tests green

Test Layers

Unit: pure PHP classes, value objects, services
Feature: HTTP endpoints, auth, validation, policies
Integration: database + queue + external boundaries

Choose layers based on scope:

Use Unit tests for pure business logic and services.
Use Feature tests for HTTP, auth, validation, and response shape.
Use Integration tests when validating DB/queues/external services together.

Database Strategy

RefreshDatabase for most feature/integration tests (runs migrations once per test run, then wraps each test in a transaction when supported; in-memory databases may re-migrate per test)
DatabaseTransactions when the schema is already migrated and you only need per-test rollback
DatabaseMigrations when you need a full migrate/fresh for every test and can afford the cost

Use RefreshDatabase as the default for tests that touch the database: for databases with transaction support, it runs migrations once per test run (via a static flag) and wraps each test in a transaction; for :memory: SQLite or connections without transactions, it migrates before each test. Use DatabaseTransactions when the schema is already migrated and you only need per-test rollbacks.

Testing Framework Choice

Default to Pest for new tests when available.
Use PHPUnit only if the project already standardizes on it or requires PHPUnit-specific tooling.

Examples

PHPUnit Example

use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

final class ProjectControllerTest extends TestCase
{
    use RefreshDatabase;

    public function test_owner_can_create_project(): void
    {
        $user = User::factory()->create();

        $response = $this->actingAs($user)->postJson('/api/projects', [
            'name' => 'New Project',
        ]);

        $response->assertCreated();
        $this->assertDatabaseHas('projects', ['name' => 'New Project']);
    }
}

Feature Test Example (HTTP Layer)

use App\Models\Project;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

final class ProjectIndexTest extends TestCase
{
    use RefreshDatabase;

    public function test_projects_index_returns_paginated_results(): void
    {
        $user = User::factory()->create();
        Project::factory()->count(3)->for($user)->create();

        $response = $this->actingAs($user)->getJson('/api/projects');

        $response->assertOk();
        $response->assertJsonStructure(['success', 'data', 'error', 'meta']);
    }
}

Pest Example

use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;

use function Pest\Laravel\actingAs;
use function Pest\Laravel\assertDatabaseHas;

uses(RefreshDatabase::class);

test('owner can create project', function () {
    $user = User::factory()->create();

    $response = actingAs($user)->postJson('/api/projects', [
        'name' => 'New Project',
    ]);

    $response->assertCreated();
    assertDatabaseHas('projects', ['name' => 'New Project']);
});

Feature Test Pest Example (HTTP Layer)

use App\Models\Project;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;

use function Pest\Laravel\actingAs;

uses(RefreshDatabase::class);

test('projects index returns paginated results', function () {
    $user = User::factory()->create();
    Project::factory()->count(3)->for($user)->create();

    $response = actingAs($user)->getJson('/api/projects');

    $response->assertOk();
    $response->assertJsonStructure(['success', 'data', 'error', 'meta']);
});

Factories and States

Use factories for test data
Define states for edge cases (archived, admin, trial)

$user = User::factory()->state(['role' => 'admin'])->create();

Database Testing

Use RefreshDatabase for clean state
Keep tests isolated and deterministic
Prefer assertDatabaseHas over manual queries

Persistence Test Example

use App\Models\Project;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

final class ProjectRepositoryTest extends TestCase
{
    use RefreshDatabase;

    public function test_project_can_be_retrieved_by_slug(): void
    {
        $project = Project::factory()->create(['slug' => 'alpha']);

        $found = Project::query()->where('slug', 'alpha')->firstOrFail();

        $this->assertSame($project->id, $found->id);
    }
}

Fakes for Side Effects

Bus::fake() for jobs
Queue::fake() for queued work
Mail::fake() and Notification::fake() for notifications
Event::fake() for domain events

use Illuminate\Support\Facades\Queue;

Queue::fake();

dispatch(new SendOrderConfirmation($order->id));

Queue::assertPushed(SendOrderConfirmation::class);

use Illuminate\Support\Facades\Notification;

Notification::fake();

$user->notify(new InvoiceReady($invoice));

Notification::assertSentTo($user, InvoiceReady::class);

Auth Testing (Sanctum)

use Laravel\Sanctum\Sanctum;

Sanctum::actingAs($user);

$response = $this->getJson('/api/projects');
$response->assertOk();

HTTP and External Services

Use Http::fake() to isolate external APIs
Assert outbound payloads with Http::assertSent()

Coverage Targets

Enforce 80%+ coverage for unit + feature tests
Use pcov or XDEBUG_MODE=coverage in CI

Test Commands

php artisan test
vendor/bin/phpunit
vendor/bin/pest

Test Configuration

Use phpunit.xml to set DB_CONNECTION=sqlite and DB_DATABASE=:memory: for fast tests
Keep separate env for tests to avoid touching dev/prod data

Authorization Tests

use Illuminate\Support\Facades\Gate;

$this->assertTrue(Gate::forUser($user)->allows('update', $project));
$this->assertFalse(Gate::forUser($otherUser)->allows('update', $project));

Inertia Feature Tests

When using Inertia.js, assert on the component name and props with the Inertia testing helpers.

use App\Models\User;
use Inertia\Testing\AssertableInertia;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

final class DashboardInertiaTest extends TestCase
{
    use RefreshDatabase;

    public function test_dashboard_inertia_props(): void
    {
        $user = User::factory()->create();

        $response = $this->actingAs($user)->get('/dashboard');

        $response->assertOk();
        $response->assertInertia(fn (AssertableInertia $page) => $page
            ->component('Dashboard')
            ->where('user.id', $user->id)
            ->has('projects')
        );
    }
}

Prefer assertInertia over raw JSON assertions to keep tests aligned with Inertia responses.

Laravel TDD Workflow — что это 🧪

Этот навык задаёт стандартный workflow для разработки через тестирование (TDD) в Laravel-приложениях. Он подходит для команд, использующих PHPUnit или Pest, и нацелен на покрытие 80%+ (unit + feature). Описанные приёмы покрывают все основные сценарии: от тестирования Eloquent-моделей и политик до проверки внешних HTTP-сервисов и Inertia.js-страниц.

Навык подходит для:

Разработчиков, внедряющих TDD в Laravel-проекты
Команд, желающих стандартизировать подходы к тестам
Ситуаций, когда нужно быстро разобраться с Red-Green-Refactor циклами, фикстурами, фабриками и моками

Как работает ⚙️

Цикл Red-Green-Refactor

Red — напиши тест, который падает
Green — реализуй минимальный код, чтобы тест прошёл
Refactor — улучши код, не ломая тестов

Уровни тестирования 📊

Unit — чистая бизнес-логика: value objects, сервисы, хелперы
Feature — HTTP-эндпоинты, аутентификация, валидация, политики
Integration — связки: база + очередь + внешние сервисы

Выбор уровня зависит от проверяемого сценария:

Чистая логика → Unit
HTTP и права доступа → Feature
Сквозные сценарии с БД/очередями → Integration

Стратегия работы с базой данных 🗄️

RefreshDatabase — дефолтный выбор для Feature и Integration тестов. Миграции выполняются один раз за сессию, каждый тест оборачивается в транзакцию (если БД поддерживает). Для in-memory SQLite миграции бегут перед каждым тестом
DatabaseTransactions — когда схема уже накатана, нужен только rollback
DatabaseMigrations — если требуется полная переустановка схемы каждый раз (долго)

Выбор фреймворка 🎯

Для новых тестов — Pest (более лаконичный синтаксис)
PHPUnit — только если проект уже на нём стандартизирован, или нужна специфичная тулза

Примеры тестов

PHPUnit (Feature): тест владельца, создающего проект

$user = User::factory()->create();
$response = $this->actingAs($user)->postJson('/api/projects', ['name' => 'New Project']);
$response->assertCreated();
$this->assertDatabaseHas('projects', ['name' => 'New Project']);

Pest (Feature): тот же сценарий, гибче синтаксис

test('owner can create project', function () {
    $user = User::factory()->create();
    $response = actingAs($user)->postJson('/api/projects', ['name' => 'New Project']);
    $response->assertCreated();
    assertDatabaseHas('projects', ['name' => 'New Project']);
});

Фабрики и состояния 🔧

Используй фабрики с состояниями для граничных случаев:

$user = User::factory()->state(['role' => 'admin'])->create();

Это удобно для ролей (archived, admin, trial).

Фейки для побочных эффектов 🎭

Bus::fake() — для джобов
Queue::fake() — для очередей
Mail::fake() и Notification::fake() — для почты и уведомлений
Event::fake() — для доменных событий

Пример проверки очереди:

Queue::fake();
dispatch(new SendOrderConfirmation($order->id));
Queue::assertPushed(SendOrderConfirmation::class);

Пример проверки уведомления:

Notification::fake();
$user->notify(new InvoiceReady($invoice));
Notification::assertSentTo($user, InvoiceReady::class);

Тестирование аутентификации (Sanctum) 🔐

Sanctum::actingAs($user);
$response = $this->getJson('/api/projects');
$response->assertOk();

Внешние HTTP-сервисы 🌐

Используй Http::fake() и Http::assertSent() для изоляции и проверки исходящих запросов.

Тестирование авторизации ✋

Проверяй политики через Gate:

$this->assertTrue(Gate::forUser($user)->allows('update', $project));
$this->assertFalse(Gate::forUser($otherUser)->allows('update', $project));

Inertia.js тесты 🖼️

Для приложений с Inertia используй хелпер assertInertia, проверяя имя компонента и пропсы:

$response->assertInertia(fn (AssertableInertia $page) =>
    $page->component('Dashboard')
         ->where('user.id', $user->id)
         ->has('projects')
);

Команды для запуска

php artisan test
vendor/bin/phpunit
vendor/bin/pest

Конфигурация phpunit.xml 🛠️

Настрой DB_CONNECTION=sqlite и DB_DATABASE=:memory: для быстрых тестов. Используй отдельное окружение для тестов, чтобы не затронуть dev/prod данные.

Когда использовать ✅

Разработка новой фичи или эндпоинта
Исправление бага или рефакторинг
Тестирование моделей, политик, джобов и уведомлений
Интеграция с внешними API
Inertia-страницы

Важно знать ⚠️

Цель — 80%+ покрытия (unit + feature)
Для сбора покрытия используй pcov или XDEBUG_MODE=coverage в CI
Предпочитай assertDatabaseHas вместо ручных запросов к БД
В Feature-тестах используй actingAs (Pest) или ActingAs (PHPUnit) для аутентификации
При наличии транзакций RefreshDatabase выполняется с минимальными накладными расходами

Установка одной командой.

npx skillfish add affaan-m/everything-claude-code laravel-tdd

Источник: https://mcpmarket.com/tools/skills/laravel-tdd-workflow-2

Ключевые возможности

Примеры использования

Laravel TDD Workflow

When to Use

How It Works

Red-Green-Refactor Cycle

Test Layers

Database Strategy

Testing Framework Choice

Examples

PHPUnit Example

Feature Test Example (HTTP Layer)

Pest Example

Feature Test Pest Example (HTTP Layer)

Factories and States

Database Testing

Persistence Test Example

Fakes for Side Effects

Auth Testing (Sanctum)

HTTP and External Services

Coverage Targets

Test Commands

Test Configuration

Authorization Tests

Inertia Feature Tests

Laravel TDD Workflow — что это 🧪

Как работает ⚙️

Цикл Red-Green-Refactor

Уровни тестирования 📊

Стратегия работы с базой данных 🗄️

Выбор фреймворка 🎯

Примеры тестов

Фабрики и состояния 🔧

Фейки для побочных эффектов 🎭

Тестирование аутентификации (Sanctum) 🔐

Внешние HTTP-сервисы 🌐

Тестирование авторизации ✋

Inertia.js тесты 🖼️

Команды для запуска

Конфигурация phpunit.xml 🛠️

Когда использовать ✅

Важно знать ⚠️

Поддерживает ли этот навык фреймворк для тестирования Pest?

Могу ли я использовать это для тестирования аутентифицированных API-маршрутов?

Совместим ли он с приложениями на Inertia.js?

Как он управляет состоянием базы данных во время тестов?

Какой уровень покрытия кода является целевым для этого навыка?

Комментарии