كيف تختبر كود PHP باستخدام PHPUnit؟

Question

Accepted Answer

**PHPUnit** هو إطار عمل الاختبار القياسي لـ PHP — يُستخدم لكتابة اختبارات الوحدة والاختبارات المتكاملة التي تتحقق من أن الكود يتصرف بشكل صحيح. عند دمجه مع حقن التبعيات (لـ mocking) والأدوات مثل مزودي البيانات، فإنه يمكّن من الاختبار الشامل والقابل للصيانة.

## اختبار أساسي

```php
<?php
use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase {
    public function testAdd(): void {
        $calc = new Calculator();
        $result = $calc->add(2, 3);
        $this->assertEquals(5, $result);          // assertion
        $this->assertIsInt($result);
    }

public function testDivideByZeroThrows(): void {
        $this->expectException(DivisionByZeroError::class);   // assert it throws
        (new Calculator())->divide(1, 0);
    }
}
// run with: ./vendor/bin/phpunit
```

توسع فئات الاختبار `TestCase`، وتبدأ طرق الاختبار بـ `test` (أو استخدم السمة `#[Test]`)، وتستخدم طرق `assert*` للتحقق من التوقعات (`assertEquals`، `assertTrue`، `assertCount`، إلخ.). يختبر `expectException` مسارات الخطأ.

## وضع الكائنات الوهمية للتبعيات (العزل عبر DI)

```php
public function testSendsWelcomeEmail(): void {
    // create a MOCK of a dependency — no real mailer needed
    $mailer = $this->createMock(MailerInterface::class);
    $mailer->expects($this->once())          // assert it's called exactly once
           ->method('send')
           ->with('ann@x.com', $this->stringContains('Welcome'));

$service = new UserService($mailer);     // INJECT the mock (DI makes this easy)
    $service->register('ann@x.com');
}
```

تتيح لك كائنات PHPUnit الوهمية استبدال التبعيات (البريد، المستودعات، APIs) بنسخ مزيفة قابلة للتحكم — وحقن التبعيات يجعل حقنها أمراً تافهاً. يمكنك التأكد من أن الكائنات الوهمية يتم استدعاؤها بشكل صحيح. هذا هو أساس الاختبارات الموحدة السريعة والمعزولة.

## مزودو البيانات (اختبار حالات متعددة)

```php
public static function additionCases(): array {
    return [[1, 1, 2], [0, 5, 5], [-1, 1, 0]];   // [a, b, expected]
}

#[DataProvider('additionCases')]
public function testAdd(int $a, int $b, int $expected): void {
    $this->assertEquals($expected, (new Calculator())->add($a, $b));
}
```

**مزودو البيانات** يشغلون الاختبار ذاته ضد مجموعات إدخال متعددة — تغطية نظيفة لحالات متعددة بدون تكرار.

## أفضل الممارسات

```text
✓ Test behavior/public API, not implementation details (so refactors don't break tests)
✓ Mock external dependencies (DB, APIs, mailers) for fast, isolated unit tests
✓ Use a test database for integration tests; setUp/tearDown for fixtures
✓ Measure coverage; test edge cases and error paths, not just the happy path
✓ Frameworks (Laravel, Symfony) build on PHPUnit with extra testing helpers
```

## لماذا يهم هذا

الاختبار ضروري لبناء تطبيقات PHP موثوقة وقابلة للصيانة، و**PHPUnit** هي الأداة القياسية — لذا فهم كيفية اختبار PHP مهم جداً لجودة الكود وكتوقع احترافي.

معرفة كيفية كتابة الاختبارات (توسيع `TestCase`، استخدام التأكيدات، اختبار مسارات الاستثناءات) أمر أساسي، لكن الرؤية الأكثر قيمة هي كيف **يمكّن حقن التبعيات من الاختبار النظيف**: لأن فئات PHP المصممة بشكل جيد تتلقى تبعياتها، كائنات PHPUnit الوهمية تتيح لك استبدال التبعيات الحقيقية (قواعد البيانات، خدمات البريد، APIs الخارجية) بنسخ مزيفة قابلة للتحكم — مما يمكّن من الاختبارات الموحدة السريعة والمعزولة بدون بنية تحتية حقيقية، والسماح لك بالتحقق من التفاعلات (التأكد من استدعاء الكائن الوهمي بشكل صحيح).

الترابط بين DI والقابلية للاختبار هو بالضبط السبب في أهمية نمط حقن التبعيات.

فهم الكائنات الوهمية، **مزودو البيانات** (اختبار كفؤ لحالات إدخال متعددة)، وأفضل ممارسات الاختبار (اختبار السلوك وليس التنفيذ، وضع كائنات وهمية للتبعيات الخارجية، تغطية الحالات الحدودية ومسارات الخطأ، استخدام قواعد بيانات الاختبار للاختبارات المتكاملة) يغطي النطاق العملي للاختبار الفعال في PHP.

قد يكتشف PHP المختبر جيداً الانحدارات، يمكّن من إعادة الهيكلة الواثقة، ويوثق السلوك المتوقع، وبما أن الأطر الحديثة (Laravel، Symfony) تبني اختبارها على PHPUnit، فمعرفتها تطبيق واسع.

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