# شرح Dependency Injection وService Container في Laravel وهندسة البرمجيات

> شرح عملي لمفهوم حقن التبعيات Dependency Injection وحاوية الخدمات Service Container في Laravel وكيفية تطبيق عكس التحكم IoC لبناء كود مرن سهل الاختبار.

- **الناشر**: منصة إيجي مونيتور | EgyMonitor (https://egymonitor.com)
- **الرابط الأصلي**: [https://egymonitor.com/posts/dependency-injection-service-container-laravel](https://egymonitor.com/posts/dependency-injection-service-container-laravel)
- **القسم**: [التقنية](https://egymonitor.com/categories/technology)
- **الكاتب**: عبدالرحمن شوقي
- **تاريخ النشر**: 2026-11-22 20:51
- **الكلمات المفتاحية**: هندسة البرمجيات, PHP, Laravel, SOLID, Dependency Injection

---

يعني حقن التبعيات (**Dependency Injection**) تمرير الكائنات والخدمات التي يحتاجها الكلاس من الخارج بدلاً من إنشائها داخله عبر الكلمة المفتاحية `new`، بينما تتولى حاوية الخدمات (**Service Container**) في إطار Laravel إنشاء تلك التبعيات وحقنها تلقائياً عبر آلية Auto-wiring بناءً على أنواع المعاملات، مما يفك تشابك الكود ويجعل الاختبار والتوسع أسهل بكثير.

## مشكلة الربط الصلب وكيف تكسر قابلية التوسع؟

في بدايات أي مشروع برمجي، يميل المطور غالباً إلى إنشاء الكائنات مباشرة داخل الدوال أو المتحكمات باستخدام `new`. للوهلة الأولى يبدو هذا الأسلوب سريعاً ومباشراً، لكنه يزرع ارتباطاً وثيقاً (Tight Coupling) بين الكلاس وتفاصيل تنفيذ اعتمادياته. إذا أنشأ متحكم الطلبات كائن `StripePaymentGateway` مباشرة بداخله، فسيصبح المتحكم مقيداً ببوابة Stripe تحديداً وبإعدادات مفاتيحها وطريقة اتصالها بالشبكة.

تتضاعف المشكلة عند محاولة كتابة اختبار آلي لهذا المتحكم؛ إذ ستجد نفسك مضطراً للتعامل مع اتصال شبكة حقيقي أو الالتفاف بطرق معقدة لتعطيله. وإذا قررت الشركة لاحقاً دعم بوابة دفع محلية مثل Paymob أو تشغيل أكثر من بوابة حسب بلد العميل، فستضطر لتعديل عشرات الملفات المتناثرة داخل المشروع بدلاً من تعديل نقطة ربط مركزية واحدة.

## فهم مبدأ عكس التحكم IoC وحقن التبعيات عملياً

ينتمي حقن التبعيات إلى مفهوم أوسع في هندسة البرمجيات يُعرف بعكس التحكم (Inversion of Control - IoC)، وهو يتكامل مباشرة مع مبدأ انعكاس التبعية (Dependency Inversion Principle - DIP) أحد أعمدة مبادئ SOLID الخمسة. الفكرة الجوهرية بسيطة وقوية: بدلاً من أن يتحكم الكلاس في إنشاء تبعياته، يتخلى عن هذه المسؤولية لجهة خارجية تتولى تجهيزها وتمريرها إليه جاهزة للاستخدام.

### أنواع حقن التبعيات في البرمجة الكائنية

- **الحقن عبر الباني (Constructor Injection):** الأسلوب الأكثر شيوعاً والأفضل لتحديد التبعيات الإلزامية، لأنه يضمن عدم إنشاء الكائن في حالة ناقصة، ويوضح فوراً كل ما يعتمد عليه الكلاس من السطر الأول.

- **الحقن عبر الدوال (Method Injection):** مفيد عندما تحتاج دالة محددة فقط إلى خدمة معينة، وهو ما يدعمه Laravel تلقائياً في دوال المتحكمات والمسارات والأوامر.

- **الحقن عبر الخصائص (Setter Injection):** يُستخدم للتبعيات الاختيارية التي يمكن تغييرها بعد إنشاء الكائن، لكنه أقل تفضيلاً في التبعيات الأساسية لأنه قد يترك الكائن دون تهيئة كاملة.

## كيف يعمل Service Container في Laravel خلف الكواليس؟

تعد حاوية الخدمات (Service Container) القلب النابض لإطار Laravel؛ فهي المسؤولة عن إدارة دورة حياة الكائنات وحل تبعياتها المتداخلة تلقائياً. عندما تطلب كلاساً في باني متحكم أو دالة مسار، تستخدم الحاوية آلية الانعكاس في PHP (Reflection API) لفحص أنواع المعاملات المطلوبة.

### آلية الحل التلقائي Auto-wiring

إذا كان المعامل المطلوب كلاساً ملموساً (Concrete Class) لا يعتمد على معاملات بدائية غير معروفة، تقوم الحاوية بإنشائه تلقائياً، وإذا كان ذلك الكلاس بدوره يعتمد على خدمات أخرى، تواصل الحاوية حل السلسلة كاملة بصورة متكررة دون أن تكتب سطر ربط واحداً. أما إذا كان المعامل واجهة (Interface)، فتبحث الحاوية في جدول الربط المسجل لديها لتعرف أي تنفيذ فعلي يجب حقنه.

#### الفرق بين bind وsingleton وscoped في Laravel

- **الربط القياسي `bind()`:** ينشئ نسخة جديدة تماماً من الكائن في كل مرة يُطلب فيها من الحاوية، وهو الأنسب للخدمات التي تحمل حالة مؤقتة خاصة بكل عملية.

- **الربط المفرد `singleton()`:** ينشئ نسخة واحدة فقط عند أول طلب ويعيد استخدامها طوال دورة حياة التطبيق أو الطلب، وهو مثالي لاتصالات التخزين المؤقت مثل عميل Redis أو إعدادات التهيئة المكلفة.

- **الربط المحدود بالطلب `scoped()`:** يشبه `singleton` لكنه يعيد تصفير النسخة مع نهاية كل طلب في بيئات التشغيل الطويلة مثل Laravel Octane لمنع تسرب بيانات مستخدم إلى طلب آخر.

- **الربط السياقي (Contextual Binding):** يتيح حقن تنفيذ مختلف لنفس الواجهة بحسب الكلاس الذي يطلبها، كأن يحصل متحكم التقارير على مخزن محلي بينما يحصل متحكم الوسائط على مخزن سحابي.

أين تُسجل عمليات الربط داخل مشروع Laravel؟

المكان القياسي لتسجيل عقود الواجهات هو دالة `register()` داخل مزودات الخدمة مثل `AppServiceProvider` أو مزود خدمة مخصص للوحدة (مثل `PaymentServiceProvider`). يجب تجنب استدعاء خدمات أخرى قد لا تكون مسجلة بعد داخل `register()`، وترك أي منطق يعتمد على اكتمال تحميل الخدمات لدالة `boot()`.

فائدة استخدام الخاصية `$bindings` و`$singletons`

للربط البسيط المباشر بين واجهة وتنفيذ دون منطق تهيئة إضافي، يوفر Laravel مصفوفتي `$bindings` و`$singletons` داخل مزود الخدمة، مما يجعل ملف التسجيل أكثر نظافة وأسهل في القراءة والمراجعة.

## مقارنة طرق إدارة التبعيات في البرمجة الكائنية

يوضح الجدول التالي الفارق العملي بين أساليب إنشاء التبعيات الشائعة وتأثير كل منها على قابلية الاختبار والصيانة:

الأسلوب
المرونة وسهولة التبديل
قابلية الاختبار
إدارة الاعتماديات المتداخلة

**الإنشاء المباشر (`new Class`)**
منعدمة وتستلزم تعديل الكود
صعبة جداً وتتطلب التفافاً
يدوية ومكررة في كل مكان

**نمط Service Locator**
متوسطة عبر استدعاء مركزي
تخفي التبعيات الفعلية للكلاس
مركزية لكنها صعبة التتبع

**Dependency Injection + Container**
عالية جداً بسطر ربط واحد
ممتازة عبر تمرير Mocks بوضوح
تلقائية بالكامل (Auto-wiring)

## مثال عملي: ربط واجهة دفع عبر Service Container في Laravel

يوضح المثال التالي كيفية فصل متحكم إتمام الشراء عن تفاصيل بوابة الدفع عبر تعريف واجهة (Interface)، ثم ربطها بالتنفيذ الفعلي داخل مزود الخدمة، وحقنها تلقائياً في الباني:

```
// 1. تعريف العقد (Interface)
interface PaymentGatewayInterface
{
    public function charge(int $amountInCents): array;
}

// 2. تسجيل الربط في AppServiceProvider::register()
$this->app->bind(PaymentGatewayInterface::class, PaymobGateway::class);

// 3. حقن الواجهة تلقائياً داخل CheckoutController
class CheckoutController extends Controller
{
    public function __construct(
        private PaymentGatewayInterface $gateway
    ) {}

    public function store(Request $request)
    {
        return $this->gateway->charge($request->integer('amount'));
    }
}
```

عند كتابة اختبار لهذا المتحكم، يمكنك استبدال التنفيذ الحقيقي بنسخة وهمية عبر `$this->app->instance(PaymentGatewayInterface::class, new FakeGateway())` أو عبر أدوات المحاكاة المدمجة، فتتحقق من سلوك المتحكم خلال أجزاء من الثانية دون إرسال طلب واحد إلى بوابة الدفع الفعلية.

> قاعدة انعكاس التبعية (DIP): اعتمد في طبقات التطبيق العليا على التجريدات والواجهات لا على التفاصيل الملموسة، ودع حاوية الخدمات تتولى ربطها وإدارتها في مكان واحد.

### أسئلة شائعة

- **متى أستخدم `singleton` بدلاً من `bind`؟** استخدم `singleton` عند التعامل مع كائنات مكلفة الإنشاء أو تحتاج للحفاظ على حالة مشتركة خلال الطلب مثل عميل Redis أو محول إعدادات، مع الانتباه لاستخدام `scoped` عند العمل مع Laravel Octane.

- **هل يؤثر Service Container على سرعة أداء PHP؟** التأثير العملي لا يُذكر مقارنة بزمن استعلامات قاعدة البيانات أو الشبكة، خاصة أن الحاوية تعتمد على آليات محسّنة في الذاكرة لإدارة الكائنات المحلولة.

- **هل يجب إنشاء Interface لكل كلاس في المشروع؟** لا؛ الإفراط في إنشاء واجهات لكلاسات ليس لها سوى تنفيذ واحد يضيف تعقيداً بلا عائد. استخدم الواجهات للتكاملات الخارجية مثل بوابات الدفع، وخدمات البريد، والتخزين السحابي، ومصادر البيانات القابلة للتبديل.

- **هل يوجد نفس المفهوم في Node.js ولغات أخرى؟** نعم، يعد حقن التبعيات وحاوية الخدمات جوهر معمارية NestJS في Node.js عبر وسم `@Injectable()`، وكذلك في Spring Boot في Java وASP.NET Core في C#.
