متغيرات البيئة: $env/static و$env/dynamic
يمكنك الوصول بأمان إلى متغيرات البيئة على الخادم والعميل في SvelteKit.
متغيرات البيئة: $env/static و$env/dynamic درس مجاني في Sveltejs Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Sveltejs Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Sveltejs Academy 4 دروس في المجموع.
واجهة env البرمجية في SvelteKit
يتيح SvelteKit الوصول إلى متغيرات البيئة عبر أربع وحدات: static/private وstatic/public وdynamic/private وdynamic/public.
خاص ثابت
تُقرأ قيمه أثناء عملية البناء، ولا يُتاح إلا على الخادم. ويُحذف من حزمة العميل.
import { DB_URL } from "$env/static/private";عام ثابت
تُقرأ قيمه أثناء عملية البناء، ويجب أن تبدأ بـ PUBLIC_، كما تُضمّن في حزمة العميل.
import { PUBLIC_API_URL } from "$env/static/public";خاص ديناميكي
تُقرأ قيمه أثناء وقت التشغيل على الخادم. وهو مفيد لتغيير الإعدادات دون إعادة البناء.
import { env } from "$env/dynamic/private";
console.log(env.SECRET);عام ديناميكي
تُقرأ قيمه أثناء وقت التشغيل، وتتوفر على العميل والخادم معًا. ويجب أن تبدأ بـ PUBLIC_.
اختيار الخيار المناسب
استخدم الخيار الثابت عندما لا تتغير القيم أثناء وقت التشغيل، والديناميكي عندما تتغير، مثل أعلام الميزات.
لا تجعل الأسرار عامة مطلقًا
لا تضع البادئة PUBLIC_ للأسرار مطلقًا؛ إذ ستتسرب إلى حزمة العميل.
ملف البيئة
خزّن القيم في .env (مع تجاهله في git) وفي .env.example (مع تضمينه في المستودع).
أمان الأنواع
تُحدَّد أنواع المتغيرات الثابتة تلقائيًا. أما المتغيرات الديناميكية فتُحدَّد عبر Record
Vercel وCloudflare
لكل منصة واجهة خاصة بها لمتغيرات البيئة. احرص على مزامنتها بين البيئات بطريقة مقصودة.
الاختبارات
حاكِ وحدات env في الاختبارات إذا كان تطبيقك يعتمد عليها.
تحقق سريع
ما البادئة المطلوبة لمتغيرات البيئة العامة؟
مراجعة
استخدم $env/static/private للأسرار، والمتغيرات التي تبدأ بـ PUBLIC_ للقيم الآمنة على العميل. واختر بين الثابت والديناميكي وفقًا للحاجة.
الأسئلة الشائعة
هل درس «متغيرات البيئة: $env/static و$env/dynamic» مجاني؟
نعم — نص درس «متغيرات البيئة: $env/static و$env/dynamic» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Sveltejs Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Sveltejs Academy 4 دروس في المجموع.
ماذا ستتعلم في «متغيرات البيئة: $env/static و$env/dynamic»؟
يمكنك الوصول بأمان إلى متغيرات البيئة على الخادم والعميل في SvelteKit. تتمرن على Sveltejs Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Sveltejs Academy؟
لا تُشترط خبرة سابقة. Sveltejs Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «متغيرات البيئة: $env/static و$env/dynamic»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Sveltejs Academy هذا؟
نعم. كل درس في Sveltejs Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- الحماية من CSRF في إجراءات النماذج
- منع XSS في {#html}
- متغيرات البيئة: $env/static و$env/dynamic
- تحديد معدل الطلبات باستخدام Hooks