كيف يعمل حقن التبعيات (Dependency Injection) في PHP الحديث؟

Question

Accepted Answer

**حقن التبعيات (Dependency Injection)** هو نمط تصميم حيث تستقبل الفئة (class) تبعياتها من الخارج (عادة عبر المُنشئ constructor) بدلاً من إنشاؤها بنفسها. إطارات العمل الحديثة في PHP تستخدم حقن التبعيات بكثافة، غالباً مع **حاوية (container)** تحل وتحقن التبعيات تلقائياً — مما يؤدي إلى كود فضفاض الربط وقابل للاختبار.

## المشكلة التي يحلها حقن التبعيات

```php
// ❌ tight coupling — the class CREATES its own dependencies (hard to test/swap)
class UserService {
    private $mailer;
    public function __construct() {
        $this->mailer = new SmtpMailer();   // hardcoded → can't mock, can't swap
    }
}

// ✅ dependency injection — dependencies are PASSED IN
class UserService {
    public function __construct(private MailerInterface $mailer) {}
    // depends on an INTERFACE, receives the concrete impl from outside
}
```

حقن التبعيات (مقابل **واجهة interface**) يفصل الفئة عن التطبيقات الملموسة — يمكنك تبديل التطبيقات وحقن الكائنات الوهمية (mocks) في الاختبارات.

## حقن المُنشئ (الصيغة القياسية)

```php
class OrderService {
    public function __construct(
        private OrderRepository $repo,        // dependencies declared in the constructor
        private MailerInterface $mailer,
        private LoggerInterface $logger,
    ) {}
}
```

حقن المُنشئ يجعل التبعيات واضحة وصريحة ويضمن أن الكائن مكتمل التكوين عند إنشاؤه.

## حاويات حقن التبعيات — الحل التلقائي

```php
// a DI CONTAINER builds objects, resolving the whole dependency graph automatically
$container->bind(MailerInterface::class, SmtpMailer::class);   // map interface → impl

$service = $container->get(OrderService::class);
// the container sees OrderService needs OrderRepository, MailerInterface, LoggerInterface,
// constructs each (recursively), and injects them — you don't `new` anything manually
```

**حاوية حقن التبعيات** (في Laravel أو Symfony أو حل مستقل مثل PHP-DI) تُنشئ الكائنات تلقائياً بحل تبعيات المُنشئ بشكل تكراري — تقوم بتكوين ربط الواجهات بالتطبيقات، والحاوية تربط كل شيء معاً.

## الفوائد

```text
✓ Loose coupling — depend on interfaces/abstractions, not concrete classes
✓ Testability — inject mocks/fakes in tests (no real DB/mailer needed)
✓ Flexibility — swap implementations via container config (e.g. fake mailer in dev)
✓ Single responsibility — classes focus on logic, not constructing dependencies
```

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

حقن التبعيات هو نمط أساسي في PHP الحديث، مركزي في كيفية بناء التطبيقات والإطارات الاحترافية (Laravel و Symfony)، لذا فهم هذا النمط معرفة مهمة على مستوى الكبار.

القيمة الأساسية هي **الفصل بين المكونات (decoupling) وقابلية الاختبار (testability)**: بجعل الفئات تستقبل تبعياتها (المُعلّن عنها مقابل واجهات) بدلاً من إنشاؤها، يصبح الكود فضفاض الربط (يعتمد على التجريدات وليس التطبيقات الملموسة)، **قابل للاختبار بسهولة** (تحقن كائنات وهمية بدلاً من قواعد البيانات/الخدمات الحقيقية — مما يجعل الاختبار الشامل للوحدات عملياً)، ومرناً (تبديل التطبيقات عبر الإعدادات).

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

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

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