تثبيت Laravel 5 وإعداده على Windows وUbuntu: دليل شامل للمطورين

يُعد Laravel أحد أشهر أطر العمل لتطوير تطبيقات الويب باستخدام لغة PHP، لما يوفره من هيكلية نظيفة ونظام MVC فعّال، بالإضافة إلى إمكانيات متقدمة مثل إدارة قواعد البيانات، التوجيه، الجلسات، نظام التوثيق، وغيرها. ورغم أن الإصدارات الحديثة من Laravel قد أطلقت، فإن الكثير من المشاريع الكبيرة لا تزال تعتمد على Laravel 5 بسبب الاستقرار ودعم الحزم المتوافق معها. لذلك، من المهم معرفة كيفية تثبيت Laravel 5 وإعداده بشكل صحيح، سواء على نظام Windows أو Ubuntu.

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

المتطلبات الأساسية لتثبيت Laravel 5

قبل البدء في التثبيت، يجب التأكد من توفر المتطلبات الأساسية التالية على النظام:

ملاحظات مهمة:

• Laravel 5.5 يتطلب PHP 7.0 أو أعلى.

• Composer هو أداة إدارة الحزم في PHP، ويُعد العنصر الأساسي لتنصيب Laravel.

أولاً: تثبيت Laravel 5 على نظام Windows

الخطوة 1: تثبيت PHP وComposer

تثبيت PHP

1. قم بتنزيل PHP من الموقع الرسمي: https://windows.php.net

2. استخرج الملف المضغوط في مجلد على سبيل المثال: C:\php

3. أضف المسار C:\php إلى متغير البيئة PATH.

تثبيت Composer

1. قم بتحميل مثبت Composer من الموقع: https://getcomposer.org/Composer-Setup.exe

2. شغّل الملف وتأكد من اختيار مسار PHP الصحيح أثناء التثبيت.

3. بعد التثبيت، تحقق من نجاح العملية بفتح موجه الأوامر وتشغيل:

   nginx
   CopyEdit
   composer -v
   

الخطوة 2: إعداد خادم Apache أو استخدام XAMPP

لمن لا يفضل التثبيت اليدوي، يمكن استخدام XAMPP:

• قم بتحميل XAMPP من https://www.apachefriends.org

• شغله وابدأ خدمتي Apache وMySQL

• ضع مجلد المشروع داخل C:\xampp\htdocs

الخطوة 3: إنشاء مشروع Laravel 5

افتح موجه الأوامر (Command Prompt) وانتقل إلى مجلد htdocs أو أي مجلد آخر ترغب في تثبيت Laravel فيه:

bash
CopyEdit
cd C:\xampp\htdocs
composer create-project laravel/laravel=5.5 myProject

ملاحظة: يمكنك تغيير 5.5 إلى أي إصدار من Laravel 5 ترغب به مثل 5.4, 5.3, إلخ.

الخطوة 4: ضبط إعدادات البيئة

1. انتقل إلى مجلد المشروع:

   bash
   CopyEdit
   cd myProject
   

2. انسخ ملف البيئة:

   bash
   CopyEdit
   copy .env.example .env
   

3. توليد مفتاح التشفير:

   vbnet
   CopyEdit
   php artisan key:generate
   

4. تأكد من إعداد الاتصال بقاعدة البيانات في ملف .env:

makefile
CopyEdit
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=mydatabase
DB_USERNAME=root
DB_PASSWORD=

أنشئ قاعدة بيانات mydatabase باستخدام phpMyAdmin أو من خلال MySQL مباشرة.

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

شغل الخادم باستخدام الأمر:

nginx
CopyEdit
php artisan serve

افتح المتصفح وادخل إلى: http://localhost:8000

ثانياً: تثبيت Laravel 5 على نظام Ubuntu (Debian-based)

الخطوة 1: تحديث النظام وتثبيت المتطلبات الأساسية

افتح الطرفية وابدأ بتحديث النظام:

bash
CopyEdit
sudo apt update && sudo apt upgrade -y

قم بتثبيت PHP والإضافات المطلوبة:

bash
CopyEdit
sudo apt install php php-cli php-mbstring php-xml php-bcmath php-curl php-zip php-mysql unzip curl git -y

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

bash
CopyEdit
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

تحقق من التثبيت:

bash
CopyEdit
composer -v

الخطوة 3: إنشاء مشروع Laravel 5

bash
CopyEdit
cd ~
composer create-project laravel/laravel=5.5 myProject

يتم تحميل جميع ملفات Laravel وتهيئتها تلقائيًا في مجلد myProject.

الخطوة 4: ضبط ملف البيئة

bash
CopyEdit
cd myProject
cp .env.example .env
php artisan key:generate

قم بتحرير ملف .env لإعداد قاعدة البيانات:

bash
CopyEdit
nano .env

قم بتعديل إعدادات MySQL حسب القيم الفعلية:

ini
CopyEdit
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=root
DB_PASSWORD=yourpassword

تأكد من إنشاء قاعدة البيانات laravel_db باستخدام MySQL أو باستخدام أداة مثل phpMyAdmin أو Adminer.

الخطوة 5: إعداد أذونات الملفات

أعطِ صلاحيات للمجلدات اللازمة:

bash
CopyEdit
sudo chown -R $USER:www-data storage
sudo chown -R $USER:www-data bootstrap/cache
chmod -R 775 storage
chmod -R 775 bootstrap/cache

الخطوة 6: تشغيل الخادم المحلي

bash
CopyEdit
php artisan serve

افتح المتصفح وانتقل إلى: http://127.0.0.1:8000

إضافات مهمة بعد التثبيت

تشغيل نظام التوجيه Routing

في ملف routes/web.php يمكنك إضافة مسارات جديدة كالتالي:

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

إعداد قواعد البيانات وترحيل الجداول

لإنشاء قاعدة بيانات وترحيل الجداول:

bash
CopyEdit
php artisan migrate

تثبيت حزم إضافية

Laravel 5 يدعم العديد من الحزم، مثل:

• Laravel Collective: لتسهيل إنشاء النماذج

• Spatie Permissions: لإدارة الصلاحيات

• JWTAuth: لتوثيق المستخدمين عبر JSON Web Token

لتثبيت Laravel Collective على سبيل المثال:

bash
CopyEdit
composer require laravelcollective/html

مقارنة بين بيئة Windows وUbuntu لتطوير Laravel

مصادر ومراجع

• Laravel Official Documentation – v5.x

• Composer Documentation

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