المتطلّبات
Laravel يحتاج PHP وComposer (مدير حزم PHP). تأكّد منهما:
php --version
composer --version
إنشاء مشروع جديد
composer create-project laravel/laravel my-app
cd my-app
php artisan serve
ثم افتح http://localhost:8000. الأمر artisan serve يشغّل خادم التطوير.
بنية المجلّدات
| المجلّد | المحتوى |
|---|---|
app/ | منطق التطبيق (Models, Controllers) |
routes/ | تعريف المسارات (web.php, api.php) |
resources/views/ | قوالب Blade |
database/ | الهجرات (migrations) والبذور |
config/ | ملفّات الإعدادات |
public/ | نقطة الدخول والأصول العامّة |
storage/ | الملفّات المرفوعة والسجلّات |
.env | متغيّرات البيئة (أسرار، قاعدة بيانات) |
نقطة الدخول
كل الطلبات تمرّ عبر public/index.php، الذي يحمّل إطار Laravel ويوجّه
الطلب حسب routes/.
فلسفة Laravel
Laravel يتبع نمط MVC (Model-View-Controller): النموذج للبيانات، العرض للواجهة، والمتحكّم للمنطق الذي يربطهما. هذا الفصل يجعل الكود منظّمًا وقابلًا للصيانة.
الطلب → المسار (Route) → المتحكّم (Controller) → النموذج (Model)
↓
المتصفّح ← العرض (View/Blade) ←──────────┘
أخطاء شائعة
- نسيان تشغيل
composer installبعد استنساخ مشروع موجود. - تعديل ملفّات
vendor/يدويًّا — هي مُولَّدة، لا تلمسها.
🎯 التالي: أداة Artisan وأوامرها.