طلبات الاستمارة المخصصة (Form Requests)
في الدرس السابق، تعلمنا كيف نقوم بالتحقق من البيانات داخل المتحكم مباشرة. ولكن، ماذا لو كان لديك مئات الحقول أو قواعد معقدة؟ سيصبح المتحكم طويلاً جداً وصعب القراءة. يوفر Laravel حلاً أنيقاً يسمى Form Requests، وهو عبارة عن كلاسات منفصلة تحتوي على قواعد التحقق ومنطق الصلاحيات، مما يجعل المتحكم الخاص بك "نحيفاً" (Slim Controller) ومنظماً.
1. إنشاء Form Request جديد
لإنشاء كلاس طلب مخصص، نستخدم أمر Artisan التالي. سيتم إنشاء الملف في مجلد app/Http/Requests.
php artisan make:request StorePostRequest
2. تعريف القواعد والصلاحيات
يحتوي الكلاس الجديد على وظيفتين أساسيتين:
- authorize: لتحديد ما إذا كان المستخدم الحالي يملك الصلاحية لإجراء هذا الطلب.
- rules: لوضع قواعد التحقق التي تعلمناها سابقاً.
app/Http/Requests/StorePostRequest.php
public function authorize(): bool
{
return true; // مسموح للجميع حالياً
}
public function rules(): array
{
return [
'title' => 'required|unique:posts|max:255',
'body' => 'required',
];
}3. استبدال الطلب في المتحكم
الآن، بدلاً من استخدام كلاس Request العام في المتحكم، نستخدم الكلاس المخصص الذي أنشأناه. سيقوم لارافيل بالتحقق من البيانات تلقائياً قبل تنفيذ أي كود داخل الوظيفة:
PostController.php
public function store(StorePostRequest $request)
{
// إذا وصل الكود هنا، فهذا يعني أن البيانات صحيحة 100%
$validated = $request->validated();
Post::create($validated);
return redirect()->route('posts.index');
}أسئلة شائعة حول Form Requests
لن يتم تنفيذ الكود داخل المتحكم أبداً. سيقوم لارافيل بإعادة المستخدم تلقائياً للصفحة السابقة مع رسائل الخطأ، تماماً كما في الطريقة اليدوية، ولكن بطريقة أكثر تنظيماً.
نعم، يمكنك ذلك. يمكنك فحص نوع الطلب (PUT أو POST) داخل وظيفة
rules وتغيير القواعد بناءً على ذلك، مما يقلل من تكرار الكود.
الدرس القادم
الجلسات ورسائل الفلاش
بعد حفظ البيانات، نحتاج لإخبار المستخدم بنجاح العملية. سنتعلم كيف نستخدم Sessions و Flash Messages لعرض رسائل التنبيه المؤقتة.
تعلم رسائل الفلاش