Strategi Testing Laravel: Feature vs Unit Tests

Siri: Setiap Projek Laravel Perlu Ada Blok Asas Ini Bahagian: 32 daripada 35 Tahap: Pertengahan Prasyarat: Action Classes, Service Classes

Apa yang Anda Akan Pelajari

  • Tiga jenis ujian dan bila anda perlu guna setiap satunya
  • Ujian Feature untuk aliran HTTP dan interaksi pangkalan data
  • Ujian Unit untuk logik perniagaan tulen
  • Guna Fakes untuk mengasingkan ujian daripada perkhidmatan luar
  • Data ujian yang mengutamakan Factory
  • Menguji Policies dan Actions
  • Menjalankan suite ujian yang bermakna dengan cekap

Tiga Jenis Ujian

Laravel menyokong tiga jenis ujian, masing-masing dengan skop khusus:

Ujian Feature: Menguji kitaran penuh permintaan/respons HTTP. Ia membuat panggilan pangkalan data sebenar, melalui middleware, menjalankan pengesahan, dan sampai ke controller. Guna untuk mana-mana kod yang melibatkan HTTP.

Ujian Unit: Menguji satu kelas secara berasingan, tanpa pangkalan data atau HTTP. Pantas. Guna untuk Services, Actions, dan logik perniagaan tulen.

Ujian Policy: Menguji peraturan pengesahan akses. Ia subset ujian Feature atau Unit, tapi perlu disebut: setiap Policy layak dapat ujian sendiri.

Nisbah dalam projek-projek ini lebih kurang 80% ujian Feature, 20% ujian Unit. Aliran HTTP tempat bug bersembunyi; logik tulen lebih mudah disahkan dengan cepat.

Struktur Ujian Feature

// tests/Feature/Orders/CreateOrderTest.php

declare(strict_types=1);

namespace Tests\Feature\Orders;

use App\Events\OrderPlaced;
use App\Mail\OrderConfirmationMail;
use App\Models\Order;
use App\Models\Product;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Event;
use Illuminate\Support\Facades\Mail;
use Tests\TestCase;

final class CreateOrderTest extends TestCase
{
use RefreshDatabase;

public function test_authenticated_user_can_place_an_order(): void
{
// Arrange
Event::fake();
Mail::fake();

$user = User::factory()->create();
$product = Product::factory()->inStock()->create();

// Act
$response = $this->actingAs($user)
->postJson(route('api.v1.orders.store'), [
'product_id' => $product->id,
'quantity' => 2,
]);

// Assert — HTTP response
$response->assertStatus(201)
->assertJsonStructure([
'success',
'data' => ['id', 'total', 'status'],
]);

// Assert — Database state
$this->assertDatabaseHas('orders', [
'user_id' => $user->id,
'status' => 'pending',
]);

// Assert — Side effects
Event::assertDispatched(OrderPlaced::class);
Mail::assertQueued(OrderConfirmationMail::class);
}

public function test_guest_cannot_place_an_order(): void
{
$response = $this->postJson(route('api.v1.orders.store'), [
'product_id' => 1,
'quantity' => 1,
]);

$response->assertUnauthorized();
$this->assertDatabaseCount('orders', 0);
}

public function test_order_fails_validation_with_out_of_stock_product(): void
{
$user = User::factory()->create();
$product = Product::factory()->outOfStock()->create();

$response = $this->actingAs($user)
->postJson(route('api.v1.orders.store'), [
'product_id' => $product->id,
'quantity' => 1,
]);

$response->assertUnprocessable()
->assertJsonValidationErrors(['product_id']);
}
}

Corak AAA – Arrange, Act, Assert – dipakai untuk setiap ujian. Setiap ujian ada tepat satu Act (panggilan HTTP atau panggilan method). Semua sebelum itu ialah setup. Semua selepas itu ialah assertion.

Struktur Ujian Unit

// tests/Unit/Services/OrderServiceTest.php

declare(strict_types=1);

namespace Tests\Unit\Services;

use App\DTOs\OrderCustomerData;
use App\Enums\PaymentGateway;
use App\Services\Order\OrderService;
use App\Services\Stripe\StripePaymentServiceInterface;
use Mockery;
use Mockery\MockInterface;
use PHPUnit\Framework\TestCase;

final class OrderServiceTest extends TestCase
{
private MockInterface $stripe;
private OrderService $service;

protected function setUp(): void
{
parent::setUp();

$this->stripe = Mockery::mock(StripePaymentServiceInterface::class);
$this->service = new OrderService($this->stripe);
}

protected function tearDown(): void
{
Mockery::close();
parent::tearDown();
}

public function test_it_calculates_total_with_tax_correctly(): void
{
// Arrange
$items = collect([
['price' => 100_00, 'quantity' => 2], // $200.00
['price' => 50_00, 'quantity' => 1], // $50.00
]);

// Act
$total = $this->service->calculateTotal($items, taxRate: 0.10);

// Assert
$this->assertEquals(275_00, $total); // $250 + 10% = $275
}

public function test_it_creates_payment_intent_with_correct_amount(): void
{
// Arrange
$this->stripe
->shouldReceive('createPaymentIntent')
->once()
->with(275_00, 'usd')
->andReturn((object) ['id' => 'pi_test_123', 'client_secret' => 'secret']);

// Act
$intent = $this->service->initiatePayment(275_00);

// Assert
$this->assertEquals('pi_test_123', $intent->id);
}
}

Ujian Unit mewarisi PHPUnit\Framework\TestCase (bukan TestCase Laravel) – tiada boot framework, tiada pangkalan data, tiada HTTP. Ia laju: ratusan ujian sesaat.

Fakes — Menggantikan Perkhidmatan Luar

Jangan biar ujian menyentuh perkhidmatan luar sebenar. Laravel menyediakan Fakes untuk yang paling biasa:

// Email
Mail::fake();
Mail::assertSent(OrderConfirmationMail::class);
Mail::assertQueued(OrderConfirmationMail::class);
Mail::assertNotSent(OrderConfirmationMail::class);

// Events
Event::fake();
Event::assertDispatched(OrderPlaced::class);
Event::assertDispatched(OrderPlaced::class, function ($event): bool {
return $event->order->id === $this->order->id;
});
Event::assertNotDispatched(OrderCancelled::class);

// Jobs
Bus::fake();
Bus::assertDispatched(ProcessOrderInventory::class);
Bus::assertDispatchedTimes(SendNotification::class, 3);

// HTTP (for external API calls)
Http::fake([
'api.stripe.com/*' => Http::response(['id' => 'pi_test_123'], 200),
'api.name.com/*' => Http::response(['available' => true], 200),
]);

// Notifications
Notification::fake();
Notification::assertSentTo($user, ServiceRequestRejectedNotification::class);
Notification::assertNothingSentTo($user);

Factories — Satu-satunya Cara Untuk Menghasilkan Data Ujian

Setiap ujian yang menyentuh pangkalan data perlu guna Factories. Tiada DB::insert() manual, tiada panggilan seeder dalam ujian:

// ✅ Using factories
$user = User::factory()->create();
$admin = User::factory()->admin()->create();
$order = Order::factory()->for($user)->withItems(3)->create();

// ❌ Manual inserts (brittle, doesn't respect model logic)
DB::table('users')->insert([...]);

Takrifkan state untuk senario ujian yang biasa:

// database/factories/ProductFactory.php
public function definition(): array
{
return [
'name' => fake()->words(3, true),
'price' => fake()->numberBetween(1000, 50000), // in cents
'stock' => fake()->numberBetween(10, 100),
'is_active' => true,
];
}

public function outOfStock(): static
{
return $this->state(['stock' => 0]);
}

public function inStock(): static
{
return $this->state(['stock' => fake()->numberBetween(5, 100)]);
}

public function featured(): static
{
return $this->state(['is_featured' => true]);
}

Dalam ujian: Product::factory()->outOfStock()->create() mudah dibaca dan ekspresif.

Menguji Actions

Actions mudah diuji sebab ia ada satu method execute() atau handle():

final class CreateOrderActionTest extends TestCase
{
use RefreshDatabase;

public function test_it_creates_an_order_with_items(): void
{
// Arrange
Event::fake();

$user = User::factory()->create();
$items = CartItem::factory()->count(3)->for($user)->create();
$data = OrderCustomerData::fromArray([
'first_name' => 'John',
'last_name' => 'Doe',
'email' => 'john@example.com',
'payment_gateway' => 'stripe',
'payment_reference_id' => 'pi_test_123',
]);

// Act
$order = (new CreateOrderAction)->execute($user, $data, collect($items));

// Assert
$this->assertInstanceOf(Order::class, $order);
$this->assertEquals($user->id, $order->user_id);
$this->assertDatabaseCount('order_items', 3);
Event::assertDispatched(OrderPlaced::class);
}

public function test_it_rolls_back_on_payment_failure(): void
{
// ...
}
}

Menguji Policies

final class OrderPolicyTest extends TestCase
{
use RefreshDatabase;

public function test_user_can_view_their_own_order(): void
{
$user = User::factory()->create();
$order = Order::factory()->for($user)->create();

$this->assertTrue($user->can('view', $order));
}

public function test_user_cannot_view_another_users_order(): void
{
$user = User::factory()->create();
$other = User::factory()->create();
$order = Order::factory()->for($other)->create();

$this->assertFalse($user->can('view', $order));
}

public function test_admin_can_view_any_order(): void
{
$admin = Admin::factory()->create();
$order = Order::factory()->create();

$this->assertTrue($admin->can('viewAny', Order::class));
}
}

Menjalankan Ujian dengan Cekap

# All tests
php artisan test --compact

# All tests in parallel (much faster on multi-core machines)
php artisan test --compact --parallel

# Specific file
php artisan test --compact tests/Feature/Orders/CreateOrderTest.php

# Filter by test name
php artisan test --compact --filter=test_authenticated_user_can_place_an_order

# Specific test class
php artisan test --compact --filter=CreateOrderTest

Dalam CI, sentiasa jalankan –parallel. Secara tempatan, guna –filter untuk jalankan hanya apa yang relevan dengan perubahan anda sekarang.

FAQ

Patutkah anda menulis feature test atau unit test dalam Laravel? Kebanyakannya feature test – ia merangkumi routing, middleware, validation, dan DB dalam satu pusingan. Buat unit test untuk logik tulen (Actions, Services, DTOs) apabila pengasingan penting.

Apa yang anda TIDAK perlu uji? Rangka kerja. Jangan uji bahawa Eloquent menyimpan atau bahawa peraturan validation yang disertakan Laravel benar-benar berfungsi – uji peraturan ANDA, logik ANDA, edge case ANDA.

Poin Penting

  • Feature test untuk alir HTTP (80% daripada ujian). Unit test untuk logik tulen (20%).
  • Sentiasa gunakan RefreshDatabase dalam Feature test yang menulis ke pangkalan data.
  • Palsukan perkhidmatan luar ( Mail::fake() , Event::fake() , Bus::fake() , Http::fake() ) – jangan biarkan ujian menyentuh perkhidmatan sebenar.
  • Factory state ( outOfStock() , admin() , withItems() ) menjadikan ujian mudah dibaca dan ekspresif.
  • Uji setiap Policy secara eksplisit – logik pengesahan akses adalah kritikal dari segi keselamatan dan wajar mempunyai kelas ujian sendiri.
  • Gunakan –parallel dalam CI, dan –filter di mesin setempat untuk maklum balas pantas.

Tips dan Perangkap

⚠️ Amaran: RefreshDatabase membuang dan mencipta semula skema pangkalan data pada setiap pusingan ujian. Untuk set ujian yang besar, ini perlahan. Gunakan LazilyRefreshDatabase sebagai gantinya — ia hanya menyegarkan pangkalan data jika ujian benar-benar menyentuhnya, sekali gus memangkas masa migrasi dengan ketara. 💡 Tips: Namakan kaedah ujian sebagai ayat: test_authenticated_user_can_place_an_order. Apabila ujian gagal dalam CI, nama ujian dalam output memberitahu anda dengan tepat apa yang rosak tanpa perlu membuka fail. testOrder() tidak memberitahu apa-apa. 🔥 Nota Pakar: Nisbah yang menjadi ukuran bukan “berapa banyak ujian”, tetapi “berapa banyak tingkah laku yang diliputi.” Sepuluh Feature test yang ditulis dengan baik dan meliputi laluan pengguna kritikal lebih bernilai daripada 100 unit test pada helper dalaman. Uji apa yang pengguna lakukan, bukan bagaimana kod berfungsi.

Bacaan Lanjut

  • Dokumen Laravel: Ujian
  • Dokumen Laravel: Ujian HTTP
  • Dokumen Laravel: Ujian Pangkalan Data
  • Dokumen PHPUnit
  • Dokumen Laravel: Mocking

← Git Hooks | Seterusnya: API Resources →


Sumber Rujukan:

  • Artikel asal: Dev.to PHP
  • Diterjemah daripada artikel asal ke Bahasa Melayu oleh AI Editorial – haqis.com
Comments

Similar Posts