تثبيت Laravel 11: الدليل الشامل لجميع أنظمة التشغيل
1. ما الذي تحتاجه قبل تثبيت Laravel 11؟
خلينا نكون صريحين من البداية: Laravel نفسه مجرد ملفات PHP. لكن لكي تعمل هذه الملفات على جهازك، يجب أن يكون جهازك جاهزاً لاستقبالها وتشغيلها. فكّر في الأمر هكذا:
تخيل أنك اشتريت لعبة PlayStation — اللعبة وحدها لا تعمل بدون جهاز PlayStation نفسه. بالمثل، Laravel يحتاج إلى ثلاثة أشياء على جهازك حتى يعمل:
- PHP 8.2 أو أعلى — هذه هي اللغة التي كُتب بها لارافيل. بدون PHP، جهازك لا يفهم ملفات Laravel أصلاً. Laravel 11 تحديداً يرفض العمل مع إصدارات PHP القديمة (أقل من 8.2).
-
Composer — تخيّله كمساعد ذكي يقوم بتحميل Laravel وكل المكتبات التي يحتاجها تلقائياً.
في عالم JavaScript، الـ
npmيقوم بنفس الدور. بدون Composer، لا يمكنك تحميل Laravel أصلاً — ستحصل على خطأ فوراً. - Node.js 20 LTS — يستخدمه Laravel للتعامل مع ملفات CSS وJavaScript عبر أداة اسمها Vite. إذا لم تثبّته، ستعمل الصفحات الخلفية ولكن الواجهة ستبدو بدون تنسيق.
الآن بعد أن فهمت لماذا نحتاج هذه الأشياء، لنرى كيف نثبّتها. اختر نظام التشغيل الخاص بك:
تثبيت Laravel 11 على Windows
إذا كنت تستخدم Windows، فعندك خياران: الطريقة السهلة باستخدام برنامج اسمه Laragon، أو الطريقة الرسمية الأحدث باستخدام Laravel Herd. سنشرح Laragon أولاً لأنه الأكثر شيوعاً في المنطقة العربية، ثم نذكر Herd كبديل سريع.
الخطوة 1: تحميل وتثبيت Laragon
Laragon هو برنامج يجمع كل ما تحتاجه في حزمة واحدة: PHP 8.3، MySQL، Composer، وNode.js. بدلاً من تثبيت كل واحدة على حدة، تثبّت Laragon وخلاص — كل شيء جاهز.
لماذا Laragon وليس XAMPP؟ لأن XAMPP قديم ولا يدعم PHP 8.3 بشكل كامل، بينما Laragon حديث وخفيف وأسرع.
- افتح المتصفح وتوجه إلى
laragon.org/download - حمّل نسخة Laragon Full (وليس Lite — نريد النسخة الكاملة مع MySQL وNode.js)
- شغّل ملف الـ
.exeواضغط Next → Next → Install بدون تغيير أي إعدادات - بعد التثبيت، شغّل Laragon واضغط "Start All" — ستضيء أزرار Apache وMySQL باللون الأخضر
php أو composer في أي مكان بدون تحديد المسار الكامل).
الخطوة 2: التحقق أن PHP وComposer يعملان
افتح PowerShell أو Command Prompt (ابحث عنهما في قائمة ابدأ) واكتب هذين الأمرين:
إذا ظهر لك شيء مثل PHP 8.3.x وانبثق تحته رقم إصدار Composer،
فأنت في الطريق الصحيح تماماً.
الخطوة 3: تثبيت أداة إنشاء مشاريع Laravel
Laravel الآن لديه أداة رسمية تسمى Laravel Installer.
هذه الأداة تعطيك أمراً بسيطاً اسمه laravel new
تستطيع من خلاله إنشاء أي مشروع في ثوانٍ.
نثبّتها مرة واحدة على الجهاز كله (وليس لكل مشروع على حدة):
انتظر حتى تكتمل العملية. ستلاحظ أن Composer يبدأ بتحميل ملفات عديدة — هذا طبيعي.
laravel new بعد التثبيت وظهر خطأ "laravel is not recognized":هذا يعني أن Windows لا يعرف أين يجد الأمر
laravel.
الحل: أضف هذا المسار إلى System PATH:
%APPDATA%\Composer\vendor\binكيف؟ ابحث عن "environment variables" في قائمة ابدأ ← Edit the system environment variables ← Environment Variables ← Path ← New ← الصق المسار ← OK.
أو الأسهل: بدلاً من
laravel new استخدم الأمر البديل في الخطوة التالية.
الخطوة 4: إنشاء أول مشروع Laravel على Windows
الآن الجزء الممتع! في PowerShell، انتقل أولاً إلى مجلد Laragon (هذا هو المكان الذي سيعمل فيه مشروعك محلياً):
ثم أنشئ المشروع:
إذا لم يعمل أمر laravel، استخدم هذا البديل المباشر — النتيجة نفسها:
سيبدأ Composer بتحميل Laravel وكل ملفاته. إذا كانت سرعة الإنترنت جيدة، يستغرق ذلك من 1 إلى 3 دقائق.
في النهاية، سيسألك Laravel عن نوع قاعدة البيانات. اختر SQLite — هي الأبسط للمبتدئين ولا تحتاج إعداداً إضافياً.
الخطوة 5: تشغيل المشروع ورؤية Laravel للمرة الأولى
ادخل إلى مجلد مشروعك الجديد ثم شغّل خادم التطوير المحلي:
ستظهر لك رسالة تقول أن الخادم يعمل على http://127.0.0.1:8000.
افتح هذا الرابط في متصفحك. إذا رأيت صفحة ترحيبية بألوان Laravel الحمراء —
مبروك! لقد نجحت في تثبيت Laravel على Windows ✅
إذا وجدت الخطوات أعلاه معقدة، جرّب Laravel Herd. هو تطبيق رسمي من فريق Laravel يشمل كل شيء — تثبّته وتنشئ مشروعك من واجهة رسومية بسيطة في أقل من دقيقتين، بدون أي أوامر أو PATH.
تثبيت Laravel 11 على macOS
إذا كنت تستخدم Mac، فعندك خياران أيضاً: الطريقة الأسهل عبر Laravel Herd (موصى بها للمبتدئين)، أو الطريقة اليدوية عبر Homebrew (للمن يريد التحكم الكامل). سنشرح الاثنتين.
الخطوة 1: تثبيت Homebrew (ضرورة بمطلق الأحوال)
Homebrew هو مدير الحزم الخاص بـ Mac. بكل بساطة: إنه "متجر تطبيقات" للمطورين، تستخدمه عبر سطر الأوامر. غالبية أدوات التطوير على Mac تحتاجه.
افتح تطبيق Terminal (ابحث عنه في Spotlight بضغط Cmd+Space)، ثم أدخل هذا الأمر:
قد يطلب كلمة مرور Mac الخاصة بك — هذا طبيعي تماماً.
الأوامر التي تبدأ بـ sudo أو يطلبها Homebrew تحتاج صلاحيات المشرف.
اكتب كلمة مرورك واضغط Enter (لن ترى الأحرف وهذا طبيعي في Mac/Linux).
الخطوة 2 (الطريقة السهلة): Laravel Herd
Laravel Herd هو تطبيق رسمي من فريق Laravel لـ macOS. يشمل PHP وNginx وComposer في تطبيق واحد يعمل في الـ Menu Bar (شريط الأدوات في أعلى الشاشة). لا يحتاج أي إعداد يدوي.
- توجه إلى
herd.laravel.comوحمّل نسخة macOS المجانية - افتح ملف
.dmgواسحب Herd إلى مجلد Applications - شغّل Herd — ستظهر أيقونته في Menu Bar في أعلى شاشتك
- افتح Terminal وتحقق:
http://my-first-app.test
بدون الحاجة لتشغيل php artisan serve في كل مرة.
Herd يدير كل ذلك في الخلفية بصمت.
الخطوة 2 (الطريقة اليدوية): PHP وComposer عبر Homebrew
إذا فضّلت التحكم الكامل وعدم الاعتماد على تطبيق ثالث:
هذا الأمر الواحد يثبّت PHP 8.3 وComposer وNode.js دفعةً واحدة. بعد انتهاء التثبيت، يجب إضافة PHP إلى الـ PATH حتى يتعرف عليها Terminal.
إذا كان جهازك Apple Silicon (M1/M2/M3/M4):
إذا كان جهازك Intel Mac:
أضف أيضاً Composer global bin:
الخطوة 3: تثبيت Laravel Installer
الخطوة 4: إنشاء مشروع Laravel وتشغيله على macOS
افتح http://127.0.0.1:8000 في المتصفح. إذا ظهرت صفحة Laravel — مبروك! 🎉
تثبيت Laravel 11 على Linux (Ubuntu / Debian)
إذا كنت تستخدم Linux، فمعناها أنك من الأصل لا تخاف من سطر الأوامر — وهذا رائع. التثبيت على Linux هو الأنظف والأكثر احترافية، لكنه يحتاج بعض الخطوات الإضافية التي سنشرحها بالتفصيل.
الخطوة 1: تحديث النظام وإضافة مستودع PHP الحديث
أولاً نحدّث قائمة الحزم ونثبّت الأدوات الأساسية:
ثم نضيف مستودع Ondřej Surý — وهو الشخص المسؤول عن توفير أحدث إصدارات PHP لتوزيعات Debian وUbuntu وLinux Mint:
الخطوة 2: تثبيت PHP 8.3 مع الإضافات الضرورية لـ Laravel
Laravel لا يحتاج PHP فقط — يحتاج أيضاً مجموعة من الإضافات (Extensions) التي تضيف وظائف معينة. إذا نسيت واحدة، سيعطيك خطأ واضحاً مثل "PHP extension X is required". لتوفير الوقت، نثبّتها كلها دفعةً واحدة:
تحقق من الإصدار:
يجب أن يظهر PHP 8.3.x. إذا ظهر إصدار قديم، نفّذ هذا الأمر لتعيين 8.3 كإصدار افتراضي:
الخطوة 3: تثبيت Composer على Linux
Composer غير موجود في مستودعات Ubuntu الافتراضية، لذا نحمّله مباشرة من موقعه الرسمي ونضعه في مجلد يمكن لـ Terminal الوصول إليه من أي مكان:
إذا ظهر رقم الإصدار — Composer تم تثبيته بنجاح.
الخطوة 4: تثبيت Node.js 20 LTS
Node.js الموجود في مستودعات Ubuntu قديم أيضاً. نستخدم المصدر الرسمي:
الخطوة 5: تثبيت Laravel Installer وإعداد PATH
نثبّت أداة Laravel وبعدها نضيف مسارها إلى الـ PATH لكي تعرفها الـ Shell:
إذا كنت تستخدم Bash (الشائع في Ubuntu):
إذا كنت تستخدم Zsh (شائع في بعض توزيعات Linux):
تحقق:
الخطوة 6: إنشاء مشروع Laravel وتشغيله على Linux
افتح المتصفح على http://127.0.0.1:8000.
إذا ظهرت صفحة Laravel — مبروك! التثبيت اكتمل بنجاح ✅
إذا كنت تعمل على مشاريع كبيرة وتريد بيئة معزولة تماماً مع Docker، Laravel يوفر أداة اسمها Sail. بعد إنشاء المشروع نفّذ:
4. ماذا يفعل أمر php artisan serve بالضبط؟
ربما تتساءل: "هل أحتاج لرفع الموقع على سيرفر حقيقي لكي أرى النتيجة؟" الجواب: لا. أبداً.
أمر php artisan serve يُشغّل خادماً صغيراً مباشرةً على جهازك.
هذا الخادم المحلي (Local Server) يجعل جهازك يتصرف كأنه سيرفر حقيقي،
لكن فقط أنت من يستطيع الوصول إليه عبر العنوان 127.0.0.1:8000.
هذا هو عنوان جهازك بالنسبة لنفسه (يُسمى localhost).
# تشغيل على المنفذ الافتراضي 8000
php artisan serve
# تغيير المنفذ (مفيد إذا 8000 مشغول)
php artisan serve --port=9000
# السماح لأجهزة أخرى في الشبكة بالوصول (مثلاً لاختبار على موبايلك)
php artisan serve --host=0.0.0.0 --port=8000
لإيقاف الخادم، ارجع إلى نافذة الـ Terminal واضغط Ctrl + C.
عندما تستأنف العمل في اليوم التالي، كل ما تحتاجه هو الدخول إلى مجلد المشروع
وتشغيل php artisan serve مجدداً.
artisan serve؟عندما تبدأ بالعمل على عدة مشاريع في آنٍ واحد، ستجد أنه مزعج لأن عليك تشغيله يدوياً لكل مشروع. في تلك المرحلة انتقل إلى Laravel Herd أو Laravel Valet (macOS/Linux) — يديران كل شيء تلقائياً في الخلفية.
مشكلة في التثبيت؟ ابحث عن خطأك هنا
لا تقلق إذا واجهتك مشكلة — كل مطور مررّ بهذا. إليك أكثر الأخطاء شيوعاً وحلها:
هذا يعني أن لارافيل وجد PHP لكن إصداره قديم. الحل يختلف حسب نظامك:
- Windows: في Laragon، اضغط على القائمة ← PHP ← اختر 8.3
- macOS:
brew upgrade php && brew link --overwrite php@8.3 - Linux:
sudo apt install php8.3 && sudo update-alternatives --set php /usr/bin/php8.3
بعد ذلك نفّذ php --version للتأكد من تغيير الإصدار.
الأداة نفسها تثبّتت بنجاح لكن الـ Terminal لا يعرف أين تجدها. الحل الأسرع — بدّل الأمر كلياً واستخدم Composer مباشرةً:
النتيجة نفسها تماماً. أو راجع خطوة إضافة PATH لنظام تشغيلك في الدرس أعلاه.
على Linux، ثبّت الإضافة الناقصة مباشرةً (غيّر اسم الإضافة حسب ما يظهر في الخطأ):
على Windows مع XAMPP: افتح ملف
C:\xampp\php\php.ini،
ابحث عن اسم الإضافة، وأزل علامة ; من أمام السطر،
ثم أعد تشغيل Apache.
على macOS مع Homebrew: Homebrew عادةً يثبّت الإضافات الأساسية تلقائياً مع PHP.
هذا الخطأ يظهر عادةً عندما تحمّل مشروع Laravel من GitHub
بدلاً من إنشائه بـ laravel new.
المشروع المحمول لا يحتوي على ملف .env ولا على مفتاح التشفير.
الحل في خطوتين:
هذا يعني أن Laravel يحاول الاتصال بـ MySQL لكنه لا يجده.
إما أن MySQL لا يعمل (في Laragon تأكد من Start All)،
أو أن إعدادات ملف .env خاطئة.
الحل الأسرع للمبتدئين: بدّل إلى SQLite — افتح ملف .env
وغيّر هذا السطر:
DB_CONNECTION=sqlite
# علّق أو احذف السطور: DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORDكيف يفهم Laravel طلبات المستخدم؟ 🏗️
ممتاز! الآن Laravel يعمل على جهازك. في الدرس القادم سندخل داخل المشروع لنفهم كيف يعالج لارافيل كل طلب — من لحظة كتابة الرابط في المتصفح حتى ظهور الصفحة أمامك. هذا الفهم هو الأساس الذي يبني عليه كل شيء.
تعلم دورة حياة الطلب