نموذج Laravel: التعامل مع مدخلات المستخدم والتحقق من الصحة

المقدمة

النماذج هي جزء أساسي من أي تطبيق ويب حيث تمكن المستخدمين من إرسال البيانات إلى الخادم. في Laravel، يمكنك إنشاء نماذج بسهولة، والتعامل مع مدخلات المستخدم، والتحقق من صحتها قبل تخزينها أو استخدامها. يوفر Laravel مجموعة من الأدوات القوية التي تساعدك على التحقق من البيانات، ومعالجة المدخلات، والتأكد من أمان التطبيق. في هذا الدليل، سنتعلم كيفية إنشاء نماذج، معالجة المدخلات، والتحقق من البيانات في Laravel.

الخطوة 1: إنشاء نموذج HTML في Laravel

لإنشاء نموذج في Laravel، يمكنك البدء بكتابة كود HTML داخل قالب Blade. لنقم بإنشاء نموذج بسيط لجمع اسم المستخدم وعنوان البريد الإلكتروني:

<!-- resources/views/user_form.blade.php -->

<form action="/submit-form" method="POST">
    @csrf
    <label for="name">الاسم:</label>
    <input type="text" id="name" name="name"><br><br>

    <label for="email">البريد الإلكتروني:</label>
    <input type="email" id="email" name="email"><br><br>

    <button type="submit">إرسال</button>
</form>

يحتوي هذا النموذج على حقلي إدخال: الاسم والبريد الإلكتروني، وزر إرسال لإرسال البيانات. لاحظ استخدام @csrf لإضافة رمز الحماية من هجمات CSRF، وهو أمر ضروري في جميع النماذج في Laravel.

الخطوة 2: إعداد المسار لمعالجة النموذج

لإرسال البيانات إلى الخادم، نحتاج إلى إعداد مسار (Route) يعالج الطلب POST المرسل من النموذج. افتح ملف routes/web.php وأضف المسار التالي:

use Illuminate\Http\Request;

Route::post('/submit-form', function (Request $request) {
    // معالجة البيانات
});

المسار /submit-form سيعالج الطلبات المرسلة باستخدام دالة مجهولة (Closure) تقوم بتنفيذ منطق معالجة البيانات.

الخطوة 3: معالجة مدخلات المستخدم

داخل دالة المعالجة، يمكنك الوصول إلى مدخلات المستخدم باستخدام كائن Request. لنقم بجلب القيم المدخلة وعرضها:

Route::post('/submit-form', function (Request $request) {
    $name = $request->input('name');
    $email = $request->input('email');

    return 'الاسم: ' . $name . ', البريد الإلكتروني: ' . $email;
});

هذا الكود يجلب القيم المدخلة من النموذج ويعرضها في المتصفح.

الخطوة 4: التحقق من صحة البيانات المدخلة

من الأفضل دائمًا التحقق من صحة البيانات المدخلة من المستخدمين قبل معالجتها أو تخزينها. يوفر Laravel طريقة سهلة للتحقق من البيانات باستخدام طريقة validate. لنقم بتحديث الدالة لإضافة التحقق من صحة البيانات:

Route::post('/submit-form', function (Request $request) {
    $validatedData = $request->validate([
        'name' => 'required|max:255',
        'email' => 'required|email',
    ]);

    // إذا كانت البيانات صالحة، يمكنك الآن معالجتها
    return 'البيانات صالحة ومعالجة بنجاح!';
});

يُظهر هذا المثال كيفية التحقق من أن الحقل “name” موجود وألا يتجاوز طوله 255 حرفًا، وأن الحقل “email” يحتوي على عنوان بريد إلكتروني صالح.

الخطوة 5: التعامل مع الأخطاء في التحقق من الصحة

إذا فشلت عملية التحقق من الصحة، فسيعيد Laravel المستخدم إلى الصفحة السابقة مع رسائل الخطأ. يمكنك عرض رسائل الخطأ في قالب Blade باستخدام التوجيه @error:

<!-- resources/views/user_form.blade.php -->

<form action="/submit-form" method="POST">
    @csrf
    <label for="name">الاسم:</label>
    <input type="text" id="name" name="name">
    @error('name')
        <div class="error">{{ $message }}</div>
    @enderror
    <br><br>

    <label for="email">البريد الإلكتروني:</label>
    <input type="email" id="email" name="email">
    @error('email')
        <div class="error">{{ $message }}</div>
    @enderror
    <br><br>

    <button type="submit">إرسال</button>
</form>

التوجيه @error يستخدم للتحقق من وجود رسالة خطأ لحقل معين وعرضها.

الخاتمة

من خلال استخدام النماذج في Laravel والتحقق من صحة البيانات المدخلة، يمكنك ضمان أن تطبيقك يعالج البيانات بشكل صحيح وآمن. توفر أدوات التحقق القوية في Laravel طريقة سهلة ومباشرة للتحقق من البيانات وضمان جودتها قبل معالجتها أو تخزينها. استمر في استكشاف المزيد من ميزات التحقق والمعالجة في Laravel لتحسين تطبيقاتك.

لمزيد من المعلومات، يمكنك زيارة المستندات الرسمية للارافيل.