Django设置¶

基础¶

设置文件只是一个带有模块级变量的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 import search 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 加载设置。

• 从指定的设置文件加载设置，根据需要覆盖全局设置。

请注意，设置文件应该 not 从 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.

还要注意，您的代码应该从 not 从 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()