آپ PHPUnit کے ساتھ PHP کوڈ کی جانچ کیسے کرتے ہیں؟

Question

Accepted Answer

**PHPUnit** PHP کے لیے معیاری ٹیسٹنگ فریم ورک ہے — یہ unit اور integration ٹیسٹ لکھنے کے لیے استعمال ہوتا ہے جو یقینی بناتے ہیں کہ کوڈ صحیح طریقے سے کام کرتا ہے۔ Dependency injection (mocking کے لیے) اور data providers جیسی tools کے ساتھ ملا کر، یہ جامع اور قابل دیکھ بھال ٹیسٹنگ کو ممکن بناتا ہے۔

## ایک بنیادی ٹیسٹ

```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` کو extend کرتی ہیں، ٹیسٹ methods `test` سے شروع ہوتے ہیں (یا `#[Test]` attribute استعمال کرتے ہیں)، اور expectations کی تصدیق کے لیے `assert*` methods استعمال کرتے ہیں (`assertEquals`, `assertTrue`, `assertCount`, وغیرہ)۔ `expectException` غلطی کے راستوں کو ٹیسٹ کرتا ہے۔

## Dependencies کو mock کرنا (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 کی mocking آپ کو dependencies (mailers, repositories, APIs) کو قابو میں آنے والے fakes سے بدل دیتی ہے — اور dependency injection انہیں inject کرنا سادہ بناتا ہے۔ آپ یقینی بنا سکتے ہیں کہ mocks صحیح طریقے سے کال ہوں۔ یہ تیز، الگ تھلگ unit tests کی بنیاد ہے۔

## Data providers (بہت سے cases کو ٹیسٹ کریں)

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

**Data providers** ایک ہی ٹیسٹ کو متعدد input sets کے خلاف چلاتے ہیں — بہت سارے cases کا صاف احاطہ بغیر نقل کے۔

## بہترین طریقے

```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** معیاری tool ہے — اس لیے یہ جاننا کہ PHP کو کیسے ٹیسٹ کریں code quality اور پیشہ ورانہ توقع دونوں کے لیے اہم ہے۔

ٹیسٹ لکھنا جاننا (`TestCase` کو extend کرنا، assertions استعمال کرنا، exception paths کو ٹیسٹ کرنا) بنیادی ہے، لیکن سب سے قیمتی بصیرت یہ ہے کہ **dependency injection صاف ٹیسٹنگ کو کیسے ممکن بناتا ہے**: کیونکہ اچھی طریقے سے ڈیزائن کی گئی PHP کلاسز اپنی dependencies حاصل کرتی ہیں، PHPUnit کی mocking آپ کو حقیقی dependencies (databases, mailers, external APIs) کو قابو میں آنے والے fakes سے بدلنے دیتی ہے — حقیقی infrastructure کے بغیر تیز، الگ تھلگ unit tests کو ممکن بناتے ہوئے، اور آپ کو interactions کی تصدیق کرنے دیتے ہوئے (یہ یقینی بناتے ہوئے کہ ایک mock صحیح طریقے سے کال ہو)۔

DI اور testability کے درمیان یہ تعلق بالکل وہی وجہ ہے کہ dependency injection pattern اتنا زیادہ اہم ہے۔

Mocking، **data providers** (متعدد input cases کو موثر انداز میں ٹیسٹ کرنا)، اور ٹیسٹنگ کے بہترین طریقوں کو سمجھنا (behavior کو ٹیسٹ کرنا نہ کہ implementation کو، external dependencies کو mock کرنا، edge cases اور error paths کا احاطہ کرنا، integration tests کے لیے ٹیسٹ databases استعمال کرنا) موثر PHP ٹیسٹنگ کے عملی دائرہ کو ڈھکتا ہے۔

اچھی طریقے سے ٹیسٹ شدہ PHP regressions کو پکڑتا ہے، اعتماد کے ساتھ refactoring کو ممکن بناتا ہے، اور متوقع سلوک کو دستاویز کرتا ہے، اور چونکہ جدید frameworks (Laravel, Symfony) اپنی ٹیسٹنگ کو PHPUnit پر بناتے ہیں، اسے جاننا وسیع پیمانے پر قابل اطلاق ہے۔

PHPUnit میں مہارت حاصل کرنا — خاص طور پر isolated tests کے لیے mocking اور DI سے فائدہ اٹھانا — اہم senior-level علم ہے جو ایسے developers کو ممتاز کرتا ہے جو مضبوط، قابل دیکھ بھال، اچھی طریقے سے ٹیسٹ شدہ ایپلیکیشنز بناتے ہیں ان سے جو غیر ٹیسٹ شدہ، نازک کوڈ بھیجتے ہیں، اسے frequently-relevant، professionally-important موضوع بناتے ہوئے۔