في هذا الدرس 6تصفّح المواضيع
قبل البدء بإنشاء مشروع Laravel 11 أو 12، يجب التأكد من توفر إصدار PHP 8.2 أو أحدث على جهازك مع الإضافات الأساسية مثل OpenSSL وPDO وMbstring. كما يتطلب العمل تثبيت أداة Composer التي تدير تنزيل حزم الإطار وتضبط التحميل التلقائي للكلاسات.
- فحص إصدار المفسر (PHP Runtime Check): تنفيذ الأمر php -v في الطرفية للتأكد من عمل PHP 8.2 أو أحدث.
- الإضافات البرمجية المطلوبة (Required Extensions): التحقق من تفعيل إضافات mbstring وopenssl وpdo وxml وcurl.
- أداة إدارة الحزم (Composer CLI): تشغيل composer -V للتأكد من جاهزية مدير الاعتماديات.
# Verify PHP version and active extensions in terminal
php -v
php -m
# Verify Composer dependency manager version
composer -Vتعد الطريقة القياسية الشاملة لإنشاء مشروع Laravel جديد على أي نظام تشغيل هي استخدام أمر composer create-project مع القالب الرسمي laravel/laravel. يقوم هذا الأمر بتنزيل هيكل المشروع، وتثبيت كافة حزم مجلد vendor، وإنشاء ملف البيئة وتوليد مفتاح التشفير تلقائياً.
- قالب الهيكل الرسمي (Skeleton Package): حزمة laravel/laravel تبني شجرة المجلدات القياسية للتطبيق.
- مجلد المشروع الهدف (Target Folder): تحديد اسم المجلد في نهاية الأمر ينشئ مساحة عمل مستقلة للمشروع.
- مهام ما بعد التثبيت (Post-Install Hooks): ينسخ Composer ملف البيئة ويولد مفتاح التشفير فور انتهاء التنزيل.
# Create a new Laravel 12 project in "store-app"
composer create-project laravel/laravel store-app
# Move into the newly created project directory
cd store-appيفضل المبرمجون الذين ينشئون مشاريع متعددة تثبيت أداة المثبت الرسمي عالمياً عبر Composer للاستفادة من الأمر السريع laravel new. تتيح هذه الأداة واجهة تفاعلية لاختيار إطار الاختبار المفضل ومحرك قاعدة البيانات وخيارات البداية أثناء إنشاء المشروع.
- التثبيت العام لمرة واحدة (Global Installation): تنفيذ composer global require laravel/installer يتيح الأداة في كل النظام.
- معالج الإعداد التفاعلي (Interactive Wizard): يتيح أمر laravel new اختيار محرك البيانات وأداة الاختبار بسهولة.
- تهيئة مستودع Git (Instant Git Setup): تمرير الخيار --git ينشئ مستودعاً محلياً جاهزاً للعمل الفوري.
# Install the official Laravel CLI installer globally
composer global require laravel/installer
# Create a fresh project using the Laravel CLI
laravel new portal-appيوجد في جذر كل مشروع Laravel ملف composer.json الذي يوثق حزم التشغيل الأساسية وأدوات التطوير وقواعد ربط فضاءات الأسماء PSR-4. وبجانبه يحفظ ملف composer.lock أرقام الإصدارات الدقيقة التي تم تثبيتها لضمان تطابق البيئة بين جميع أجهزة الفريق وخادم الإنتاج.
- حزم التشغيل الأساسية (require Block): تضم الاعتماديات اللازمة لعمل النظام في الإنتاج مثل laravel/framework.
- حزم بيئة التطوير (require-dev Block): تضم أدوات الاختبار والفحص المحلي التي لا تُفعّل في الإنتاج.
- التحميل التلقائي للكلاسات (autoload PSR-4): يربط فضاء الأسماء App\ مباشرة بملفات مجلد app/.
{
"require": {
"php": "^8.2",
"laravel/framework": "^12.0"
},
"autoload": { "psr-4": { "App\\": "app/" } }
}بعد اكتمال تثبيت حزم المشروع، يمكنك تشغيل خادم التطوير المحلي المدمج فوراً عبر تنفيذ الأمر php artisan serve في الطرفية. يعمل الخادم افتراضياً على العنوان المحلي والمنفذ 8000، مع إمكانية تخصيص المنفذ عند تشغيل أكثر من مشروع في وقت واحد.
- العنوان المحلي الافتراضي (Default Endpoint): يشغل خادم ويب محلي يستجيب على المنفذ 8000 فوراً.
- تخصيص رقم المنفذ (Custom Port Flag): استخدام الخيار --port=8080 يمنع التعارض مع الخدمات المحلية الأخرى.
- تحديث متغيرات البيئة (Hot Reloading Env): يعيد الخادم المحلي قراءة ملف .env تلقائياً عند تعديل قيمه.
# Start the local server on default port 8000
php artisan serve
# Start on a custom port when 8000 is busy
php artisan serve --port=8080يعتمد اختيار طريقة التثبيت وتشغيل الخادم المحلي على طبيعة المهمة، سواء كنت تنشئ مشروعاً منفرداً أو تطور عدة تطبيقات أو تستنسخ مشروعاً قائماً من Git. يوضح الجدول المرجعي مقارنة عملية بين أوامر التثبيت والتشغيل لاختيار الأداة الأنسب لكل سيناريو.
| وجه المقارنة الهندسي | الأسلوب اليدوي أو التقليدي | معيار Laravel 12 الحديث |
|---|---|---|
| إدارة الحزم والمكتبات | تنزيل ملفات مضغوطة يدوياً واستدعاؤها عبر require_once | إدارة آلية دقيقة عبر composer.json وتثبيت الإصدارات بـ composer.lock |
| تحميل الكلاسات | كتابة دوال تحميل يدوية لكل مجلد داخل المشروع | تحميل تلقائي قياسي بمعيار PSR-4 يربط الفضاء App\ بمجلد app/ |
| خادم التطوير المحلي | إعدادات معقدة للمضيفات الافتراضية داخل Apache أو XAMPP | تشغيل فوري بسطر واحد عبر الأمر php artisan serve |
| تجهيز بيئة الفريق | خطوات يدوية عرضة لاختلاف الإصدارات بين أجهزة المبرمجين | تثبيت متطابق عبر composer install ونسخ .env.example وتوليد المفتاح |
# Standard setup after cloning an existing team repo
composer install
cp .env.example .env
php artisan key:generate
php artisan serveملخص الدرس
حصاد الدرسمراجعة مركّزة لأهم المفاهيم والقواعد الهندسية التي أتقنتها في هذا الدرس قبل التطبيق العملي
ماذا تعلّمت في هذا الدرس؟
أتقنت في هذا الدرس حول «تثبيت مشروع Laravel عبر Composer وتشغيل الخادم المحلي» مفاهيم متطلبات PHP ومدير الحزم Composer، وإنشاء مشروع Laravel عبر Composer، والتثبيت السريع بأداة Laravel CLI وفق معايير Laravel 12 الحديثة.
الخطوة التالية والدرس القادم
انتقل الآن إلى الدرس التالي «هيكلة مجلدات مشروع Laravel وملف Bootstrap App» للبناء التراكمي على ما تعلمته.
سجّل الدخول لحفظ تقدمك
تابع إنجاز المواضيع والمصطلحات والمهام، وكمّل من آخر خطوة على أي جهاز.
المصطلحات4
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 Installing Laravel تثبيت Laravel
- إنشاء مشروع Laravel جديد عبر أداة Composer أو مثبت Laravel الرسمي وتشغيل خادم التطوير المحلي لاختبار التطبيق.
- للمراجعة
- 02 PHP and Composer Prerequisites متطلبات PHP ومدير الحزم Composer
- المفهوم الهندسي والتطبيق العملي المباشر لقسم متطلبات PHP ومدير الحزم Composer في إطار العمل Laravel 12.
- للمراجعة
- 03 Creating Project with Composer إنشاء مشروع Laravel عبر Composer
- المفهوم الهندسي والتطبيق العملي المباشر لقسم إنشاء مشروع Laravel عبر Composer في إطار العمل Laravel 12.
- للمراجعة
- 04 Using Global Laravel Installer التثبيت السريع بأداة Laravel CLI
- المفهوم الهندسي والتطبيق العملي المباشر لقسم التثبيت السريع بأداة Laravel CLI في إطار العمل Laravel 12.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
الاختصارات4
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 MVC MVC
- Model View Controller
- النمط المعماري الذي يفصل بين نماذج البيانات Models، وطبقات العرض Views، والمتحكمات Controllers في Laravel.
- للمراجعة
- 02 CLI CLI
- Command Line Interface
- واجهة سطر الأوامر التي تعمل عبر أداة php artisan لتوليد الملفات وإدارة التطبيق.
- للمراجعة
- 03 HTTP HTTP
- Hypertext Transfer Protocol
- بروتوكول نقل النص الفائق الذي ينظم طلبات المتصفح واستجابات خادم Laravel.
- للمراجعة
- 04 PSR PSR
- PHP Standards Recommendations
- المعايير القياسية للغة PHP مثل التحميل التلقائي PSR-4 التي يلتزم بها إطار العمل Laravel.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
مهامك قبل الاختبار
خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.
-
اكتب ونفّذ المثال البرمجي المشروح في قسم «متطلبات PHP ومدير الحزم Composer» داخل مشروع Laravel 12 المحلي وتحقق من النتيجة.
-
بدّل بين الحالات الثلاث في المحاكي التفاعلي ضمن قسم «إنشاء مشروع Laravel عبر Composer» وقارن مخرجات التنفيذ.
تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.
اختبر فهمك.
ووصلها للإتقان.
كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.
أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.
الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.
لمحة عن التحدي8 أسئلة تنتظرك ＋
ما الهدف الهندسي الأساسي من متطلبات PHP ومدير الحزم Composer في إطار العمل Laravel 12؟
يسهم متطلبات PHP ومدير الحزم Composer في تنظيم منطق التطبيق بأسلوب معياري آمن وقابل للصيانة في Laravel 12.
يساعد الالتزام باصطلاحات Laravel 12 الرسمية في قسم «إنشاء مشروع Laravel عبر Composer» على رفع جودة الكود وسهولة اختباره آلياً.
صواب؛ الالتزام بالمعايير القياسية في Laravel 12 يجعل الكود واضحاً وسهل الفحص والصيانة.
أي آلية في Laravel 12 تتولى إدارة التثبيت السريع بأداة Laravel CLI بشكل مباشر ومنظم؟
توفر طبقة إطار العمل وحاوية الخدمات في Laravel 12 الأدوات القياسية لإدارة التثبيت السريع بأداة Laravel CLI.
لماذا يُعد تطبيق فحص حزم المشروع بملف composer.json مهماً عند بناء تطبيقات Laravel 12 جاهزة للإنتاج؟
لأنه يمنع الأخطاء البرمجية الخفية ويوحد سلوك التطبيق بين بيئتي التطوير والإنتاج.
في Laravel 12، يُنصح بكتابة مفاتيح الإنتاج السرية مباشرة داخل ملفات الكود المصدري المرفوعة إلى Git بدلاً من ملفات البيئة.
خطأ؛ يجب حفظ المفاتيح والبيانات السرية في متغيرات البيئة وعدم رفعها أبداً إلى مستودع Git.
ما المزايا الهندسية التي يحققها تطبيق تشغيل الخادم المحلي بأمر serve في Laravel 12؟ (اختر كل ما ينطبق)
يوفر فصلاً واضحاً للمسؤوليات، وأماناً أعلى أثناء التنفيذ، وتعاوناً أسهل بين أفراد الفريق.
يوظف إطار العمل Laravel 12 ميزات PHP 8 الحديثة مثل تحديد أنواع القيم المرجعة لجعل الكود أكثر وضوحاً وأماناً.
صواب؛ يعتمد Laravel 12 بشكل كامل على الصياغة الحديثة للغة PHP 8.2+ وسلامة الأنواع.
ما الفرق الجوهري بين معيار Laravel 12 الحديث والملفات اليدوية التقليدية في مقارنة طرق تثبيت مشاريع Laravel؟
يوفر Laravel 12 واجهات قياسية موحدة وحماية مدمجة تغني عن الكود اليدوي المعرض للأخطاء.