الإعدادات والأسرار عبر البيئة
حمّلوا الإعدادات دون تضمين بيانات الاعتماد مباشرةً في التعليمات البرمجية.
الإعدادات والأسرار عبر البيئة درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.
بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.
Never Hardcode Secrets
An API key typed straight into your code can leak the moment you push to Git. Keep secrets out of source files entirely.
The Environment Holds Config
The standard place for settings is the environment. Your server reads values at startup instead of baking them into the build.
import os
api_key = os.environ["WEATHER_API_KEY"]Same Code, Many Setups
Reading from the environment lets one build run in dev, staging, and prod by simply swapping the variables around it.
Required vs Optional Values
Use indexing for a required value so a missing key fails loudly, and getenv with a default for optional ones.
key = os.environ["DB_URL"]
timeout = int(os.getenv("TIMEOUT", "30"))Validate Config at Startup
Check every setting when the server boots, not on the first request. Fail early with a clear message about what is missing.
Centralize in a Settings Class
Gather all values into one settings object so the rest of your code reads tidy attributes instead of scattered getenv calls.
class Settings:
db_url = os.environ["DB_URL"]
timeout = int(os.getenv("TIMEOUT", "30"))Pydantic Settings Helps
The BaseSettings class reads env vars, casts types, and validates them for you, turning loose strings into a checked config object.
from pydantic_settings import BaseSettings
class Settings(BaseSettings):
db_url: str
timeout: int = 30Use .env for Local Dev
A local .env file keeps your machine's values handy, but it must be gitignored so those values never reach the repository.
DB_URL=postgres://localhost/dev
TIMEOUT=15Never Log Secrets
When you print config for debugging, mask sensitive fields. A token in a log line is just as exposed as one in the code.
Inject Config, Don't Reach for It
Load settings once and pass them into your services through the lifespan. Avoid scattering os.environ reads deep in the code.
Document Every Variable
Keep a sample .env.example listing each variable with a comment. New users can copy it and know exactly what to fill in.
Quick Check
What is the safest way to give your server an API key?
Recap: Config & Secrets
Read settings from the environment, validate at boot, centralize in a settings object, and never commit or log secrets. Next: idempotency. 🔑
الأسئلة الشائعة
هل درس «الإعدادات والأسرار عبر البيئة» مجاني؟
نعم — نص درس «الإعدادات والأسرار عبر البيئة» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.
ماذا ستتعلم في «الإعدادات والأسرار عبر البيئة»؟
حمّلوا الإعدادات دون تضمين بيانات الاعتماد مباشرةً في التعليمات البرمجية. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟
لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.
كم من الوقت يستغرق درس «الإعدادات والأسرار عبر البيئة»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟
نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- بنية الخادم متعددة الطبقات
- الإعدادات والأسرار عبر البيئة
- أدوات متكررة وآمنة ومدركة للآثار الجانبية
- إصدار الأدوات والمخططات