Laravel TDD Workflow

Освойте TDD в Laravel с помощью этого навыка для Claude Code. Автоматизируйте тесты PHPUnit и Pest, проверки базы данных и моки для высококачественных Laravel-приложений.

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

Навык Laravel TDD Workflow предоставляет Claude строгую структуру для создания надёжных PHP-приложений. Он реализует цикл «Красный-Зелёный-Рефакторинг» и предлагает специализированные рекомендации по модульному, функциональному и интеграционному тестированию в экосистеме Laravel. Используя фабрики, трейты базы данных, такие как RefreshDatabase, и всестороннее имитирование событий, почты и очередей, этот навык помогает разработчикам достичь высокого покрытия кода и поддерживаемой логики для API, интерфейсов Inertia.js и серверных служб.

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

01Продвинутые стратегии тестирования баз данных и управления состоянием

02172 009 звёзд на GitHub

03Стандартизированный рабочий процесс «Красный-Зелёный-Рефакторинг» для Laravel

04Всесторонняя поддержка фреймворков Pest и PHPUnit

05Специализированные помощники тестирования Inertia.js для проверок внешнего интерфейса

06Полные возможности имитации для Mail, Notifications, Jobs и HTTP

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

01Рефакторинг устаревших моделей и сервисов Eloquent при обеспечении покрытия от 80%

02Разработка новых конечных точек API со встроенными тестами валидации и авторизации

03Проверка сложных интеграций с внешними API и фоновыми обработчиками

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

Laravel TDD İş Akışı

80%+ kapsam (unit + feature) ile Laravel uygulamaları için test-driven development.

Ne Zaman Kullanılır

Laravel'de yeni özellikler veya endpoint'ler
Bug düzeltmeleri veya refactoring'ler
Eloquent model'leri, policy'leri, job'ları ve notification'ları test etme
Proje zaten PHPUnit'te standartlaşmamışsa yeni testler için Pest'i tercih edin

Nasıl Çalışır

Red-Green-Refactor Döngüsü

Başarısız bir test yazın
Geçmek için minimal değişiklik uygulayın
Testleri yeşil tutarken refactor edin

Test Katmanları

Unit: saf PHP sınıfları, value object'leri, servisler
Feature: HTTP endpoint'leri, auth, validation, policy'ler
Integration: database + kuyruk + harici sınırlar

Kapsama göre katmanları seçin:

Saf iş mantığı ve servisler için Unit testleri kullanın.
HTTP, auth, validation ve yanıt şekli için Feature testleri kullanın.
DB/kuyruklar/harici servisleri birlikte doğrularken Integration testleri kullanın.

Database Stratejisi

Çoğu feature/integration testi için RefreshDatabase (test run'ı başına bir kez migration'ları çalıştırır, ardından desteklendiğinde her testi bir transaction'a sarar; in-memory veritabanları test başına yeniden migrate edebilir)
Şema zaten migrate edilmişse ve sadece test başına rollback'e ihtiyacınız varsa DatabaseTransactions
Her test için tam bir migrate/fresh'e ihtiyacınız varsa ve maliyetini karşılayabiliyorsanız DatabaseMigrations

Veritabanına dokunan testler için varsayılan olarak RefreshDatabase kullanın: transaction desteği olan veritabanları için, test run'ı başına bir kez (static bir bayrak aracılığıyla) migration'ları çalıştırır ve her testi bir transaction'a sarar; :memory: SQLite veya transaction'sız bağlantılar için her testten önce migrate eder. Şema zaten migrate edilmişse ve sadece test başına rollback'lere ihtiyacınız varsa DatabaseTransactions kullanın.

Test Framework Seçimi

Mevcut olduğunda yeni testler için varsayılan olarak Pest kullanın.
Proje zaten PHPUnit'te standartlaşmışsa veya PHPUnit'e ��zgü araçlar gerektiriyorsa sadece PHPUnit kullanın.

Örnekler

PHPUnit Örneği

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 Örneği (HTTP Katmanı)

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 Örneği

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 Örneği (HTTP Katmanı)

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']);
});

Factory'ler ve State'ler

Test verileri için factory'leri kullanın
Uç durumlar için state'leri tanımlayın (archived, admin, trial)

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

Database Testi

Temiz durum için RefreshDatabase kullanın
Testleri izole ve deterministik tutun
Manuel sorgular yerine assertDatabaseHas tercih edin

Persistence Test Örneği

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);
    }
}

Yan Etkiler için Fake'ler

Job'lar için Bus::fake()
Kuyruğa alınmış işler için Queue::fake()
Bildirimler için Mail::fake() ve Notification::fake()
Domain event'leri için Event::fake()

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 Testi (Sanctum)

use Laravel\Sanctum\Sanctum;

Sanctum::actingAs($user);

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

HTTP ve Harici Servisler

Harici API'leri izole etmek için Http::fake() kullanın
Giden payload'ları Http::assertSent() ile doğrulayın

Kapsam Hedefleri

Unit + feature testleri için 80%+ kapsam zorlayın
CI'da pcov veya XDEBUG_MODE=coverage kullanın

Test Komutları

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

Test Yapılandırması

Hızlı testler için phpunit.xml'de DB_CONNECTION=sqlite ve DB_DATABASE=:memory: ayarlayın
Dev/prod verilerine dokunmaktan kaçınmak için testler için ayrı env tutun

Yetkilendirme Testleri

use Illuminate\Support\Facades\Gate;

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

Inertia Feature Testleri

Inertia.js kullanırken, Inertia test yardımcıları ile component ismi ve prop'ları doğrulayın.

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')
        );
    }
}

Testleri Inertia yanıtlarıyla uyumlu tutmak için ham JSON assertion'ları yerine assertInertia tercih edin.

🧪 Что это

Laravel TDD Workflow — это набор практик и соглашений для тестирования Laravel-приложений в стиле Test-Driven Development (TDD). Skill охватывает полный цикл: от выбора фреймворка (PHPUnit или Pest) до настройки базы данных, фабрик, фейков и измерения покрытия. Цель — довести покрытие unit + feature тестов до 80%+ и сделать тесты быстрыми, изолированными и детерминированными.

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

🔁 Red-Green-Refactor

Классический TDD-цикл:

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

🧩 Тестовые слои

Unit — тестирование чистых PHP-классов, value object'ов, сервисов без зависимостей от Laravel.
Feature — проверка HTTP-эндпоинтов, аутентификации, валидации, политик доступа.
Integration — тесты, затрагивающие базу данных, очереди и внешние сервисы одновременно.

Выбор слоя зависит от того, что проверяется:

Чистая бизнес-логика → Unit.
HTTP, auth, ответы → Feature.
Связка DB + очередь + внешний API → Integration.

🗄️ Стратегия работы с БД

Skill рекомендует три трейта для управления миграциями:

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

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

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

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

Для генерации тестовых данных используются Eloquent factories. Для граничных случаев определяются states:

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

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

Чтобы изолировать тесты от реальных сервисов, применяются Laravel-фасады:

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

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

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

🔐 Аутентификация (Sanctum)

Для тестирования API с Sanctum:

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

🧾 Inertia-тесты

Если фронтенд использует Inertia.js, вместо сырых JSON-ассертов применяется assertInertia:

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

📊 Покрытие кода

Цель: 80%+ для unit + feature тестов.
В CI используется pcov или XDEBUG_MODE=coverage.

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

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

⚙️ Конфигурация

В phpunit.xml можно задать DB_CONNECTION=sqlite и DB_DATABASE=:memory: для ускорения тестов.
Для тестов рекомендуется отдельный .env-файл, чтобы не задеть реальные данные.

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

При разработке новых фич или эндпоинтов в Laravel.
При исправлении багов или рефакторинге — чтобы убедиться, что ничего не сломалось.
Для тестирования Eloquent-моделей, политик, джобов, нотификаций.
Если проект ещё не стандартизирован на PHPUnit — начинать с Pest.

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

Не используйте assertDatabaseHas для ручных SQL-запросов — предпочитайте встроенные ассерты.
Тесты должны быть изолированы и детерминированы — никакой зависимости от порядка выполнения.
Для быстрых тестов используйте in-memory SQLite, но помните: некоторые фичи (например, JSON-поля) могут вести себя иначе, чем в PostgreSQL/MySQL.
Не злоупотребляйте DatabaseMigrations — это замедляет прогон; RefreshDatabase почти всегда достаточно.

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

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

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