معالجة النماذج والتحقق

<form action="/posts" method="POST">
    @csrf
    <!-- حقول النموذج -->
    <button type="submit">إرسال</button>
</form>

<!-- نموذج التحديث (PUT) -->
<form action="/posts/{{ $post->id }}" method="POST">
    @csrf
    @method('PUT')
    <!-- حقول النموذج -->
</form>

<!-- نموذج الحذف -->
<form action="/posts/{{ $post->id }}" method="POST">
    @csrf
    @method('DELETE')
    <button type="submit">حذف</button>
</form>

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\Post;

class PostController extends Controller
{
    public function store(Request $request)
    {
        // التحقق من الطلب
        $validated = $request->validate([
            'title' => 'required|max:255',
            'content' => 'required',
            'published_at' => 'nullable|date',
        ]);

        // إذا نجح التحقق، قم بإنشاء المنشور
        $post = Post::create($validated);

        return redirect()->route('posts.show', $post)
            ->with('success', 'تم إنشاء المنشور بنجاح!');
    }
}

// مطلوب واختياري
'field' => 'required'           // يجب أن يكون موجودًا وغير فارغ
'field' => 'nullable'           // يمكن أن يكون null
'field' => 'sometimes'          // التحقق فقط إذا كان موجودًا

// قواعد النص
'field' => 'string'             // يجب أن يكون نصًا
'field' => 'max:255'            // حد أقصى 255 حرف
'field' => 'min:3'              // حد أدنى 3 أحرف
'field' => 'between:3,255'      // بين 3-255 حرف

// قواعد رقمية
'field' => 'integer'            // يجب أن يكون عدد صحيح
'field' => 'numeric'            // يجب أن يكون رقميًا (int/float)
'field' => 'min:1'              // قيمة دنيا 1
'field' => 'max:100'            // قيمة قصوى 100
'field' => 'between:1,100'      // بين 1-100

// قواعد التاريخ
'field' => 'date'               // تاريخ صالح
'field' => 'date_format:Y-m-d'  // تنسيق محدد
'field' => 'before:tomorrow'    // قبل الغد
'field' => 'after:yesterday'    // بعد الأمس
'field' => 'before_or_equal:today'
'field' => 'after_or_equal:2023-01-01'

// البريد الإلكتروني وعنوان URL
'field' => 'email'              // بريد إلكتروني صالح
'field' => 'email:rfc,dns'      // التحقق الصارم من البريد الإلكتروني
'field' => 'url'                // عنوان URL صالح
'field' => 'active_url'         // عنوان URL يستجيب

// منطقي
'field' => 'boolean'            // true, false, 1, 0, "1", "0"
'field' => 'accepted'           // yes, on, 1, true (للشروط والأحكام)

// المصفوفات
'field' => 'array'              // يجب أن يكون مصفوفة
'field' => 'array:key1,key2'    // مصفوفة بمفاتيح محددة
'field.*' => 'string'           // كل عنصر في المصفوفة نص

// تحميل الملفات
'field' => 'file'               // يجب أن يكون ملف
'field' => 'image'              // يجب أن يكون صورة
'field' => 'mimes:jpg,png,pdf'  // أنواع MIME محددة
'field' => 'max:2048'           // حد أقصى 2 ميجابايت (بالكيلوبايت)
'field' => 'dimensions:min_width=100,min_height=100'

// قواعد قاعدة البيانات
'field' => 'unique:users,email' // فريد في users.email
'field' => 'exists:users,id'    // موجود في users.id
'field' => 'unique:users,email,' . $user->id  // تجاهل المستخدم الحالي

// صيغة الأنبوب
$request->validate([
    'email' => 'required|email|unique:users,email',
    'password' => 'required|min:8|confirmed',
]);

// صيغة المصفوفة (موصى بها للقواعد المعقدة)
$request->validate([
    'email' => ['required', 'email', 'unique:users,email'],
    'password' => ['required', 'min:8', 'confirmed'],
]);

$request->validate(
    [
        'title' => 'required|max:255',
        'email' => 'required|email|unique:users',
    ],
    [
        'title.required' => 'يرجى إدخال عنوان لمنشورك.',
        'title.max' => 'لا يمكن أن يكون العنوان أطول من 255 حرفًا.',
        'email.required' => 'نحتاج إلى عنوان بريدك الإلكتروني.',
        'email.unique' => 'هذا البريد الإلكتروني مسجل بالفعل.',
    ]
);

$request->validate(
    [
        'user_email' => 'required|email',
    ],
    [],
    [
        'user_email' => 'عنوان البريد الإلكتروني',
    ]
);

// رسالة الخطأ: "حقل عنوان البريد الإلكتروني مطلوب."
// بدلاً من: "حقل user email مطلوب."

<!-- عرض جميع الأخطاء -->
@if ($errors->any())
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

<!-- عرض خطأ لحقل محدد -->
<input type="text" name="title" value="{{ old('title') }}">
@error('title')
    <div class="error">{{ $message }}</div>
@enderror

<!-- التحقق من وجود خطأ في الحقل -->
<input type="email"
       name="email"
       class="@error('email') is-invalid @enderror"
       value="{{ old('email') }}">

<input type="text" name="title" value="{{ old('title') }}">

<textarea name="content">{{ old('content') }}</textarea>

<select name="category">
    <option value="1" {{ old('category') == 1 ? 'selected' : '' }}>تقنية</option>
    <option value="2" {{ old('category') == 2 ? 'selected' : '' }}>أخبار</option>
</select>

<input type="checkbox"
       name="terms"
       {{ old('terms') ? 'checked' : '' }}>

# إنشاء طلب نموذج
php artisan make:request StorePostRequest

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StorePostRequest extends FormRequest
{
    /**
     * تحديد ما إذا كان المستخدم مخولًا لتقديم هذا الطلب.
     */
    public function authorize(): bool
    {
        // إرجاع true للسماح لجميع المستخدمين
        // أو إضافة منطق التخويل
        return true;
    }

    /**
     * الحصول على قواعد التحقق.
     */
    public function rules(): array
    {
        return [
            'title' => 'required|max:255',
            'content' => 'required',
            'category_id' => 'required|exists:categories,id',
            'tags' => 'array',
            'tags.*' => 'exists:tags,id',
            'published_at' => 'nullable|date|after:now',
            'featured_image' => 'nullable|image|max:2048',
        ];
    }

    /**
     * رسائل خطأ مخصصة.
     */
    public function messages(): array
    {
        return [
            'title.required' => 'يرجى تقديم عنوان لمنشورك.',
            'category_id.exists' => 'الفئة المحددة غير صالحة.',
        ];
    }

    /**
     * أسماء سمات مخصصة.
     */
    public function attributes(): array
    {
        return [
            'category_id' => 'الفئة',
            'featured_image' => 'صورة الغلاف',
        ];
    }
}

<?php

namespace App\Http\Controllers;

use App\Http\Requests\StorePostRequest;
use App\Models\Post;

class PostController extends Controller
{
    public function store(StorePostRequest $request)
    {
        // يحدث التحقق تلقائيًا قبل تشغيل هذه الطريقة
        // إذا فشل التحقق، يتم إعادة توجيه المستخدم مع الأخطاء

        // الحصول على البيانات المتحقق منها فقط
        $validated = $request->validated();

        $post = Post::create($validated);

        return redirect()->route('posts.show', $post)
            ->with('success', 'تم إنشاء المنشور!');
    }
}

use Illuminate\Validation\Rule;

$request->validate([
    'role' => 'required|in:user,admin',

    // التحقق من الأذونات فقط إذا كان الدور مسؤول
    'permissions' => Rule::requiredIf(fn () => $request->role === 'admin'),

    // التحقق فقط إذا كان الحقل موجودًا
    'website' => 'sometimes|url',

    // استبعاد إذا كان الشرط صحيحًا
    'password' => 'exclude_if:oauth_login,true|required|min:8',
]);

// نموذج بمنتجات متعددة
$request->validate([
    'products' => 'required|array|min:1',
    'products.*.name' => 'required|string|max:255',
    'products.*.price' => 'required|numeric|min:0',
    'products.*.quantity' => 'required|integer|min:1',
]);

// كائنات متداخلة
$request->validate([
    'user.name' => 'required|string',
    'user.email' => 'required|email',
    'user.address.street' => 'required',
    'user.address.city' => 'required',
]);

$request->validate([
    // التحقق الأساسي من الملف
    'document' => 'required|file|max:10240',  // حد أقصى 10 ميجابايت

    // التحقق من الصورة
    'photo' => 'required|image|mimes:jpeg,png,jpg|max:2048',

    // أبعاد الصورة
    'avatar' => [
        'required',
        'image',
        'dimensions:min_width=100,min_height=100,max_width=1000,max_height=1000'
    ],

    // ملفات متعددة
    'photos' => 'required|array|min:1|max:5',
    'photos.*' => 'image|max:2048',
]);

// التعامل مع تحميل الملف
if ($request->hasFile('photo')) {
    $path = $request->file('photo')->store('photos', 'public');
}