متغيرات البيئة.
متغيراتك الخاصة والمتغيرات التي تضبطها Rivervo لك، والإنتاج مقابل المعاينات، واستبدال قيمة تلقائية، ومتى تسري التغييرات.
توجد المفاتيح وكلمات المرور وإعدادات تطبيقك في تبويب المتغيرات. وهي تُخزَّن مشفرة وتصل إلى تطبيقك كمتغيرات بيئة عادية.
إضافة متغيراتك
المتغيرات ← إضافة متغير، أدخل الاسم وقيمة، ثم حفظ.
- يتكون الاسم من حروف لاتينية وأرقام و
_، ولا يبدأ برقم. ويجب أن يكون كل اسم فريدًا. - نصيحة: الصق محتوى ملف
.envفي حقل الاسم — فتُضاف كل الأسطر دفعة واحدة.
تصل المتغيرات إلى التطبيق أثناء تشغيله — لا إلى مرحلة البناء. وتصل التغييرات إلى التطبيق مع النشر التالي. بعد الحفظ، تعرض لوحة التحكم انشر الآن، الذي يعيد نشر النسخة العاملة بالمتغيرات الجديدة دون بناء جديد.
الإنتاج والمعاينات
لكل متغير بيئة:
| البيئة | إلى أين يذهب |
|---|---|
| الإنتاج والمعاينات | التطبيق المباشر وكل معاينة فرع (الافتراضي) |
| الإنتاج فقط | التطبيق المباشر فقط — مثل مفتاح دفع حقيقي |
| المعاينات فقط | معاينات الفروع فقط — مثل مفتاح دفع تجريبي |
لا تحصل المعاينات إلا على المتغيرات المحددة لها. وللمعاينة أيضًا تبويب المتغيرات الخاص بها: ترى فيه ما تحصل عليه من التطبيق، والقيمة التي تضيفها بالاسم نفسه تحل محلها لتلك المعاينة فقط.
تُضبط تلقائيًا
تعرض قائمة تُضبط تلقائيًا ما توفره Rivervo لتطبيقك وتُبقيه محدّثًا. لا تحتاج إلى إضافتها بنفسك:
| المتغير | متى |
|---|---|
PORT | دائمًا — المنفذ الذي يستمع عليه تطبيقك |
DATABASE_URL، DB_CONNECTION، DB_HOST، DB_PORT، DB_DATABASE، DB_USERNAME، DB_PASSWORD | في المشروع قاعدة بيانات PostgreSQL أو MySQL |
PGHOST، PGPORT، PGDATABASE، PGUSER، PGPASSWORD | قاعدة البيانات من نوع PostgreSQL |
REDIS_URL، REDIS_HOST، REDIS_PORT، REDIS_PASSWORD، REDIS_CLIENT | في المشروع Valkey |
RIVERVO_<NAME>_URL | لكل قاعدة بيانات وValkey ونسخة قراءة متماثلة في المشروع، باسم خدمتها |
RIVERVO_<NAME>_URL | لكل خدمة ويب أخرى في التطبيق — عنوانها الداخلي، مثل RIVERVO_API_URL=http://api:8080 (راجع التواصل بين الخدمات) |
S3_ENDPOINT، S3_REGION، S3_BUCKET، S3_KEY، S3_SECRET | في المشروع تخزين كائنات |
APP_KEY، APP_ENV، APP_DEBUG، APP_URL، LOG_CHANNEL، SESSION_DRIVER، CACHE_STORE | تطبيق Laravel (راجع Laravel) |
تحصل أول قاعدة بيانات في المشروع على الأسماء المعتادة (DATABASE_URL، DB_*). أما الثانية فتضيف فقط RIVERVO_<NAME>_URL الخاص بها، فلا يتحول شيء من تلقاء نفسه — راجع قواعد البيانات.
استبدال قيمة تلقائية
المتغير الذي تضيفه بالاسم نفسه يحل محل المتغير التلقائي؛ وتضع عليه لوحة التحكم علامة تُستخدم قيمتك. استخدم ذلك لتوجيه التطبيق إلى مكان آخر، مثل توجيه DATABASE_URL إلى قاعدة بيانات أخرى في المشروع.
الاستثناء الوحيد هو PORT: فهو تديره Rivervo دائمًا.
خدمات المشروع
تحصل كل خدمة في المشروع — العمال (workers) والمهام المجدولة وخدمات الويب الأخرى — على متغيرات المشروع، بما فيها قاعدة بياناته. ويمكن للخدمة أيضًا أن تملك متغيرات خاصة بها تتقدم على متغيرات المشروع. وتحصل خدمة الويب دائمًا على APP_URL الخاص بها. كما تحصل كل خدمة برمجية على العنوان الداخلي لكل خدمة ويب أخرى بصيغة RIVERVO_<NAME>_URL؛ وبعد إضافة خدمة ويب أو إعادة تسميتها، أعد نشر الخدمات الأخرى لتحصل عليه. راجع خدمات المشروع.
من يرى القيم
القيم مرئية لمالك الحساب وللأشخاص الذين يحملون دور مطور أو مسؤول في التطبيق. ولا يراها دور مشاهد. راجع الوصول إلى تطبيق.