Налаштування тестового середовища для веб-проекту

Настройка тестового окруження для веб-проектів

Тестове окруження — ізольована середа з власною базою даних, конфігурацією та станом. Без правильної настройки тести стають нестабільними, повільними та впливають один на одного.

Шари тестового окруження

Unit tests     → In-memory / моки → нема зовнішніх залежностей
Integration    → Тестова БД (SQLite або Docker PostgreSQL)
E2E / Browser  → Staging-окруження або локальний Docker Compose
Load tests     → Dedicated staging (ізольована від основної)

Docker Compose для тестового окруження

# docker-compose.test.yml
services:
  app:
    build:
      context: .
      target: test
    environment:
      APP_ENV: testing
      DB_HOST: db
      DB_DATABASE: testdb
      REDIS_HOST: redis
      QUEUE_CONNECTION: sync    # черги синхронно в тестах
      MAIL_MAILER: array        # перехоплення листів в масив
      CACHE_DRIVER: array       # кеш в пам'яті
    depends_on:
      db: { condition: service_healthy }
      redis: { condition: service_healthy }

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: testdb
      POSTGRES_USER: test
      POSTGRES_PASSWORD: test
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U test"]
      interval: 5s
      timeout: 3s
      retries: 5
    tmpfs:
      - /var/lib/postgresql/data   # БД в RAM — швидше

  redis:
    image: redis:7-alpine
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s

Конфігурація Laravel для тестів

// phpunit.xml
<php>
    <env name="APP_ENV"          value="testing"/>
    <env name="DB_CONNECTION"    value="sqlite"/>
    <env name="DB_DATABASE"      value=":memory:"/>
    <env name="CACHE_DRIVER"     value="array"/>
    <env name="SESSION_DRIVER"   value="array"/>
    <env name="QUEUE_CONNECTION" value="sync"/>
    <env name="MAIL_MAILER"      value="array"/>
</php>

// Базовий TestCase з транзакціями
abstract class TestCase extends BaseTestCase
{
    use RefreshDatabase;  // відкат БД після кожного тесту

    protected function setUp(): void
    {
        parent::setUp();
        $this->withoutVite();  // не запускати Vite в тестах
        $this->seed(TestDatabaseSeeder::class);
    }
}

Ізоляція тестів

Транзакції (швидко, але не для тестів з HTTP-клієнтом):

// DatabaseTransactions trait — відкат після кожного тесту
use DatabaseTransactions;

Міграції (повільніше, але надійніше):

// RefreshDatabase trait — пересоздати БД перед кожним тестом
use RefreshDatabase;

Моки зовнішніх сервісів:

// Не робити реальних HTTP-запитів в тестах
Http::fake([
    'api.stripe.com/*'  => Http::response(['id' => 'pi_test_123'], 200),
    'api.sendgrid.com/*' => Http::response(['message_id' => 'test'], 202),
    '*'                 => Http::response(['error' => 'Unexpected request'], 500),
]);

// Перехоплення email
Mail::fake();
// Перевірка
Mail::assertSent(OrderConfirmationMail::class, fn($mail) =>
    $mail->hasTo('[email protected]')
);

Фабрики тестових даних

// database/factories/UserFactory.php
class UserFactory extends Factory
{
    public function definition(): array
    {
        return [
            'name'              => $this->faker->name(),
            'email'             => $this->faker->unique()->safeEmail(),
            'email_verified_at' => now(),
            'password'          => Hash::make('password'),
        ];
    }

    public function admin(): static
    {
        return $this->afterCreating(fn(User $user) =>
            $user->assignRole('admin')
        );
    }

    public function unverified(): static
    {
        return $this->state(['email_verified_at' => null]);
    }
}

// Використання в тестах
$user = User::factory()->admin()->create();
$users = User::factory()->count(10)->create();

CI/CD — GitHub Actions

name: Tests

on: [push, pull_request]

jobs:
  unit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: shivammathur/setup-php@v2
        with: { php-version: '8.3', extensions: 'sqlite3' }
      - run: composer install --no-interaction
      - run: php artisan test --parallel --testsuite=Unit

  integration:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_DB: testdb
          POSTGRES_PASSWORD: test
        ports: ['5432:5432']
        options: --health-cmd pg_isready --health-interval 5s
    env:
      DB_CONNECTION: pgsql
      DB_HOST: localhost
      DB_DATABASE: testdb
      DB_PASSWORD: test
    steps:
      - uses: actions/checkout@v4
      - run: composer install
      - run: php artisan test --testsuite=Feature

Test Database Seeder

class TestDatabaseSeeder extends Seeder
{
    public function run(): void
    {
        // Мінімальний набір даних для тестів
        Role::create(['name' => 'admin']);
        Role::create(['name' => 'user']);

        Category::factory(5)->create();
        Product::factory(20)->create();
    }
}

Строк реалізації

Настройка тестового окруження з нуля (Docker + CI + фабрики): 3–5 днів.