ما هي فئات Form Request؟

Question

Accepted Answer

فئات **Form Request** هي فئات طلب مخصصة تقوم بـ **تغليف منطق التحقق من الصحة (والتفويض)**  لطلب معين. فهي تنقل قواعد التحقق من الصحة من المتحكمات إلى فئات مخصصة وقابلة لإعادة الاستخدام — مما يحافظ على المتحكمات نحيفة والتحقق من الصحة منظماً.

## إنشاء واستخدام Form Request

```php
<?php
// php artisan make:request StoreUserRequest
class StoreUserRequest extends FormRequest {
    public function authorize(): bool {
        return $this->user()->can('create', User::class);   // AUTHORIZATION check
    }

public function rules(): array {
        return [                                              // VALIDATION rules
            'name' => 'required|string|max:100',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:8|confirmed',
        ];
    }

public function messages(): array {
        return ['email.unique' => 'That email is already taken.'];   // custom messages
    }
}
```

```php
// type-hint the Form Request in the controller — validation runs AUTOMATICALLY
public function store(StoreUserRequest $request) {
    // if we reach here, validation AND authorization already PASSED
    User::create($request->validated());   // get the validated data
}
```

عندما تقوم بـ type-hint لـ Form Request في طريقة متحكم، يقوم Laravel تلقائياً **بتشغيل التفويض والتحقق من الصحة قبل تنفيذ الطريقة** — إذا فشل أي منهما، يتم رفض الطلب (403 للتفويض، 422/إعادة توجيه للتحقق من الصحة) ولن تعمل طريقتك أبداً. لذا داخل الطريقة، تعرف أن البيانات صحيحة والإجراء مفوض.

## الفوائد

```text
✓ Thin controllers — validation/authorization logic lives in the Form Request, not the controller
✓ Reusable — use the same request class across multiple endpoints
✓ Organized — rules, messages, and authorization for a request are in one place
✓ Combines validation AND authorization — both checked automatically before the controller
✓ Access prepared/validated data cleanly via $request->validated()
```

## لماذا يهم

فئات Form Request هي ممارسة Laravel مهمة وموصى بها لتنظيم التحقق من الصحة والتفويض بنظافة — فهي الطريقة الموصى بها لأي شيء يتجاوز التحقق من الصحة البسيط، لذلك فهم كيفية عملها مفيد لكتابة تطبيقات Laravel قابلة للصيانة.

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

هذا الفصل يجعل الكود أكثر **تنظيماً** (جميع القواعد والرسائل المخصصة والتفويض لطلب واحد في مكان واحد متماسك)، **قابل لإعادة الاستخدام** (يمكن استخدام نفس Form Request عبر نقاط النهاية)، وأكثر نظافة.

الدمج التلقائي لـ **التحقق من الصحة والتفويض** في فئة واحدة — يتم فحص كليهما قبل تشغيل المتحكم، مع رفض الطلبات غير الصحيحة أو غير المفوضة تلقائياً — أمر أنيق ويقلل من الكود المتكرر.

فهم Form Requests، وكيفية تشغيلها تلقائياً، وفوائد استخراج التحقق من الصحة/التفويض من المتحكمات يعكس ممارسة Laravel النضجة ومهم لبناء تطبيقات منظمة جيداً، لأن التحقق من الصحة والتفويض هي مخاوف في كل مكان و Form Requests هي الطريقة النظيفة واللغوية في Laravel للتعامل معها للحالات غير البسيطة — علامة مميزة لكود Laravel احترافي وقابل للصيانة.