معقول تقدر تركّب فريمورك كامل لتطوير مواقع الويب، وتشغّله فعليًا على جهازك خلال دقايق معدودة؟ ليش لا؟ خلنا نشوف كيف بالضبط.
لارافيل 11 صدر رسميًا بتاريخ 12 مارس 2024، وحسب سياسة الدعم الخاصة فيه، بيستمر إصلاح الأخطاء البرمجية فيه إلى 3 سبتمبر 2025، والتحديثات الأمنية إلى 12 مارس 2026. وصراحة هذي وحدة من أكثر الأشياء اللي تعجبني في نظام لارافيل — تقدر تاخذ فترة دعم معقولة تقارب السنتين، بدون ما تكون مجبر تحدّث مشروعك كل شهر، وبدون ما تعيش في قلق دائم إن تطبيقك بينهار في أي لحظة.
طيب بس قبل ما تبدأ فعليًا، فيه شوي متطلبات لازم تجهزها أول.
وش لازم يكون عندك قبل ما تبدأ؟
خلني أوضح أكثر، المتطلبات مو معقدة أبدًا:
- PHP إصدار 8.2 أو 8.3 لازم يكون مثبت على جهازك.
- أحدث نسخة من Composer (مدير الحزم الخاص بلغة PHP) مثبتة أيضًا.
- محرر أكواد حسب تفضيلك، وأنا شخصيًا أفضّل Visual Studio Code.
وبمجرد ما تتأكد إن هذي المتطلبات الثلاثة جاهزة عندك، خلنا نبدأ فعليًا.
طيب كيف تنشئ مشروع لارافيل من الصفر؟
بدون مقدمات، هذي الخطوات بالترتيب:
الخطوة الأولى: أنشئ مجلد خاص بمشاريعك. أنا شخصيًا عندي مجلد داخل بروفايل المستخدم عندي باسم "projects" واستخدمه لكل مشاريعي.
الخطوة الثانية: افتح موجّه الأوامر (اضغط على Win + R، ثم اكتب cmd، ثم Enter)، وانتقل داخل مجلد المشاريع اللي أنشأته.
الخطوة الثالثة: شغّل أمر Composer الخاص بإنشاء المشروع، واستبدل الجزء "name-of-project-here" باسم تختاره لمشروعك. هذا الأمر بينشئ مجلد كامل للمشروع، وبينزّل لارافيل وكل الحزم اللي يعتمد عليها تلقائيًا:
composer create-project laravel/laravel name-of-project-hereبعد تشغيل الأمر، بتشوف Composer يشتغل ويطلع لك رسائل شبيهة بهذي، وهذا يعني إنه يجهز كل شي تحتاجه:
Creating a "laravel/laravel" project at "./demo"
Installing laravel/laravel (v11.1.5)
- Downloading laravel/laravel (v11.1.5)
- Installing laravel/laravel (v11.1.5): Extracting archive
...طيب، بعد ما تخلص هذي الخطوة، تقدر تنتقل داخل مجلد المشروع عن طريق الأمر cd، أو تفتح المشروع مباشرة داخل محرر الأكواد. في هذي الحالة، بنفتح مجلد المشروع داخل VS Code، وبتشوف هيكلة الملفات الخاصة بمشروع لارافيل تظهر أمامك.
بس السؤال اللي يحتاج جواب الحين: كيف نربط هذا المشروع بقاعدة بيانات فعلية؟
طيب كيف تربط المشروع بقاعدة البيانات؟
أول شي، لازم تحدد ملف .env، وهو ملف إعدادات البيئة الخاص بالمشروع. افتح الملف، وابحث عن الجزء الخاص بقاعدة البيانات، وبتلاقيه تقريبًا عند السطر رقم 22.
بتلاقي الإعدادات الافتراضية شبيهة بهذي:
DB_CONNECTION=sqlite
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=laravel
# DB_USERNAME=root
# DB_PASSWORD=اتصال قاعدة البيانات الافتراضي هو sqlite، بس محتاج تحدد له ملف database.sqlite عشان يقدر يخزن البيانات فيه فعليًا. وهنا بالضبط تجيك المفاجأة الحلوة: Composer أصلًا أنشأ لك ملف sqlite. جاهز داخل مجلد database الفرعي، فبس نستخدم نفس هذا الملف من باب الراحة.
أضف السطر التالي، واستبدل المسار بمسار ملف sqlite الموجود عندك فعليًا:
DB_DATABASE=/absolute/path/to/database.sqliteوبالنهاية، لازم يكون شكل الإعدادات شبيه بهذا:
DB_CONNECTION=sqlite
DB_DATABASE=C:\Users\PHPavlz\Projects\demo\database\database.sqlite
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=laravel
# DB_USERNAME=root
# DB_PASSWORD=بعد كذا، احفظ ملف .env، وافتح الترمنال داخل VS Code (من قائمة Terminal، ثم New terminal)، أو تقدر تستخدم CMD في ويندوز أو الترمنال العادي في لينكس.
تأكد إنك فعليًا داخل مجلد مشروعك قبل ما تكمل. مثلًا، أنا هنا داخل مشروعي المسمى demo، لكن لو كنت داخل مجلد Projects العام، لازم أنتقل بالأمر cd /demo أول:
PS C:\Users\PHPavlz\Projects\demo>طيب بعد ما جهزنا اتصال قاعدة البيانات، جانا دور خطوة مهمة ثانية.
وش هي الهجرة (Migration) وليش تحتاجها؟
بما إن اتصال sqlite جاهز، وإحنا فعليًا داخل مجلد المشروع، خلنا نشغّل أمر الهجرة (Migration):
php artisan migrateوالنتيجة المتوقعة بتكون شبيهة بهذي:
INFO Preparing database.
Creating migration table ................................. 5.96ms DONE
INFO Running migrations.
0001_01_01_000000_create_users_table .................... 14.39ms DONE
0001_01_01_000001_create_cache_table .................... 4.26ms DONE
0001_01_01_000002_create_jobs_table ..................... 10.10ms DONEلو واجهتك أي مشكلة أثناء هذي الخطوة، فيه مقالة منفصلة عن حل مشكلة خطأ sqlite تحديدًا في لارافيل 11، تقدر تراجعها لو احتجت.
طيب، لو خلصت الهجرة بنجاح، خلنا نشغّل التطبيق فعليًا.
طيب كيف تشغّل التطبيق فعليًا؟
بعد ما تتأكد إن الهجرة خلصت بنجاح، شغّل الأمر التالي:
php artisan serveوالناتج بيكون:
INFO Server running on [http://127.0.0.1:8000].
Press Ctrl+C to stop the serverوهنا تجي لحظة الحقيقة. افتح المتصفح اللي تفضله، وروح لعنوان http://127.0.0.1:8000 … وشغال فعلًا!
مبروك، خلصت أول خطوة!
بس كذا، أنت الحين سوّيت أول تطبيق لارافيل شغّال فعليًا على جهازك. الخطوة الجاية بتكون تركيب حزمة بداية (Starter Pack) وبناء تطبيق CRUD كامل — بس هذا موضوع مقالة ثانية.
الملخص
باختصار: لارافيل 11 يوفر لك دورة دعم طويلة نسبيًا (حتى مارس 2026 للتحديثات الأمنية)، وتركيب أول مشروع فيه يحتاج بس ثلاثة أشياء جاهزة عندك (PHP، Composer، محرر أكواد)، وبعدها خطوات بسيطة: إنشاء المشروع، ربط قاعدة بيانات sqlite، تشغيل الهجرة، وتشغيل السيرفر المحلي. جرب الخطوات بنفسك الحين على جهازك، وشوف تطبيقك الأول يشتغل خلال دقايق.
