Laravel

تثبيت Laravel على Linux و Windows خطوة بخطوة

بقلم

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

كثير من المتعلمين يتوقفون في هذه المرحلة بسبب:

  • أخطاء في إصدار PHP
  • مشاكل Composer
  • غياب بعض Extensions
  • عدم فهم المتطلبات الأساسية

لذلك، في هذا المقال سنشرح التثبيت على Linux و Windows خطوة بخطوة، مع توضيح المشاكل الشائعة وحلولها، حتى تبدأ مشروعك بثقة.

المشكلة: فشل التثبيت عند المبتدئين

عند محاولة التثبيت مباشرة، يواجه المستخدم رسائل خطأ مثل:

  • Composer غير مثبت
  • PHP version غير مدعومة
  • Extensions مفقودة
  • الأمر laravel غير معروف

نتيجةً لذلك، يظن البعض أن Laravel معقّد، بينما المشكلة في الحقيقة تتعلّق بتهيئة البيئة بشكل غير صحيح.

الحل: إعداد البيئة أولًا ثم تثبيت Laravel

Laravel يعتمد على مجموعة أدوات أساسية.
بمجرد إعدادها بشكل صحيح، يصبح التثبيت سهلًا وسلسًا.

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

قبل أي خطوة، تأكد من توفر ما يلي:

  • PHP (إصدار 8.1 أو أحدث)
  • Composer
  • MySQL أو MariaDB
  • Server محلي (اختياري): Apache أو Nginx

أولًا: تثبيت Laravel على Linux

1- التحقق من إصدار PHP

افتح Terminal واكتب:

php -v

إذا لم يكن PHP مثبتًا، أو كان الإصدار قديمًا، قم بالتثبيت:

sudo apt install php php-cli php-mbstring php-xml php-curl php-zip php-mysql

2- تثبيت Composer

Composer هو مدير الحزم الخاص بـ PHP، وبدونه لا يمكن التثبيت.

sudo apt install composer

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

composer --version

3- التثبيت باستخدام Composer

انتقل إلى المجلد الذي تريد إنشاء المشروع داخله، ثم نفّذ:

composer create-project laravel/laravel my-project

بعد الانتهاء:

cd my-project
php artisan serve

افتح المتصفح على:

http://127.0.0.1:8000

إذا ظهرت صفحة Laravel الترحيبية، فالتثبيت تم بنجاح.

ثانيًا: تثبيت Laravel على Windows

1- تثبيت PHP

أفضل خيار للمبتدئ هو استخدام:

  • XAMPP
  • أو Laragon (مفضّل)

Laragon يوفّر PHP و MySQL و Apache جاهزين، ويُسهل إدارة المشاريع.

2- تثبيت Composer على Windows

  • قم بتحميل Composer من الموقع الرسمي
  • أثناء التثبيت، اختر مسار PHP الصحيح
  • أعد تشغيل الجهاز بعد الانتهاء

تحقق:

composer --version

3- إنشاء مشروع Laravel

افتح Command Prompt أو PowerShell داخل مجلد المشاريع:

composer create-project laravel/laravel my-project

ثم:

cd my-project
php artisan serve

طريقة بديلة: Laravel Installer

يمكنك أيضًا تثبيت Laravel Installer:

composer global require laravel/installer

ثم:

laravel new my-project

هذه الطريقة أسرع، لكنها تتطلب إعداد PATH بشكل صحيح.

إعداد ملف البيئة (.env)

بعد التثبيت، Laravel يستخدم ملف .env لإعداد قاعدة البيانات.

مثال:

DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

ثم شغّل:

php artisan migrate

إذا لم تظهر أخطاء، فالاتصال بقاعدة البيانات ناجح.

أخطاء شائعة أثناء التثبيت وكيف تحلها

مشكلة: PHP version not supported

الحل:
تحديث PHP إلى الإصدار المطلوب.

مشكلة: Extension missing

الحل:
تثبيت الامتدادات المطلوبة مثل:

php-mbstring
php-xml
php-curl

مشكلة: Composer command not found

الحل:
تثبيت Composer أو إضافته إلى PATH.

مشكلة: Permission denied (Linux)

الحل:

sudo chown -R $USER:$USER my-project

ماذا بعد تثبيت Laravel؟

بعد نجاح التثبيت، الخطوة التالية هي:

  • فهم Routes
  • تنظيم Controllers
  • عرض الصفحات باستخدام Blade

وهذا ما سنبدأ به في المقال القادم.

مقالات ذات صلة

LaravelLinuxPHPWindowsتعلم Laravel

اترك رد