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

Injecting HTTP Request in Controllers حقن كائن الطلب داخل المتحكمات

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

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

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

يغلف إطار Laravel كل طلب HTTP وارد بما يحويه من معاملات استعلام وحقول نماذج وبيانات JSON ورؤوس الرسالة داخل كائن موحد من كلاس Illuminate\Http\Request. وبمجرد كتابة التلميح النوعي Request $request في دالة المتحكم، يقوم حاوي الخدمات بحقن الطلب الحالي تلقائياً.

  • الحقن التلقائي للطلب (Request Injection): يحقن حاوي الخدمات كائن الطلب تلقائياً عند إضافة التلميح النوعي للدالة.
  • التوافق مع معاملات المسار (Route Params): يُكتب كائن الطلب في بداية معاملات الدالة متبوعاً بمعاملات الرابط.
  • واجهة كائنية موحدة (Unified API): يغنيك الكائن تماماً عن التعامل المباشر مع مصفوفات PHP العامة مثل $_GET و$_POST.
مخطط معماري يوضح استقبال وفحص بيانات طلبات HTTP الواردة في Laravel في إطار العمل Laravel 12
PHP
<?php
use Illuminate\Http\Request;

public function index(Request $request)
{
    $term = $request->input('q');
    return view('search.results', compact('term'));
}