ما هي حاوية الخدمات والحقن التبعي؟

Question

Accepted Answer

**حاوية الخدمات** (حاوية IoC) هي قلب Laravel — فهي تدير **الحقن التبعي**، وتحل تلقائياً وتحقن تبعيات الفئة. تقوم بكتابة التلميح النوعي لما تحتاجه، وتقوم الحاوية ببناء وتوفيره، مما يتيح كوداً فضفاضاً مقترناً وقابلاً للاختبار.

## الحقن التبعي التلقائي (الحالة الشائعة)

```php
class OrderController extends Controller {
    // type-hinted dependencies are AUTO-RESOLVED by the container — no manual `new`
    public function __construct(
        private OrderService $orders,
        private PaymentGateway $payments,
    ) {}

public function store(Request $request, Mailer $mailer) {
        // $request and $mailer also auto-injected into the method
    }
}
```

تقرأ الحاوية تلميحات النوع في المُنشئ (والدوال) وتقوم **تلقائياً ببناء وحقن** التبعيات — حل تبعياتها بشكل متكرر. نادراً ما تستدعي `new` للخدمات؛ الحاوية تربط كل شيء معاً.

## ربط التطبيقات بالواجهات

```php
// in a service provider — tell the container which implementation to use for an interface
$this->app->bind(PaymentGateway::class, StripeGateway::class);

// now anything type-hinting PaymentGateway gets a StripeGateway
class OrderService {
    public function __construct(private PaymentGateway $gateway) {}   // gets StripeGateway
}
```

ربط **واجهة بتطبيق** يتيح لك الاعتماد على التجريدات — وتبديل التطبيقات (مثل بوابة وهمية في الاختبارات) دون تغيير الكود الذي يستهلكها.

## Singletons والحل اليدوي

```php
$this->app->singleton(Cache::class, fn() => new RedisCache());   // ONE shared instance

// manual resolution (rarely needed — DI is preferred)
$service = app(OrderService::class);
$service = resolve(PaymentGateway::class);
```

`singleton` يسجل نسخة مشتركة واحدة؛ `app()`/`resolve()` تجلب من الحاوية يدوياً.

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

حاوية الخدمات والحقن التبعي أساسيان لـ Laravel — بهما يربط الإطار معاً مكونات التطبيق، لذا فإن فهمهما مهم للعمل بفعالية مع Laravel وكتابة كود معماري جيد.

**الحقن التبعي التلقائي** للحاوية منتشر في كل مكان: التبعيات المُلمحة نوعياً في المتحكمات والوظائف والفئات الأخرى يتم حلها وحقنها تلقائياً (بناء الرسم البياني للتبعية بالكامل)، لذا نادراً ما تقوم بإنشاء الخدمات يدوياً — هذا يتيح كوداً نظيفاً فضفاضاً مقترناً وقابلاً للاختبار.

القدرة على **ربط الواجهات بالتطبيقات** مهمة بشكل خاص: الاعتماد على التجريدات (الواجهات) بدلاً من الفئات الملموسة، مع توفير الحاوية للتطبيق، يجعل الكود مرناً (تبديل التطبيقات عبر الإعدادات) وعالي **قابلية الاختبار** (حقن الاختبارات المزيفة في الاختبارات — فائدة كبيرة).

فهم الحاوية (الحل التلقائي، ربط الواجهات، singletons)، وكيفية عمل DI في جميع أنحاء Laravel، وكيفية تمكينها للاختبارية والفصل السائب معرفة قيمة لبناء تطبيقات قابلة للصيانة ولفهم كيفية عمل Laravel نفسه (جميع مكوناته يتم حلها عبر الحاوية).

بما أن حاوية الخدمات تدعم معمارية Laravel بأكملها — وإتقان DI مفتاح لكتابة كود نظيف وقابل للاختبار ومتوافق مع الإطار — فإنها معرفة مهمة تميز المطورين الذين يفهمون Laravel بعمق وينشئون تطبيقات منظمة بشكل جيد عن أولئك الذين يكتبون كوداً مقترناً بإحكام دون الوعي بعمل الحاوية تحتهم.