انتقل إلى محتوى الدرس

Passing Parameters to Named Routes تمرير المعاملات للمسارات المسماة

تسمية المسارات برمجياً وتوليد الروابط الديناميكية عبر الدالة المساعدة route وفحص المسار النشط وفق أحدث معايير إطار العمل Laravel 12 مع أمثلة وتطبيقات عملية متدرجة.
1 صفوف تعليمية
إطار العمل Laravel
0 مشاهدة

شرح صفوف ومحتوى الفقرة

الصف 1 شرح توضيحي

عندما يحتوي المسار المسمى على معاملات ديناميكية مثل معرف الطلب، نمرر مصفوفة ترابطية كمعامل ثانٍ إلى الدالة route. يقوم Laravel بوضع القيم المطابقة لأسماء الأقواس المعقوفة في مكانها الصحيح داخل الرابط، ويحول أي مفاتيح إضافية في المصفوفة تلقائياً إلى معاملات استعلام Query String.

  • تعويض معاملات المسار (URI Segment Matching): المفاتيح المطابقة للأقواس المعقوفة تُوضع مباشرة في أجزاء الرابط.
  • توليد معاملات الاستعلام (Auto Query String): أي مفاتيح إضافية في المصفوفة تُلحق بنهاية الرابط بعد علامة الاستفهام.
  • الاختصار لمعامل واحد (Single Value Shorthand): إذا كان للمسار معامل وحيد يمكن تمرير قيمته مباشرة دون مصفوفة.
PHP
<?php
use Illuminate\Support\Facades\Route;

Route::get('/orders/{id}', fn (int $id) => "Order $id")
    ->name('orders.show');

// Generates: /orders/42?q=1
$url = route('orders.show', ['id' => 42, 'q' => 1]);