كيف تختبر تطبيقات Laravel؟

Question

Accepted Answer

توفر Laravel دعماً استثنائياً مدمجاً للاختبار (يعتمد على PHPUnit، مع خيار Pest الحديث) بالإضافة إلى مساعدات خاصة بالاختبار — قاعدة بيانات اختبار، اختبار HTTP، مساعدات المصادقة، والمحاكيات — مما يجعل التطبيقات قابلة للاختبار بدرجة عالية. يتم تقسيم الاختبارات إلى اختبارات الميزات (تدفق الطلب الكامل) واختبارات الوحدة (المنطق المعزول).

## اختبارات الميزات — اختبر تدفق الطلب الكامل

```php
class UserTest extends TestCase {
    use RefreshDatabase;            // fresh, migrated test database per test (isolated)

public function test_can_create_user(): void {
        $response = $this->postJson('/api/users', [    // make a real request to the app
            'name' => 'Ann', 'email' => 'ann@x.com',
        ]);
        $response->assertStatus(201)
                 ->assertJson(['name' => 'Ann']);       // assert the response
        $this->assertDatabaseHas('users', ['email' => 'ann@x.com']);   // assert the DB
    }
}
```

**اختبارات الميزات** تمارس المكدس الكامل (التوجيه، middleware، التحقق، controller، قاعدة البيانات) بإرسال طلبات HTTP باستخدام مساعدات مثل `get`/`postJson`، ثم التأكد من الاستجابة وحالة قاعدة البيانات (`assertDatabaseHas`). هذا يتحقق من السلوك الفعلي للتطبيق.

## مساعدات الاختبار تجعل Laravel قابلة للاختبار بدرجة عالية

```php
$this->actingAs($user)->get('/dashboard');         // authenticate as a user
User::factory()->count(10)->create();               // generate test data via factories

Mail::fake(); Mail::assertSent(WelcomeEmail::class);   // assert mail without sending
Queue::fake(); Queue::assertPushed(ProcessJob::class); // assert jobs queued, don't run them
Event::fake(); Storage::fake('s3');                    // fake events, storage, etc.
Http::fake();                                           // fake external HTTP calls
```

**محاكيات** Laravel (`Mail::fake()`, `Queue::fake()`, `Http::fake()`، إلخ) تسمح لك بالتأكد من أن رسائل البريد الإلكتروني تم إرسالها أو تم إدراج الوظائف في قائمة الانتظار أو تم إجراء استدعاءات HTTP — *بدون* فعلياً تنفيذها، مما يتيح اختبارات سريعة وعازلة وحتمية. مساعدات `actingAs` والمصنع تجعل إعداد سيناريوهات الاختبار المصادقة والغنية بالبيانات سهلة.

## اختبارات الوحدة و Pest

```php
// unit test — isolated logic, no framework/DB
public function test_discount_calculation(): void {
    $this->assertEquals(90, (new Cart)->applyDiscount(100, 10));
}

// Pest — a modern, expressive testing syntax on top of PHPUnit (popular in Laravel)
it('creates a user', fn() => post('/users', [...])->assertCreated());
```

## لماذا يهم

الاختبار ضروري للتطبيقات الموثوقة، ودعم Laravel الممتاز المدمج للاختبار — مع مساعدات التطبيقات الويب التي تجعل التطبيقات قابلة للاختبار بشكل ملحوظ — يعني أن فهم كيفية الاختبار مهم سواء لجودة الكود أو كتوقع مهني. **اختبارات الميزات** قيّمة بشكل خاص: بإرسال طلبات HTTP حقيقية إلى التطبيق والتأكد من الاستجابات وحالة قاعدة البيانات (مع السمة `RefreshDatabase` توفر قاعدة بيانات اختبار معزولة)، فإنها تتحقق من أن تدفق الطلب بالكامل (التوجيه، middleware، التحقق، controllers، الاستمرار) يعمل بشكل صحيح معاً — اختبار السلوك الفعلي كما يختبره المستخدمون.

**مساعدات الاختبار والمحاكيات** في Laravel هي ما تجعل هذا عملياً: `actingAs` للمصادقة، **المصانع** لإنشاء بيانات الاختبار، والأهم من ذلك **المحاكيات** (`Mail::fake()`, `Queue::fake()`, `Http::fake()`, `Event::fake()`) التي تسمح لك بالتأكد من حدوث الآثار الجانبية (رسائل بريد إرسالها، وظائف في قائمة الانتظار، استدعاءات خارجية تمت) *بدون* فعلياً تنفيذها — مما يتيح اختبارات سريعة وعازلة وحتمية للسلوك المعقد.

فهم اختبارات الميزات مقابل اختبارات الوحدة، ومساعدات الاختبار والمحاكيات، والمصانع للبيانات، وخيار Pest الحديث يغطي النطاق العملي لاختبار Laravel بفعالية.

بما أن Laravel توفر أدوات اختبار قوية وتطبيق ويب، وبما أن التطبيقات المختبرة جيداً تكتشف الانحدار وتمكّن إعادة الهيكلة الواثقة، فإن معرفة كيفية الاستفادة من دعم اختبار Laravel — خاصة اختبارات الميزات ومساعدات الزيف/المصنع — هي معرفة مستوى أعلى مهمة تميز المطورين الذين يبنون تطبيقات قوية وقابلة للصيانة من أولئك الذين يشحنون كود غير مختبر وهش، مما يعكس ممارسة الهندسة المهنية.