إنشاء أول Controller في Laravel

المقدمة

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

ما هو المتحكم في Laravel؟

المتحكم هو فئة PHP تُستخدم لتنظيم منطق تطبيق الويب. المتحكمات تسمح لك بتحديد دوال (Methods) متعددة للتعامل مع أنواع مختلفة من الطلبات (GET, POST, PUT, DELETE). في Laravel، يمكنك إنشاء متحكمات لتجميع منطق الأعمال وتعزيز تنظيم الكود.

الخطوة 1: إنشاء متحكم جديد

لإنشاء متحكم جديد في Laravel، يمكنك استخدام أداة سطر الأوامر Artisan، وهي الأداة المدمجة مع Laravel. لتنفيذ ذلك، افتح سطر الأوامر في مجلد مشروع Laravel واستخدم الأمر التالي:

php artisan make:controller MyFirstController

سيقوم هذا الأمر بإنشاء ملف جديد يُسمى MyFirstController.php في مجلد app/Http/Controllers.

الخطوة 2: إضافة دوال إلى المتحكم

بعد إنشاء المتحكم، يمكنك البدء في إضافة دوال (Methods) إليه. لنقم بإضافة دالة بسيطة تُرجع رسالة ترحيبية:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class MyFirstController extends Controller
{
    public function index()
    {
        return 'مرحباً بك في متحكم Laravel الأول!';
    }
}

الدالة index هنا تُرجع رسالة نصية بسيطة. يمكنك إضافة المزيد من الدوال للتعامل مع طلبات مختلفة.

الخطوة 3: ربط المتحكم بالمسارات

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

use App\Http\Controllers\MyFirstController;

Route::get('/welcome', [MyFirstController::class, 'index']);

سيقوم هذا المسار بتوجيه الطلبات التي تصل إلى /welcome إلى دالة index في MyFirstController.

الخطوة 4: اختبار المتحكم

لتجربة المتحكم الجديد، قم بتشغيل خادم Laravel باستخدام الأمر:

php artisan serve

ثم افتح متصفح الإنترنت وانتقل إلى http://localhost:8000/welcome. إذا تم إعداد كل شيء بشكل صحيح، سترى الرسالة “مرحباً بك في متحكم Laravel الأول!”

الخطوة 5: إضافة منطق الأعمال إلى المتحكم

يمكنك الآن إضافة منطق الأعمال الخاص بتطبيقك إلى المتحكم. على سبيل المثال، إذا كنت ترغب في جلب البيانات من قاعدة البيانات، يمكنك استخدام النموذج (Model) داخل المتحكم:

use App\Models\User;

public function show($id)
{
    $user = User::find($id);
    return view('user.profile', ['user' => $user]);
}

في هذا المثال، دالة show تجلب مستخدم من قاعدة البيانات بناءً على معرف المستخدم (user ID) وتعرضه في صفحة الملف الشخصي.

الخاتمة

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

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