ابدأ الآن

تطبيقات Laravel.

ما يحصل عليه مشروع Laravel جاهزًا: APP_KEY وإعدادات بيئة الإنتاج، وSQLite حتى تضيف قاعدة بيانات، والترحيلات كأمر إصدار، وعامل طوابير، والمُجدوِل.

3 دقائق قراءة

نتعرّف على Laravel من خلال laravel/framework في composer.json. تنشره كما هو — دون إعداد للخادم ودون ملفات إضافية في المستودع.

كيف يُبنى ويُشغَّل

  • PHP — أدنى إصدار من 8.2 و8.3 و8.4 يحقق متطلب php في composer.json (8.3 إذا لم يُحدَّد).
  • Composer — composer install --no-dev --optimize-autoloader.
  • ملفات الواجهة الأمامية — إذا احتوى package.json على سكربت build (Vite)، يُشغَّل ويُضمَّن public/build.
  • عند البدء — storage:link، ثم تُبنى ذاكرة التخزين المؤقت للإعدادات والمسارات والعروض.
  • HTTPS — يرى تطبيقك طلبات HTTPS على أنها آمنة، فتستخدم url() وasset() وعمليات إعادة التوجيه https:// دون أن تحتاج إلى ضبط الثقة بالوكلاء بنفسك.

متغيرات نضبطها لك

المتغيرالقيمة
APP_KEYيُنشأ مرة واحدة عند أول نشر ويُحفظ مع متغيراتك
APP_ENVproduction
APP_DEBUGfalse
APP_URLعنوان التطبيق
LOG_CHANNELstderr — ليعرض تبويب السجلات سجل Laravel
SESSION_DRIVER، CACHE_STOREredis إذا كان للتطبيق Valkey، وإلا file

يمكنك استبدال أي منها بمتغير خاص بك يحمل الاسم نفسه — مثل SESSION_DRIVER=database. راجع متغيرات البيئة.

قاعدة البيانات: SQLite أولًا

يحفظ تطبيق Laravel الجديد دون قاعدة بيانات بياناته في SQLite — الخيار الافتراضي في Laravel نفسه — في storage/app/database.sqlite على قرص التطبيق. يبقى الملف بعد عمليات النشر ويُضمَّن في النسخ الاحتياطية اليومية للتطبيق، لذا يمكنك الإطلاق أولًا واختيار قاعدة البيانات لاحقًا.

عندما تضيف PostgreSQL أو MySQL إلى المشروع (نظرة عامة ← الخدمات ← إضافة خدمة)، ينتقل التطبيق إليها مع النشر التالي، وتُشغَّل الترحيلات هناك. لا تُنقل البيانات الموجودة في ملف SQLite — صدّرها أولًا إذا احتجت إليها، ثم استوردها من تبويب البيانات في قاعدة البيانات. راجع قواعد البيانات.

الترحيلات — أمر الإصدار

أمر الإصدار الموصى به هو php artisan migrate --force. يُشغَّل مرة واحدة في كل نشر، قبل أن تستقبل النسخة الجديدة الزوار؛ وإذا فشل ترحيل، تستمر النسخة الحالية في العمل. يمكنك تغييره من تبويب العمليات. راجع عمليات النشر.

عامل الطوابير والمُجدوِل

يشغّل تبويب العمليات افتراضيًا:

ماذاالأمر
عامل خلفي «queue»php artisan queue:work --sleep=3 --tries=3 --max-time=3600
أمر مجدول، كل دقيقةphp artisan schedule:run

يتشاركان موارد التطبيق ويُعاد تشغيلهما مع كل نشر. غيّرهما أو احذفهما من تبويب العمليات — مثلًا، استبدل العامل بـ php artisan horizon عندما تستخدم Horizon مع Valkey.

للطوابير الثقيلة، شغّل العامل كخدمة عامل خلفي مستقلة بمواردها الخاصة، واحذفه من العمليات. راجع خدمات المشروع.

Valkey للذاكرة المؤقتة والجلسات والطوابير

أضف Valkey إلى المشروع: تنتقل الجلسات والذاكرة المؤقتة إليه تلقائيًا (مع النشر التالي؛ ويسجّل الزوار دخولهم مرة أخرى). أما الطوابير وأي شيء آخر فاضبطه في تبويب المتغيرات، مثلًا:

CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

نضبط لك REDIS_HOST وREDIS_PASSWORD وREDIS_PORT وREDIS_CLIENT=phpredis.

WebSockets (Laravel Reverb)

شغّل Reverb كـ خدمة ويب من شيفرة هذا المشروع بالأمر php artisan reverb:start --host=0.0.0.0 --port=$PORT. وتحصل على عنوان خاص بها.

الملفات والملفات المرفوعة

تبقى الملفات في storage/app — أي قرصا local وpublic في Laravel — على قرص التطبيق بين عمليات النشر، وتُنسخ احتياطيًا يوميًا. أما كل ما عداها في مجلد المشروع فيأتي جديدًا من المستودع مع كل نشر. للملفات الكثيرة أو الكبيرة، استخدم تخزين الكائنات مع قرص s3 في Laravel.

ما زلت تحتاج إلى مساعدة؟

تحدّث معنا — يجيب AI فورًا وينضم مهندس عند الحاجة، في أي وقت من اليوم.

تواصل مع الدعم