تطبيقات Laravel.
ما يحصل عليه مشروع Laravel جاهزًا: APP_KEY وإعدادات بيئة الإنتاج، وSQLite حتى تضيف قاعدة بيانات، والترحيلات كأمر إصدار، وعامل طوابير، والمُجدوِل.
نتعرّف على 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_ENV | production |
APP_DEBUG | false |
APP_URL | عنوان التطبيق |
LOG_CHANNEL | stderr — ليعرض تبويب السجلات سجل Laravel |
SESSION_DRIVER، CACHE_STORE | redis إذا كان للتطبيق 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.