كيفية تثبيت وإعداد Laravel للمبتدئين في PHP: خطوة بخطوة

مقدمة

Laravel هو إطار عمل PHP حديث وقوي يُستخدم لتطوير تطبيقات الويب. يتميز Laravel ببنيته المرنة وسهولة استخدامه، مما يجعله خيارًا مثاليًا للمبتدئين والمحترفين على حد سواء. يوفر Laravel مجموعة من الميزات القوية مثل ORM (Eloquent)، ونظام قوالب Blade، وميزة التوجيه السهل، والعديد من الأدوات الأخرى التي تجعل تطوير الويب أكثر سلاسة. في هذا الدليل، سنتعرف على كيفية تثبيت Laravel وإعداد أول تطبيق لك.

ما هو Laravel ولماذا نستخدمه؟

Laravel هو إطار عمل PHP مفتوح المصدر وشائع الاستخدام لبناء تطبيقات الويب. يعتمد Laravel على بنية MVC (Model-View-Controller) التي تساعد على تنظيم المشروع بشكل أفضل. من مميزات Laravel:

• سهولة الاستخدام: Laravel يقدم واجهة برمجية سهلة وبسيطة، مما يجعله مناسبًا للمبتدئين.
• نظام التوجيه المتقدم: يساعد في تحديد مسارات (Routes) التطبيق بسهولة.
• Blade: محرك القوالب المدمج الذي يتيح لك كتابة HTML بطريقة بسيطة وفعالة.
• Eloquent ORM: يوفر طريقة أنيقة وسهلة للتعامل مع قواعد البيانات باستخدام نماذج البيانات (Models).
• الأمان: Laravel يوفر العديد من الميزات الأمنية مثل حماية CSRF، حماية XSS، والتشفير.

المتطلبات الأساسية

قبل أن نبدأ بتثبيت Laravel، تأكد من أن لديك المتطلبات الأساسية التالية مثبتة على جهازك:

• PHP 8.0 أو أعلى
• Composer (مدير حزم PHP)
• خادم ويب مثل Apache أو Nginx
• قاعدة بيانات (مثل MySQL أو PostgreSQL)
• برنامج لتطوير الويب (مثل XAMPP، WAMP، MAMP، أو Docker)

الخطوة 1: إعداد بيئة العمل وتثبيت Composer

Composer هو مدير حزم PHP يُستخدم لإدارة التبعيات في مشروعك. لتثبيت Composer، اتبع الخطوات التالية:

1. تنزيل Composer: توجه إلى صفحة تنزيل Composer واتبع التعليمات الخاصة بنظام التشغيل الخاص بك.

2. التحقق من تثبيت Composer: بعد التثبيت، افتح سطر الأوامر واكتب:

composer --version

يجب أن يعرض هذا الأمر رقم إصدار Composer المثبت.

الخطوة 2: تثبيت Laravel

بعد تثبيت Composer، يمكنك الآن تثبيت Laravel. هناك طريقتان لتثبيت Laravel: عبر Laravel Installer أو باستخدام Composer مباشرة. سنغطي كلتا الطريقتين.

الطريقة 1: تثبيت Laravel باستخدام Laravel Installer

1. تثبيت Laravel Installer: افتح سطر الأوامر واكتب:

composer global require laravel/installer

2. تحديث مسار النظام: تأكد من أن مسار ~/.composer/vendor/bin موجود في متغير البيئة PATH لنظامك حتى تتمكن من تشغيل Laravel من أي مكان.

3. إنشاء مشروع Laravel جديد: بعد تثبيت Laravel Installer، يمكنك إنشاء مشروع Laravel جديد باستخدام الأمر:

laravel new my-first-app

سيقوم هذا بإنشاء مشروع Laravel جديد في مجلد باسم my-first-app.

الطريقة 2: تثبيت Laravel باستخدام Composer مباشرة

إذا كنت تفضل تثبيت Laravel باستخدام Composer مباشرة، يمكنك استخدام الأمر التالي:

composer create-project --prefer-dist laravel/laravel my-first-app

هذا الأمر سيقوم بإنشاء مشروع Laravel جديد بنفس الطريقة كما لو كنت تستخدم Laravel Installer.

الخطوة 3: إعداد مشروع Laravel

بعد إنشاء المشروع، انتقل إلى مجلد المشروع باستخدام سطر الأوامر:

cd my-first-app

ثم قم بتوليد مفتاح التطبيق باستخدام الأمر:

php artisan key:generate

هذا الأمر سينشئ مفتاح تطبيق جديد ويقوم بتحديث ملف .env.

الخطوة 4: إعداد قاعدة البيانات

افتح ملف .env وقم بتحديث إعدادات قاعدة البيانات لتتطابق مع إعدادات الخادم المحلي لديك. على سبيل المثال، إذا كنت تستخدم MySQL، قد تبدو الإعدادات كالتالي:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=my_first_app
DB_USERNAME=root
DB_PASSWORD=your_password

تأكد من تحديث DB_DATABASE و DB_USERNAME و DB_PASSWORD بالقيم الصحيحة.

الخطوة 5: تشغيل خادم Laravel المدمج

لتشغيل خادم Laravel المدمج والتحقق من أن كل شيء يعمل بشكل صحيح، استخدم الأمر التالي:

php artisan serve

سيتم تشغيل خادم التطوير على http://127.0.0.1:8000. افتح متصفح الويب وانتقل إلى هذا العنوان لرؤية الصفحة الرئيسية الافتراضية لتطبيق Laravel الخاص بك.

الخطوة 6: استكشاف هيكلية مشروع Laravel

لدى Laravel هيكلية منظمة تحتوي على عدة مجلدات وملفات هامة. إليك نظرة عامة على بعض المجلدات الرئيسية:

• app/: يحتوي على الكود الرئيسي للتطبيق، بما في ذلك النماذج (Models) والمتحكمات (Controllers).
• config/: يحتوي على ملفات التكوين الخاصة بالتطبيق.
• database/: يحتوي على ملفات الهجرة (Migrations) وتكوين قواعد البيانات.
• public/: يحتوي على نقطة الدخول الرئيسية للتطبيق (index.php) وملفات الموارد العامة مثل الصور والسكربتات.
• resources/: يحتوي على ملفات القوالب (Blade)، وملفات اللغة، وملفات CSS وJavaScript غير المحسنة.
• routes/: يحتوي على تعريفات المسارات. ملف web.php يستخدم لتعريف مسارات الويب.
• storage/: يحتوي على ملفات الجلسات (Sessions)، وملفات التحميلات، والسجلات (Logs).
• tests/: يحتوي على اختبارات الوحدة (Unit Tests) والاختبارات الوظيفية (Feature Tests).

الخطوة 7: استخدام أوامر Artisan الشائعة

Laravel يأتي مع أداة سطر أوامر قوية تسمى Artisan. إليك بعض الأوامر الشائعة والمفيدة للمبتدئين:

• php artisan migrate: تشغيل جميع عمليات الهجرة المعلقة لإنشاء جداول قاعدة البيانات.
• php artisan make:controller MyController: إنشاء متحكم جديد باسم MyController.
• php artisan route:list: عرض جميع المسارات المعرفة في التطبيق.
• php artisan tinker: الدخول إلى بيئة تفاعلية للتجربة مع التطبيق (REPL).

الخطوة 8: إنشاء صفحة ويب بسيطة باستخدام Laravel

لإنشاء صفحة ويب بسيطة، افتح ملف routes/web.php وأضف السطر التالي:

Route::get('/hello', function () {
    return 'Hello, Laravel!';
});

احفظ التغييرات، ثم افتح متصفح الويب وانتقل إلى http://127.0.0.1:8000/hello. يجب أن ترى الرسالة “Hello, Laravel!” على الشاشة.

الخطوة 9: مقدمة عن Blade محرك القوالب

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

1. أنشئ ملفًا جديدًا داخل resources/views باسم hello.blade.php.

2. أضف الكود التالي داخل hello.blade.php:

<!DOCTYPE html>
<html>
<head>
    <title>Welcome</title>
</head>
<body>
    <h1>Hello, Laravel with Blade!</h1>
</body>
</html>

3. عدل المسار في web.php ليبدو كالتالي:

Route::get('/hello', function () {
    return view('hello');
});

عند زيارة http://127.0.0.1:8000/hello، سترى الصفحة التي أنشأتها باستخدام Blade.

الخطوة 10: إعداد Git

لإعداد Git مع مشروع Laravel، اتبع الخطوات التالية:

git init
git add .
git commit -m "Initial commit of Laravel project"

قم بإنشاء ملف .gitignore وتأكد من تضمين مسارات الملفات التي لا تريد أن يتم تتبعها بواسطة Git، مثل مجلد vendor/ وملفات البيئة .env.

خاتمة

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

ابقَ على تواصل لمزيد من الدروس المتقدمة حول Laravel وكيفية استخدامه بكفاءة في مشاريعك البرمجية.