لارافيل هو إطار عمل PHP قوي يُستخدم بشكل واسع لبناء تطبيقات ويب حديثة وقوية. مع بنيته الأنيقة ومجموعة الأدوات الشاملة، أصبح لارافيل الخيار الأول للمطورين. في هذا الدليل، سنرشدك خلال عملية تثبيت مشروع لارافيل على الخوادم المخصصة أو بيئة محلية.

المتطلبات الأساسية لتثبيت لارافيل

قبل أن تبدأ، تأكد من أن لديك ما يلي مثبتًا على جهازك:

• PHP: يتطلب لارافيل PHP بالإصدار 7.4 أو أعلى.

• Composer: هو مدير التبعيات لـ PHP ويُعد ضروريًا لتثبيت لارافيل.

• قاعدة بيانات: يدعم لارافيل العديد من أنظمة قواعد البيانات مثل MySQL و PostgreSQL و SQLite. تأكد من إعداد قاعدة بياناتك.

• خادم الويب: يتطلب لارافيل Apache أو Nginx لتقديم التطبيق.

تأكد من أن جهازك أو الخادم يحتوي على الإضافات المطلوبة لـ PHP مثل OpenSSL، PDO، Mbstring، و Tokenizer.

تثبيت Composer

Composer ضروري لتثبيت لارافيل وإدارة تبعياته. لتثبيت Composer، اتبع هذه الخطوات العامة:

1. قم بزيارة الموقع الرسمي لـ Composer لتنزيل وتثبيت Composer.

2. على أنظمة Linux و macOS، يمكنك تثبيت Composer عالميًا عبر سطر الأوامر.

3. على Windows، يمكنك تنزيل وتشغيل برنامج تثبيت Composer.

تثبيت لارافيل عبر Composer

بعد تثبيت Composer، يمكنك بسهولة إنشاء مشروع لارافيل جديد باتباع هذه الخطوات:

تثبيت لارافيل عالميًا

إذا كنت تفضل، يمكنك تثبيت لارافيل عالميًا على جهازك. سيسمح لك هذا بإنشاء مشاريع لارافيل جديدة من أي مجلد.

1. افتح الطرفية أو موجه الأوامر.

2. قم بتشغيل الأمر التالي لتثبيت مثبت لارافيل عالميًا:

   composer global require laravel/installer
   

3. بعد التثبيت، يمكنك إنشاء مشروع لارافيل جديد باستخدام الأمر التالي:

   laravel new project-name
   

تثبيت لارافيل عبر Composer مباشرة

بدلاً من تثبيت مثبت لارافيل عالميًا، يمكنك إنشاء مشروع لارافيل جديد باستخدام Composer مباشرة:

1. انتقل إلى المجلد الذي تريد إنشاء مشروع لارافيل فيه.

2. قم بتشغيل الأمر التالي:

   composer create-project --prefer-dist laravel/laravel project-name
   

سيقوم هذا بتنزيل وتثبيت أحدث إصدار من لارافيل في مجلد يُسمى project-name.

إعداد بيئتك

بعد تثبيت لارافيل، ستحتاج إلى إعداد البيئة الخاصة بك لتكوين الإعدادات الأساسية مثل قاعدة البيانات، URL التطبيق، وغيرها.

• إعداد البيئة: يستخدم لارافيل ملف .env لتكوين البيئة. يتم إنشاء هذا الملف تلقائيًا أثناء التثبيت. يحتوي على إعدادات بيئية مهمة مثل تفاصيل الاتصال بقاعدة البيانات وAPI Keys.

افتح ملف .env وقم بتكوين التالي:

• APP_NAME: قم بتعيين اسم تطبيقك.

• APP_ENV: حدد البيئة (محلي، إنتاج).

• APP_KEY: قم بإنشاء مفتاح التطبيق باستخدام الأمر:

  php artisan key:generate
  

• تكوين قاعدة البيانات: قم بتحديث إعدادات الاتصال بقاعدة البيانات (DB_HOST، DB_DATABASE، DB_USERNAME، DB_PASSWORD).

• إعداد الأذونات: تأكد من أن مجلدات storage و bootstrap/cache لديها الأذونات المناسبة للكتابة. يمكنك ضبط الأذونات عبر الأوامر التالية:

  sudo chmod -R 775 storage
  sudo chmod -R 775 bootstrap/cache
  

تشغيل تطبيق لارافيل

بعد إعداد البيئة، يمكنك تشغيل تطبيق لارافيل باستخدام الخادم المدمج لـ PHP لأغراض التطوير:

1. انتقل إلى المجلد الجذري لمشروعك.

2. قم بتشغيل الأمر التالي:

   php artisan serve
   

سيقوم هذا بتشغيل خادم التطوير على http://localhost:8000. يمكنك زيارة هذا العنوان في متصفحك لعرض تطبيق لارافيل الخاص بك.

إعداد قاعدة البيانات

يدعم لارافيل العديد من أنظمة قواعد البيانات. إليك كيفية إعداد قاعدة البيانات:

• إنشاء قاعدة بيانات: أنشئ قاعدة بيانات جديدة على خادم قاعدة البيانات الخاص بك (مثل MySQL).

• تكوين قاعدة البيانات في ملف .env: في ملف .env، قم بتحديث إعدادات قاعدة البيانات مع بيانات الاتصال الصحيحة.

مثال لـ MySQL:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

• تشغيل الترحيلات: يستخدم لارافيل الترحيلات لإدارة بنية قاعدة البيانات. يمكنك تشغيل الترحيلات لإنشاء الجداول:

  php artisan migrate
  

تطوير تطبيقك

بمجرد أن يكون تطبيق لارافيل الخاص بك مثبتًا ويعمل، يمكنك البدء في تطوير تطبيقك. يوفر لارافيل نظام توجيه بسيط وفعال، استعلامات قاعدة بيانات قوية، وبرمجيات وسيطة، والمصادقة والمزيد.

نشر التطبيق في بيئة الإنتاج

عندما يصبح تطبيق لارافيل جاهزًا للإنتاج، حان الوقت لنشره على الخادم المباشر. اتبع هذه الخطوات العامة للنشر:

• نقل الملفات إلى الخادم: استخدم FTP أو SCP أو أي طريقة أخرى لتحميل ملفات مشروعك إلى الخادم المباشر.

• تكوين خادم الويب: تأكد من أن خادم الويب (Apache أو Nginx) مهيأ لتقديم تطبيق لارافيل. قم بإعداد المضيف الظاهري وأشره إلى مجلد public.

• إعداد المتغيرات البيئية: تأكد من تكوين ملف .env بشكل صحيح لبيئة الإنتاج.

• تعيين الأذونات: قم بتعيين الأذونات الصحيحة للملفات والمجلدات.

• تحسين الإنتاج: قم بتشغيل الأوامر التالية لتحسين تطبيقك للإنتاج:

  php artisan config:cache
  php artisan route:cache
  php artisan optimize
  

• إعداد SSL: لأغراض الأمان، قم بإعداد SSL لخادم الإنتاج. سيقوم ذلك بتشفير البيانات بين الخادم والعميل.

تثبيت لارافيل وإعداد المشروع هو عملية بسيطة، لكنها تتطلب تكوين دقيق لضمان أن يعمل تطبيقك بكفاءة. من خلال اتباع هذا الدليل، يمكنك تشغيل مشروع لارافيل الخاص بك بسلاسة على الخادم المخصص أو بيئة التطوير المحلية.

الأسئلة الشائعة

ما هو الإصدار المطلوب من PHP لتشغيل لارافيل؟
يتطلب لارافيل الإصدار 7.4 أو أعلى من PHP لتحقيق أداء مثالي.

هل يمكنني تثبيت لارافيل على استضافة مشتركة؟
بينما يمكن ذلك، يُوصى باستخدام الخوادم المخصصة أو VPS للحصول على أداء أفضل وأمان أعلى وتحكم أفضل في البيئة.

هل أحتاج إلى تثبيت قاعدة بيانات يدويًا؟
نعم، تحتاج إلى إنشاء وتكوين قاعدة بيانات (مثل MySQL أو PostgreSQL) للعمل مع تطبيق لارافيل.

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

هل يمكنني استخدام لارافيل مع خادم سحابي؟
نعم، يمكن تثبيت لارافيل بسهولة على منصات سحابية مثل AWS أو DigitalOcean أو أي مزود استضافة يدعم PHP.

للحصول على مزيد من المعلومات، تفضل بزيارة موقعنا على الإنترنت في Rosseta IT Services.