python后台架构Django教程之项目配置setting讲解

我们已经创建了一个名称为hello的项目。

一个新建立的项目结构大概如下：

hello/
    manage.py
    hello/
        __init__.py
        settings.py
        urls.py
        wsgi.py

Django项目的设置文件位于settings.py文件中。这个文件，集合了整个项目方方面面的设置属性，是项目启动和提供服务的根本保证。

ADMINS

默认值：[]（空列表）

所有获得代码错误通知的人的邮件地址列表。当DEBUG=False，并且一个视图引发了异常时,Django将会给这个列表里的人发一封含有完整异常信息的电子邮件。列表中的每个项目都应该是（全名，电子邮件地址）的元组。例如：

[(‘John’, ‘[e-mail]’), (‘Mary’, ‘[e-mail]’)]

ALLOWED_HOSTS

默认值：[]（空列表）

这是新手比较困惑的一个配置项。该配置项列表中包含的是Django站点可以为之提供服务的主机/域名。 也就是哪些主机或IP能够访问Django服务器！列表里的所有元素是共同存在的关系，不纯在冲突、优先级和排斥的关系。

列表中的值可以是localhost、www.example.com或者.example.com形式的域名。

也可以是IP地址，比如：137.2.4.1、192.168.1.1、0.0.0.0、127.0.0.1

还可以是通配符’*’，表示所有外部主机都可以访问Django。但这种情况具有安全风险，在线上环境不要使用。

对于0.0.0.0，表示局域网内的主机都可以访问Django。

当DEBUG为True和ALLOWED_HOSTS为空时，默认相当于配置：[‘localhost’， ‘127.0.0.1’， ‘[:: 1]’]。

APPEND_SLASH

默认值：True

当设定为True时，如果请求的URL没有匹配到URLconf里面的任何一条URL路由设置，并且没有以/（斜杠）结束，该请求将重定向到以请求URL加/的URL地址。需要注意的是重定向有可能导致POST提交的数据丢失。

通俗的解释就是，如果你在写url时忘记了在最后添加一个斜杠，Django会默认帮你加上！请尽量保持默认值！

APPEND_SLASH设置只有在安装了CommonMiddleware中间件时才会启用。

DATABASES

# 数据库配置
DATABASES = {
    'default': {
            'ENGINE': 'django.db.backends.mysql',  #数据库驱动名
            'NAME': 'mydatabase', #数据库名称
            'USER': 'mydatabaseuser',  # 用户名
            'PASSWORD': 'mypassword', #密码
            'HOST': '127.0.0.1', #数据库所在的主机。
            'PORT': '3306',  # 端口号
        }
}

其中ENGINE指定使用的数据库后端。 内建的数据库后端名称有：

'django.db.backends.postgresql'
'django.db.backends.mysql'
'django.db.backends.sqlite3'
'django.db.backends.oracle'

Django默认使用sqlite数据库，以文件的形式存在。当使用sqlite为数据库时只需要配置上述NAME属性为数据库文件的完整路径。指定路径时，请始终使用前向的斜杠，即使在Windows 上（例如C:/homes/user/mysite/sqlite3.db）。

DEBUG

打开/关闭调试模式。最重要的设置之一！默认值是False，你没有看错！只是在settings.py中又帮我们设置为True了，打开了调试模式，方便开发者和测试者的！线上部署网站的时候务必设置为False。

调试模式下可以显示错误页面的细节。若你的应用产生了一个异常，Django会显示追溯细节，包括许多环境变量的元数据, 比如所有当前定义的Django设置。

DEFAULT_CHARSET

默认值：’utf-8’

HttpResponse响应对象的默认字符集。

DEFAULT_CONTENT_TYPE

默认值：’text/html’

HttpResponse对象的默认内容类型。

DEFAULT_FROM_EMAIL

默认值：’webmaster@localhost’

默认的电子邮件发送地址，即发送方。

INSTALLED_APPS

Django核心配置项！

当前Django项目中启用的app列表。 每个元素应该是一个Python的点分路径，字符串格式：

项目内每个启用的app，包括Django内置的contrib都必须在这个列表里注册，否则创建数据表、调用功能等等都无法进行。

一个典型的配置如下：

# app注册
INSTALLED_APPS = [
    'app1',  #将自定义模块注册到项目中
    'app2',   #将自定义模块注册到项目中
    'django.contrib.admin',  #admin站点
    'django.contrib.auth',  #身份认证系统
    'django.contrib.contenttypes', #内容类型框架
    'django.contrib.sessions', #会话框架
    'django.contrib.messages', #消息框架
    'django.contrib.staticfiles', #静态文件管理框架
]

LANGUAGE_CODE

默认值：’en-us’

当前项目所使用的语言。默认为英语。汉语是zh-hans，千万不要写成别的，比如‘chinese’之类！

USE_I18N必须设置为True才能使LANGUAGE_CODE生效。

TIME_ZONE

默认：’America/Chicago’

时区设置。

注意，这个配置项的值不一定要和服务器的时区一致。例如，一个服务器可上可能有多个Django站点，每个站点都有一个单独的时区设置。

如果要设为中国时间，也就是北京时间，请赋值：TIME_ZONE = ‘Asia/Shanghai’。注意是上海，不是北京，囧！

当USE_TZ为False时，它将成为Django存储所有日期和时间数据时，使用的时区。 当USE_TZ为True 时，它是Django显示模板中的时间，解释表单中的日期，使用的时区。所以，通常我们都将USE_TZ同时设置为False！

注：在Windows 环境中，Django不能可靠地交替其它时区。如果你在Windows上运行Django，TIME_ZONE必须设置为与系统时区一致。

MEDIA_ROOT

默认值：”（空字符串）

用户上传的文件，所在目录的，文件系统绝对路径。也就是指示上传文件放到哪里。

例如： “/var/www/example.com/media/”

警告：MEDIA_ROOT和STATIC_ROOT必须设置为不同的值。

MEDIA_URL

默认值：”（空字符串）

MEDIA_URL指向MEDIA_ROOT所指定的media文件，用来管理保存的文件。该URL设置为非空值时，必须以斜杠“/”结束。

若你打算在模版中使用{{ MEDIA_URL }}，必须在TEMPLATES的context_processors设置中添加django.template.context_processors.media。

警告:MEDIA_URL和STATIC_URL必须设置为不同的值。

SECRET_KEY

当前Django项目实例的密钥。用于提供cryptographic签名，是一个唯一的并且不可预测的值。

TEMPLATES

Django模板系统相关的配置。列表中每一项都是一个字典类型数据（类似DATABASE配置），可以配置模板不同的功能。

示例如下

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [], #DIRS:定义了一个目录列表，模板引擎按列表顺序搜索这些目录以查找模板源文件。
        'APP_DIRS': True, #APP_DIRS:告诉模板引擎是否应该进入每个已安装的应用中查找模板。通常请将该选项保持为True。
        # OPTIONS中包含了具体的后端设置。
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

BACKEND：

默认：未指定

要使用的模板后端。 内置模板后端有：

'django.template.backends.django.DjangoTemplates'
'django.template.backends.jinja2.Jinja2'

通过将BACKEND设置为完全限定路径（即’mypackage.whatever.Backend’），你可以使用第三方提供的模板后端。

USE_I18N

默认值：True

这是一个布尔值，指定Django的翻译系统是否开启。如果设置为False，Django会做一些优化，不去加载翻译机制。

USE_L10N

默认值：False

一个布尔值，用于决定是否开启数据本地化。如果此设置为True，例如Django将使用当前语言环境的格式显示数字和日期。

USE_TZ

默认值：False

一个布尔值,用来指定是否使用指定的时区(TIME_ZONE)的时间。若为True, 则Django会使用内建的时区的时间；否则, Django将会使用本地的时间。

如果我们将TIME_ZONE设置成了Asia/Shanghai， 那么务必同时将USE_TZ改成False！

SESSION_EXPIRE_AT_BROWSER_CLOSE

默认值：False

是否在用户关闭浏览器时过期会话。

STATIC_ROOT

默认值：None

在DEBUG设置为False时，也就是线上环境时，Django项目里的静态文件（js\css\plugins）会无法使用。这是，需要运行python manage.py collectstatic，将静态文件统一收集到一个目录下。STATIC_ROOT配置的就是该目录的绝对路径。

示例：”/var/www/example.com/static/”

这个目录，刚开始应该是一个空目录。

STATIC_URL

默认值：None

引用位于STATIC_ROOT中的静态文件时使用的网址。

示例：”/static/”或”https://static.example.com/”

该URL设置为非空值时，必须以斜杠“/”结束。

WSGI_APPLICATION

默认值：None

Django的内置服务器（例如runserver）将使用的WSGI应用程序对象的完整Python路径。

Django使用WSGI协议与外部进行通信。

由django-admin startproject xxx命令创建的Django项目，将自动创建一个简单的wsgi.py模块，里面有一个可调用的application变量，WSGI_APPLICATION配置项的值就指向这个application变量。

MIDDLEWARE

要使用的中间件列表。Django-admin命令创建的新项目中，settings.py文件里默认会为MIDDLEWARE配置项添加一系列Django内置的中间件，我们保持它不变就好了。

注释掉MIDDLEWARE 中的’django.middleware.csrf.CsrfViewMiddleware’,因为这句话会进行校验，容易产生403错误。

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    #'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

添加自己的配置项

如果要添加自己的配置项，需遵循以下准则：

配置项名称必须全为大写。 不要使用一个已经存在的设置 <