كيف يعمل التوجيه (Routing) في Laravel؟

Question

Accepted Answer

**التوجيه (Routing)** يربط عناوين URL وطرق HTTP بالكود الذي يتعامل معها. في Laravel تحدد المسارات في ملفات المسارات (`routes/web.php`, `routes/api.php`) باستخدام واجهة `Route`، وتشير كل واحدة إلى closure أو طريقة في المتحكم (controller). ## المسارات الأساسية ```php 'Home'); // GET / → closure Route::get('/users', [UserController::class, 'index']); // → controller method Route::post('/users', [UserController::class, 'store']); // POST Route::put('/users/{id}', [UserController::class, 'update']); Route::delete('/users/{id}', [UserController::class, 'destroy']); ``` كل طريقة HTTP لها مساعد `Route::`. تشير المسارات إلى closure (في الحالات البسيطة) أو، بشكل أكثر شيوعاً، زوج `[Controller::class, 'method']`. ## معاملات المسار ```php Route::get('/users/{id}', function ($id) { // {id} captured and passed in return User::find($id); }); Route::get('/posts/{post?}', fn($post = null) => ...); // optional parameter ``` ## المسارات المسماة (الإشارة إلى المسارات بالاسم، وليس بـ URL) ```php Route::get('/profile', [ProfileController::class, 'show'])->name('profile'); // generate URLs by NAME — refactor-safe (change the URL in one place) route('profile'); // → "/profile" redirect()->route('profile'); // in Blade: Profile ``` **المسارات المسماة** تسمح لك بالإشارة إلى المسارات بالاسم في كل مكان بدلاً من hardcoding URLs — لذا تغيير URL لن يكسر الروابط (ممارسة DRY وقابلة للصيانة). ## مجموعات المسارات والمسارات المورد ```php // group routes with shared middleware/prefix Route::middleware('auth')->prefix('admin')->group(function () { Route::get('/dashboard', ...); // → /admin/dashboard, requires auth }); // resource routes — all 7 RESTful routes for a controller at once Route::resource('posts', PostController::class); // → index, create, store, show, edit, update, destroy automatically ``` `Route::resource` ينشئ مجموعة كاملة من مسارات RESTful لمتحكم — كود أقل للعمليات القياسية CRUD. ## لماذا هذا مهم التوجيه أساسي لكل تطبيق Laravel — فهو يحدد عناوين URL الخاصة بتطبيقك ويربطها بمعالجات، لذا فهم كيفية عمله معرفة أساسية يومية لبناء أي endpoint. معرفة كيفية تحديد المسارات لكل طريقة HTTP، وتحويل المعاملات، وإشارة المسارات إلى متحكمات، وتنظيمها مع مجموعات (لـ middleware مشترك/بادئات) ضرورية لهيكلة التطبيق. هناك ممارستان مهمتان بشكل خاص: **المسارات المسماة** (الإشارة إلى المسارات بالاسم بدلاً من عناوين URL المكتوبة بشكل ثابت — وهي فائدة صيانة رئيسية تحافظ على الروابط من الكسر عند تغيير عناوين URL)، و**مسارات المورد** (`Route::resource`، التي تنشئ جميع مسارات RESTful القياسية لمتحكم في سطر واحد — ميزة إنتاجية رئيسية لـ CRUD). التوجيه يربط نقطة الدخول (URLs) بمنطق التطبيق (controllers)، مما يجعله مادة أساسية يجب معرفتها لبناء تطبيقات Laravel منظمة بشكل جيد، وتعكس اتفاقيات المسار المسمى ومسار المورد تركيز الإطار على التصميم النظيف والـ DRY و RESTful.