البدء مع Laravel 11: التثبيت والتكوين وهيكل المجلدات

في هذا الدرس الشامل، سنستكشف أساسيات البدء مع Laravel 11. Laravel هو إطار عمل PHP شائع معروف بتركيبته الأنيقة ومجموعة ميزاته الغنية ومجتمعه النابض بالحياة. سواء كنت مبتدئاً تتعلم الأساسيات أو مطوراً متمرساً، سيساعدك هذا الدليل على فهم تفاصيل إعداد Laravel وتكوينه وهيكل مجلداته.

لماذا تختار Laravel؟

غالباً ما يوصف Laravel بأنه إطار عمل "تقدمي"، مما يعني أنه ينمو معك. مع Laravel، تحصل على أفضل ما في العالمين: منحنى تعلم بسيط للمبتدئين وأدوات قوية للمطورين المتقدمين. تشمل الميزات الرئيسية:

• تركيب معبر: يجعل كودك ليس وظيفياً فحسب بل جميلاً أيضاً.
• أدوات قوية: لحقن التبعيات واختبار الوحدات والطوابير والأحداث في الوقت الفعلي.
• قابلية التوسع: دعم مدمج لأنظمة التخزين المؤقت الموزعة السريعة مثل Redis.
• دعم المجتمع: آلاف المطورين يساهمون ويدعمون نظام Laravel البيئي.

التثبيت

قبل الغوص في Laravel، تأكد من تثبيت PHP و Composer على جهازك المحلي.

الخطوة 1: تثبيت Composer

Composer هو مدير تبعيات PHP الذي تحتاجه لإدارة إطار عمل Laravel.

# تنزيل وتثبيت Composer
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
mv composer.phar /usr/local/bin/composer

الخطوة 2: إنشاء مشروع Laravel جديد

يمكنك إنشاء مشروع جديد باستخدام Composer:

# إنشاء مشروع Laravel جديد باستخدام Composer
composer create-project laravel/laravel example-app

أو عبر مثبت Laravel المثبت عالمياً:

# تثبيت مثبت Laravel عالمياً
composer global require laravel/installer
 
# إنشاء مشروع Laravel جديد
laravel new example-app

الخطوة 3: تشغيل خادم تطوير Laravel

انتقل إلى مجلد مشروعك وابدأ الخادم:

# الانتقال إلى مجلد المشروع
cd example-app
 
# بدء خادم التطوير
php artisan serve

تطبيق Laravel الخاص بك متاح الآن على http://localhost:8000.

التكوين الأولي

ملفات تكوين Laravel مخزنة في مجلد config. معظم التكوينات معدة مسبقاً لكن قد تحتاج إلى ضبط بعضها وفقاً لمتطلباتك.

التكوين القائم على البيئة

التكوينات القائمة على البيئة مخزنة في ملف .env الموجود في جذر تطبيقك. لا يجب الالتزام بهذا الملف في التحكم بالمصدر ويستخدم للتعامل مع تكوينات مختلفة للبيئات المحلية والإنتاجية.

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:YOUR_KEY_HERE
APP_DEBUG=true
APP_URL=http://localhost

العمل مع قواعد البيانات

يدعم Laravel مجموعة متنوعة من محركات قواعد البيانات بما في ذلك MySQL و PostgreSQL و SQLite. إذا كنت تريد استخدام MySQL، حدّث ملف تكوين .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

شغّل ترحيلات قاعدة البيانات لإنشاء الجداول اللازمة:

# تشغيل ترحيلات قاعدة البيانات
php artisan migrate

تثبيت Docker باستخدام Sail

يوفر Laravel Sail نقطة بداية رائعة باستخدام Docker:

على macOS:

# إنشاء مشروع Laravel جديد
curl -s "https://laravel.build/example-app" | bash
 
# الانتقال وبدء Sail
cd example-app
./vendor/bin/sail up

على Windows:

تأكد من تثبيت Docker Desktop و WSL2. شغّل ما يلي من Windows Terminal:

# إنشاء مشروع Laravel جديد
curl -s https://laravel.build/example-app | bash
 
# الانتقال وبدء Sail
cd example-app
./vendor/bin/sail up

على Linux:

إذا كان Docker Compose مثبتاً بالفعل:

# إنشاء مشروع Laravel جديد
curl -s https://laravel.build/example-app | bash
 
# الانتقال وبدء Sail
cd example-app
./vendor/bin/sail up

اختيار خدمات Sail الخاصة بك

عند إنشاء تطبيق Laravel جديد عبر Sail، يمكنك تحديد الخدمات المراد تضمينها:

# تحديد الخدمات في أمر الإنشاء
curl -s "https://laravel.build/example-app?with=mysql,redis" | bash

هيكل المجلدات

فهم هيكل مجلدات Laravel أمر حاسم لتنظيم وإدارة مشروعك بفعالية. فيما يلي نظرة عامة سريعة:

• المجلد الجذر: يحتوي على composer.json وملف .env والمجلد العام.
• مجلد app: يضم الكود الأساسي بما في ذلك النماذج والمتحكمات والوسيط.
• مجلد bootstrap: يحتوي على ملفات لتمهيد الإطار.
• مجلد config: جميع ملفات التكوين.
• مجلد database: يحتوي على ترحيلات قاعدة البيانات ومصانع النماذج والبذور.
• مجلد public: نقطة الدخول لجميع الطلبات، يحتوي على أصول مثل الصور و JavaScript.
• مجلد resources: العروض والأصول الخام مثل CSS و JavaScript.
• مجلد routes: تعريفات مسارات التطبيق.
• مجلد storage: السجلات والقوالب المجمعة وغيرها.
• مجلد tests: الاختبارات الآلية.
• مجلد vendor: تبعيات Composer.

لفهم أكثر تفصيلاً، راجع توثيق هيكل مجلدات Laravel.

الخطوات التالية

الآن، يجب أن يكون لديك بيئة تطوير Laravel تعمل بالكامل. فيما يلي الموارد المستخدمة لتعزيز معرفتك بـ Laravel:

• التثبيت
• التكوين
• هيكل المجلدات

في الختام، يوفر Laravel 11 إطار عمل قوياً لبناء تطبيقات الويب بسهولة وأناقة. طبيعته التقدمية تعني أنه ينمو معك، مقدماً مجموعة واسعة من الأدوات ومجتمعاً نابضاً بالحياة لدعم رحلة التطوير الخاصة بك.