كيف تدير الإعدادات عبر بيئات مختلفة؟

Question

Accepted Answer

إعدادات Django موجودة في `settings.py`، لكن التطبيقات الحقيقية تحتاج **إعدادات مختلفة لكل بيئة** (تطوير، staging، إنتاج) ويجب أن **تحافظ على الأسرار بعيداً عن الكود**. إدارة هذا بشكل صحيح هي ضرورة تشغيلية وحتمية أمنية في نفس الوقت.

## المشكلة مع ملف settings.py واحد

```python
# ❌ hardcoded, environment-mixed, and INSECURE settings
DEBUG = True                                    # must be False in production!
SECRET_KEY = "hardcoded-secret-in-code"          # ❌ secret committed to git
DATABASES = {"default": {"PASSWORD": "prod-pw"}} # ❌ production password in code
```

ترميز القيم بشكل صريح يخلط بين البيئات و — والأهم من ذلك — يرتكب الأسرار (SECRET_KEY، كلمات مرور قاعدة البيانات، مفاتيح API) في التحكم بالإصدارات، وهي خرق أمني خطير.

## الحل 1: قراءة الإعدادات من متغيرات البيئة

```python
import os
from pathlib import Path

SECRET_KEY = os.environ["DJANGO_SECRET_KEY"]    # from the environment, NOT code
DEBUG = os.environ.get("DJANGO_DEBUG", "False") == "True"
ALLOWED_HOSTS = os.environ.get("ALLOWED_HOSTS", "").split(",")
DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql",
        "NAME": os.environ["DB_NAME"],
        "PASSWORD": os.environ["DB_PASSWORD"],   # injected per environment
    }
}
# tools like django-environ / python-decouple make this cleaner (+ .env file support)
```

قراءة الإعدادات (خاصة الأسرار) من **متغيرات البيئة** تبقيها بعيداً عن الكود — نفس قاعدة الكود تعمل في أي بيئة مع قيم مختلفة مُدرجة (نهج العوامل الاثني عشر).

## الحل 2: تقسيم ملفات الإعدادات حسب البيئة

```text
settings/
  base.py          # shared settings (apps, middleware, templates)
  development.py   # from base import *; DEBUG=True, local DB, debug toolbar
  production.py    # from base import *; DEBUG=False, security hardening, real DB
  test.py          # test-specific settings
```

```python
# production.py
from .base import *
DEBUG = False
ALLOWED_HOSTS = ["example.com"]
SECURE_SSL_REDIRECT = True            # production-only security settings
# select via: DJANGO_SETTINGS_MODULE=config.settings.production
```

تقسيم الإعدادات إلى `base.py` مشترك بالإضافة إلى ملفات لكل بيئة (يتم اختيارها عبر `DJANGO_SETTINGS_MODULE`) يفصل بشكل نظيف إعدادات محددة للبيئة مع مشاركة الإعدادات الشائعة.

## إعدادات الإنتاج الحرجة

```python
DEBUG = False                  # ❗ NEVER True in production — leaks sensitive error info
ALLOWED_HOSTS = ["example.com"] # required when DEBUG=False
SECRET_KEY = os.environ[...]    # strong, secret, from the environment
# + SECURE_SSL_REDIRECT, SESSION_COOKIE_SECURE, HSTS, etc. for hardening
```

```text
✓ NEVER commit secrets — use env vars / a secret manager; gitignore .env
✓ DEBUG=False in production (DEBUG=True leaks tracebacks, settings → security risk)
✓ Commit a .env.example documenting required variables (no real values)
```

## لماذا يهم هذا

إدارة الإعدادات عبر البيئات هي ضرورة **تشغيلية** و**ممارسة أمنية حرجة** لأي تطبيق Django حقيقي.

يجب أن تتصرف التطبيقات بشكل مختلف عبر البيئات — التطوير يحتاج `DEBUG=True` وإعدادات محلية مريحة، بينما الإنتاج يتطلب `DEBUG=False`، تقسية أمنية، قواعد بيانات حقيقية، وhosts صحيحة — وملف `settings.py` مرمز بشكل صريح واحد لا يمكن أن يخدم كل هذه.

الأهم من ذلك، هذا **مصدر قلق أمني كبير**: ترميز الأسرار (SECRET_KEY، كلمات مرور قاعدة البيانات، مفاتيح API) يرتكبها في التحكم بالإصدارات، وهو أحد أكثر الخروقات الأمنية شيوعاً وخطورة (أي شخص لديه إمكانية الوصول إلى المستودع، أو في مستودع عام، يحصل على مفاتيح تطبيقك وبياناتك).

فهم الحلول — قراءة الإعدادات والأسرار من **متغيرات البيئة** (إبقاؤها بعيداً عن الكود، نهج العوامل الاثني عشر، غالباً مع أدوات مثل django-environ وملفات `.env` المستثناة من git) و**تقسيم الإعدادات** إلى base مشترك بالإضافة إلى ملفات لكل بيئة — ضروري لنشر Django بأمان وصحة.

معرفة **إعدادات الإنتاج الحرجة** (خاصة أن `DEBUG` يجب أن يكون `False` في الإنتاج، لأن `DEBUG=True` يسرب tracebacks، مسارات المصدر، والإعدادات للمهاجمين، بالإضافة إلى `ALLOWED_HOSTS` وتقسية الأمان) غير قابلة للتفاوض لمعرفة الإنتاج.

الحصول على إدارة الإعدادات بشكل صحيح — الأسرار في البيئة، الإعدادات المناسبة للبيئة، إعدادات الإنتاج الآمنة — هو الأساس لتشغيل تطبيقات Django بشكل احترافي وتجنب الثغرات الأمنية الخطيرة التي تأتي من الأسرار المسربة أو بيئات الإنتاج المُعدّة بشكل خاطئ، مما يجعلها معرفة مهمة وحتمية عملياً لأي نشر حقيقي.