ما هو ربط نموذج المسار (Route Model Binding)؟

Question

Accepted Answer

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

## الربط الضمني (الحالة الشائعة)

```php
// the route parameter name matches the type-hinted model's variable
Route::get('/users/{user}', [UserController::class, 'show']);

public function show(User $user) {          // type-hint User → auto-resolved by id
    return $user;                            // $user is the User with that id
}
// GET /users/5 → Laravel runs User::findOrFail(5) and injects it (404 if not found)
```

عندما تقوم بـ type-hint لنموذج (`User $user`) واسم معامل المسار يطابقه (`{user}`)، يقوم Laravel **تلقائياً بجلب النموذج بواسطة معرفه** وحقنه — مما يستبدل `User::findOrFail($id)` اليدوي الذي كان عليك كتابته، ويعيد 404 تلقائياً إذا لم تكن السجلات موجودة.

## بدون ربط نموذج مقابل مع ربط نموذج المسار

```php
// ❌ without — manual fetching and 404 handling
public function show($id) {
    $user = User::findOrFail($id);   // fetch + 404 by hand
    return $user;
}

// ✅ with route model binding — Laravel does it for you
public function show(User $user) {   // injected, 404 handled automatically
    return $user;
}
```

## تخصيص الربط (بعمود مختلف)

```php
// bind by a column other than id (e.g. a slug)
Route::get('/posts/{post:slug}', ...);    // resolves Post by its `slug` column

// or define a custom key on the model:
public function getRouteKeyName() { return 'slug'; }
```

بشكل افتراضي، يتم الربط بالمفتاح الأساسي، لكن يمكنك الربط بأي عمود (مثل `slug`) — مفيد جداً لعناوين URL الودية.

## الربط المحدود النطاق (الموارد المتداخلة)

```php
// ensure the comment belongs to the post (scoped to the parent)
Route::get('/posts/{post}/comments/{comment}', ...);   // auto-scoped in Laravel
```

## لماذا يهمك

ربط نموذج المسار هو ميزة Laravel مريحة وتُستخدم بتكرار تقلل من الكود المتكرر وتجعل المتحكمات أنظف، لذا فهم هذه الميزة هو معرفة عملية قيّمة يومية لبناء تطبيقات Laravel.

الفائدة الأساسية هي **أتمتة النمط الشائع** لجلب نموذج بواسطة معامل المسار: بدلاً من كتابة يدوية `Model::findOrFail($id)` (بالإضافة إلى معالجة 404) في كل طريقة متحكم، ما عليك سوى تنفيذ type-hint للنموذج وسيقوم Laravel بحل وحقنه تلقائياً — بما فيها إعادة 404 إذا لم تكن السجلات موجودة.

هذا يزيل كود الجلب والتحقق المتكرر عبر جميع إجراءات show/edit/update/delete تقريباً (التي تشكل معظم تطبيق CRUD)، مما يحافظ على تركيز المتحكمات ونظافتها.

فهم الربط الضمني (الحالة الشائعة)، وكيفية **تخصيص عمود الربط** (مثل الربط بـ `slug` بدلاً من المعرف للحصول على عناوين URL ودية — احتياج شائع)، والربط المحدود النطاق للموارد المتداخلة يغطي الاستخدامات العملية.

نظراً لأن ربط نموذج المسار يظهر في جميع تطبيقات Laravel (أي مسار يعمل على نموذج معين يستخدمه)، وبما أنه يجسد تركيز الإطار على تقليل الكود المتكرر والراحة الأنيقة، فإن معرفة كيفية عمله وكيفية تخصيصه هي معرفة عملية مهمة تتيح لك كتابة متحكمات أنظف والاستفادة بفعالية من إحدى ميزات جودة الحياة العديدة في Laravel.