基本概念¶

設定檔只是一個具有模組級別變數的 Python 模組。

以下是一些範例設定

ALLOWED_HOSTS = ["www.example.com"]
DEBUG = False
DEFAULT_FROM_EMAIL = "webmaster@example.com"

因為設定檔是 Python 模組，因此適用以下規則

• 它不允許 Python 語法錯誤。

• 它可以使用正常的 Python 語法動態指派設定。例如

  MY_SETTING = [str(i) for i in range(30)]
  

• 它可以從其他設定檔匯入值。

指定設定¶

DJANGO_SETTINGS_MODULE¶

當您使用 Django 時，您必須告訴它您正在使用哪些設定。透過使用環境變數 DJANGO_SETTINGS_MODULE 來完成此操作。

DJANGO_SETTINGS_MODULE 的值應採用 Python 路徑語法，例如 mysite.settings。請注意，設定模組應位於 Python sys.path 中。

export DJANGO_SETTINGS_MODULE=mysite.settings
django-admin runserver

set DJANGO_SETTINGS_MODULE=mysite.settings
django-admin runserver

django-admin runserver --settings=mysite.settings

import os

os.environ["DJANGO_SETTINGS_MODULE"] = "mysite.settings"

預設設定¶

Django 設定檔不必定義任何設定，如果不需要的話。每個設定都有一個合理的預設值。這些預設值位於模組 django/conf/global_settings.py 中。

以下是 Django 在編譯設定時使用的演算法

• 從 global_settings.py 載入設定。

• 從指定的設定檔載入設定，並在必要時覆寫全域設定。

請注意，設定檔不應從 global_settings 匯入，因為那是多餘的。

在 Python 程式碼中使用設定¶

在您的 Django 應用程式中，透過匯入物件 django.conf.settings 來使用設定。範例

from django.conf import settings

if settings.DEBUG:
    # Do something
    ...

請注意，django.conf.settings 不是模組，而是一個物件。因此，無法匯入個別的設定

from django.conf.settings import DEBUG  # This won't work.

另請注意，您的程式碼不應從 global_settings 或您自己的設定檔匯入。django.conf.settings 抽象化了預設設定和特定站點設定的概念；它呈現一個單一的介面。它還將使用設定的程式碼與設定的位置分離。

在執行階段變更設定¶

您不應在您的應用程式中在執行階段變更設定。例如，不要在視圖中執行此操作

from django.conf import settings

settings.DEBUG = True  # Don't do this!

您唯一應該指定設定的位置是在設定檔中。

安全性¶

因為設定檔包含敏感資訊，例如資料庫密碼，您應該盡一切努力限制對它的存取。例如，變更其檔案權限，以便只有您和您的 Web 伺服器的使用者可以讀取它。這在共用託管環境中尤其重要。

可用設定¶

如需可用設定的完整清單，請參閱 設定參考。

建立您自己的設定¶

沒有任何東西阻止您為自己的 Django 應用程式建立自己的設定，但請遵循以下準則

• 設定名稱必須全部大寫。

• 不要重新發明已經存在的設定。

對於序列的設定，Django 本身使用清單，但這只是一個慣例。

在不設定 DJANGO_SETTINGS_MODULE 的情況下使用設定¶

在某些情況下，您可能想要略過 DJANGO_SETTINGS_MODULE 環境變數。例如，如果您單獨使用範本系統，您可能不希望設定指向設定模組的環境變數。

在這些情況下，您可以手動配置 Django 的設定。透過呼叫以下程式碼來完成此操作

django.conf.settings.configure(default_settings, **settings)¶

範例

from django.conf import settings

settings.configure(DEBUG=True)

將您想要的許多關鍵字引數傳遞給 configure()，每個關鍵字引數代表一個設定及其值。每個引數名稱都應全部大寫，並且與上述設定的名稱相同。如果沒有將特定設定傳遞給 configure()，並且在稍後需要，Django 將使用預設設定值。

當您在更大的應用程式中使用框架的一部分時，以這種方式配置 Django 大部分是必要的，而且實際上是建議的。

因此，當透過 settings.configure() 配置時，Django 不會對程序環境變數進行任何修改（請參閱 TIME_ZONE 的文件，以了解通常會發生這種情況的原因）。假設在這些情況下，您已經完全控制了自己的環境。

from django.conf import settings
from myapp import myapp_defaults

settings.configure(default_settings=myapp_defaults, DEBUG=True)

settings.configure(myapp_defaults, DEBUG=True)

from django.conf import settings

if not settings.configured:
    settings.configure(myapp_defaults, DEBUG=True)

import django
from django.conf import settings
from myapp import myapp_defaults

settings.configure(default_settings=myapp_defaults, DEBUG=True)
django.setup()

# Now this script or any imported module can use any part of Django it needs.
from myapp import models

if __name__ == "__main__":
    import django

    django.setup()