警告
当你覆盖配置时要小心,特别是当默认值是一个非空的列表或字典时,如 STATICFILES_FINDERS
。确保你保留了你希望使用的 Django 功能所需要的组件。
下面是 Django 核心中可用的配置及其默认值的列表。下面列出了 contrib 应用提供的设置,后面是核心配置的专题索引。关于介绍性资料,请看 配置专题指南。
ABSOLUTE_URL_OVERRIDES
¶默认: {}
(空字典)
将 "app_label.model_name"
字符串映射到接受模型对象并返回其 URL 的函数的字典。这是一种在每个预安装基础上插入或覆盖 get_absolute_url()
方法的方式。例如:
ABSOLUTE_URL_OVERRIDES = {
"blogs.blog": lambda o: "/blogs/%s/" % o.slug,
"news.story": lambda o: "/stories/%s/%s/" % (o.pub_year, o.slug),
}
在此配置中使用的模型名称应全部为小写,与实际模型类名称的大小写无关。
ADMINS
¶默认: []
(空列表)
所有收到代码错误通知的人的列表。当 DEBUG=False
和 AdminEmailHandler
中设置了 LOGGING
时(默认情况下是这样做的),Django 会将请求/响应周期中出现的异常的详细信息通过邮件发送给这些人。
列表中的每个项目应该是一个元组 (全名, 电子邮件地址)。例如:
[("John", "john@example.com"), ("Mary", "mary@example.com")]
ALLOWED_HOSTS
¶默认: []
(空列表)
一个代表这个 Django 网站可以服务的主机/域名的字符串列表。这是一个安全措施,以防止 HTTP 主机头攻击 ,即使在许多看似安全的 Web 服务器配置下也有可能发生。
这个列表中的值可以是完全限定的名称(例如 'www.example.com
),在这种情况下,它们将与请求的 Host
头完全匹配(不区分大小写,不包括端口)。以英文句号开头的值可以用作子域通配符。'.example.com'
将匹配 example.com
、www.example.com
和 example.com
的任何其他子域。'*'
的值将匹配任何东西;在这种情况下,你要负责提供你自己的 Host
头的验证(也许是在一个中间件中;如果是这样,这个中间件必须首先在 MIDDLEWARE
中列出)。
Django 也允许在任何条目中使用 完全合格的域名(FQDN) 。有些浏览器在 Host
头中包含了一个尾部的点,Django 在执行主机验证时将其去掉。
如果 Host
头(或者 X-Forwarded-Host
如果 USE_X_FORWARDED_HOST
被启用的话)不符合这个列表中的任何值,则 django.http.HttpRequest.get_host()
方法将引发 SuspiciousOperation
。
当 DEBUG`为``True`
和 ALLOWED_HOSTS
为空时,主机将根据 ['.localhost', '127.0.0.1', '[::1]']
进行验证。
ALLOWED_HOSTS
也是 在运行测试时进行检查的。
这些验证仅通过 get_host()
来实现;如果你的代码直接从 request.META
得到 Host
头部,你就绕过了这种安全保护机制。
APPEND_SLASH
¶默认: True
当设置为 True
时,如果请求的 URL 不符合 URLconf 中的任何模式,并且不以斜线结尾,则会发出一个 HTTP 重定向到相同的URL,并附加一个斜线。注意,重定向可能会导致 POST 请求中提交的任何数据丢失。
APPEND_SLASH
的配置只有在安装了 CommonMiddleware
的情况下才会使用(参见 中间件)。也请参见 PREPEND_WWW
。
CACHES
¶默认:
{
"default": {
"BACKEND": "django.core.cache.backends.locmem.LocMemCache",
}
}
一个包含所有 Django 缓存配置的字典。它是一个嵌套的字典,其内容将缓存别名映射到一个包含单个缓存选项的字典中。
CACHES
配置必须设置一个 default
缓存;也可以指定任何数量的附加缓存。如果你使用的是本地内存缓存以外的缓存后端,或者你需要定义多个缓存,则需要其他选项。以下是可用的缓存选项。
BACKEND
¶默认: ''
(空字符串)
要使用的缓存后端。内置的缓存后端有:
'django.core.cache.backends.db.DatabaseCache'
'django.core.cache.backends.dummy.DummyCache'
'django.core.cache.backends.filebased.FileBasedCache'
'django.core.cache.backends.locmem.LocMemCache'
'django.core.cache.backends.memcached.PyMemcacheCache'
'django.core.cache.backends.memcached.PyLibMCCache'
'django.core.cache.backends.redis.RedisCache'
你可以通过将 :set:`BACKEND <CACHES-BACKEND>` 设置为一个完全限定的缓存后端类的路径(例如 mypackage.backends.whatever.WhateverCache
),来使用一个不在 Django 中的缓存后端。
KEY_FUNCTION
¶一个字符串,包含一个指向函数(或任何可调用)的点分隔路径,定义如何将前缀、版本和密钥组成一个最终的缓存密钥。默认的实现相当于函数:
def make_key(key, key_prefix, version):
return ":".join([key_prefix, str(version), key])
你可以使用任何你想要的密钥函数,只要它有相同的参数签名。
查看 缓存文档 获取更多信息。
LOCATION
¶默认: ''
(空字符串)
要使用的高速缓存的位置。可能是文件系统缓存的目录,memcache 服务器的主机和端口,或者是本地内存缓存的识别名称,例如:
CACHES = {
"default": {
"BACKEND": "django.core.cache.backends.filebased.FileBasedCache",
"LOCATION": "/var/tmp/django_cache",
}
}
TIMEOUT
¶默认: 300
The number of seconds before a cache entry is considered stale. If the value of
this setting is None
, cache entries will not expire. A value of 0
causes keys to immediately expire (effectively "don't cache").
CACHE_MIDDLEWARE_KEY_PREFIX
¶默认: ''
(空字符串)
由 缓存中间件 生成的缓存密钥前缀的字符串。这个前缀与 KEY_PREFIX
的配置结合在一起,而不是取代它。
参见 Django 缓存框架。
CSRF_COOKIE_AGE
¶默认: 31449600
(约 1 年,以秒为单位)
CSRF cookie 的寿命,以秒为单位。
设置长效过期时间的原因是为了避免在用户关闭浏览器或将某一页面作为书签,然后从浏览器缓存中加载该页面时出现问题。如果没有持久性 Cookie,这种情况下表单提交会失败。
一些浏览器(特别是 Internet Explorer)可能不允许使用持久性 cookie,或可能使 cookie jar 的索引在磁盘上损坏,从而导致 CSRF 保护检查(有时是间歇性的)失败。将此设置改为 None
,以使用基于会话的 CSRF cookie,它将 cookie 保存在内存中,而不是持久性存储中。
CSRF_COOKIE_DOMAIN
¶默认: None
设置 CSRF cookie 时要使用的域。 这对于允许跨子域请求被排除在正常的跨站点请求伪造保护之外是很有用的。 它应该设置为一个字符串,如 ".example.com"
,以允许一个子域上的表单的 POST 请求被另一个子域的视图所接受。
请注意,这个配置的存在并不意味着 Django 的 CSRF 保护在默认情况下是安全的,不会受到跨子域的攻击——请参见 CSRF 限制 部分。
CSRF_COOKIE_HTTPONLY
¶默认:False
是否对 CSRF cookie 使用 HttpOnly
标志。如果设置为 True
,客户端的 JavaScript 将无法访问 CSRF cookie。
将 CSRF cookie 指定为 HttpOnly
并不能提供任何实际的保护,因为 CSRF 只是为了防止跨域攻击。如果攻击者可以通过 JavaScript 读取 cookie,就浏览器所知,他们已经在同一个域上了,所以他们可以做任何他们喜欢的事情。(XSS 是一个比 CSRF 更大的漏洞)。
虽然这种配置没有提供什么实际的好处,但有时也会被安全审计人员要求。
如果你启用了这个功能,并且需要通过 AJAX 请求发送 CSRF 标记的值,你的 JavaScript 必须 从隐藏的 CSRF 标记表单输入 中提取值而不是 从 cookie。
关于 HttpOnly
的详细信息,请参见 SESSION_COOKIE_HTTPONLY
。
CSRF_COOKIE_MASKED
¶默认:False
Whether to mask the CSRF cookie. See release notes for usage details.
4.1 版后已移除: This transitional setting is deprecated and will be removed in Django 5.0.
CSRF_COOKIE_NAME
¶默认: 'csrftoken'
用于 CSRF 认证令牌的 cookie 的名称。这可以是任何你想要的名字(只要它与你的应用程序中的其他 cookie 名字不同)。参见 跨站请求伪造保护。
CSRF_COOKIE_PATH
¶默认: '/'
在 CSRF cookie 上设置的路径。这个路径应该与你的 Django 安装的 URL 路径相匹配,或者是该路径的父路径。
如果你有多个 Django 实例在同一个主机名下运行,这个功能很有用。他们可以使用不同的 cookie 路径,而且每个实例只能看到自己的 CSRF cookie。
CSRF_COOKIE_SAMESITE
¶默认: 'Lax'
CSRF cookie 上 SameSite 标志的值。该标志可防止在跨站点请求中发送 cookie。
关于 SameSite
的详细信息,请参见 SESSION_COOKIE_SAMESITE
。
CSRF_COOKIE_SECURE
¶默认:False
是否为 CSRF cookie 使用安全 cookie。如果设置为 True
,cookie 将被标记为 安全
,这意味着浏览器可以确保 cookie 只在 HTTPS 连接下发送。
CSRF_USE_SESSIONS
¶默认:False
是否将 CSRF 标记存储在用户的会话中,而不是 cookie 中。这需要使用 django.contrib.session
。
将 CSRF 令牌存储在 cookie 中(Django 的默认值)是安全的,但将其存储在 session 中是其他 Web 框架的常见做法,因此有时会被安全审计人员要求。
由于 默认错误视图 需要CSRF令牌,所以 SessionMiddleware
必须出现在 MIDDLEWARE
中,在任何可能引发异常以触发错误视图的中间件(如 PermissionDenied
)之前,如果你正在使用 CSRF_USE_SESSIONS
。参见 中间件顺序。
CSRF_FAILURE_VIEW
¶默认: 'django.views.csrf.csrf_failure'
当传入的请求被 CSRF 保护 拒绝时,要使用的视图函数的点分隔路径。该函数应具有以下签名:
def csrf_failure(request, reason=""):
...
其中 reason
是一个简短的消息(针对开发者或日志记录,而不是针对终端用户),表示请求被拒绝的原因,它应该返回一个 HttpResponseForbidden
。
django.views.csrf.csrf_failure()
接受一个额外的 template_name
参数,默认为 '403_csrf.html'
。如果存在该名称的模板,它将被用来渲染页面。
CSRF_HEADER_NAME
¶默认: 'HTTP_X_CSRFTOKEN'
用于 CSRF 认证的请求头的名称。
与 request.META
中的其他 HTTP 头文件一样,从服务器接收到的头文件名通过将所有字符转换为大写字母,用下划线代替任何连字符,并在名称中添加 'HTTP_'
前缀进行规范化。例如,如果你的客户端发送了一个 'X-XSRF-TOKEN'
头,配置应该是 'HTTP_X_XSRF_TOKEN'
。
CSRF_TRUSTED_ORIGINS
¶默认: []
(空列表)
A list of trusted origins for unsafe requests (e.g. POST
).
For requests that include the Origin
header, Django's CSRF protection
requires that header match the origin present in the Host
header.
For a secure
unsafe
request that doesn't include the Origin
header, the request must have a
Referer
header that matches the origin present in the Host
header.
These checks prevent, for example, a POST
request from
subdomain.example.com
from succeeding against api.example.com
. If you
need cross-origin unsafe requests, continuing the example, add
'https://subdomain.example.com'
to this list (and/or http://...
if
requests originate from an insecure page).
The setting also supports subdomains, so you could add
'https://*.example.com'
, for example, to allow access from all subdomains
of example.com
.
DATABASES
¶默认: {}
(空字典)
一个包含所有数据库配置的字典,用于 Django。它是一个嵌套的字典,其内容是将一个数据库别名映射到一个包含单个数据库选项的字典中。
DATABASES
配置必须设置一个 default
数据库;也可以指定任何数量的其他数据库。
最简单的配置文件是使用 SQLite 的单数据库配置。可以通过以下方式进行配置:
DATABASES = {
"default": {
"ENGINE": "django.db.backends.sqlite3",
"NAME": "mydatabase",
}
}
当连接到其他数据库后端时,如 MariaDB、MySQL、Oracle 或 PostgreSQL,将需要额外的连接参数。请参阅下面的 ENGINE
配置,了解如何指定其他数据库类型。这个例子是针对 PostgreSQL:
DATABASES = {
"default": {
"ENGINE": "django.db.backends.postgresql",
"NAME": "mydatabase",
"USER": "mydatabaseuser",
"PASSWORD": "mypassword",
"HOST": "127.0.0.1",
"PORT": "5432",
}
}
以下是更复杂配置可能需要的内部选项:
ENGINE
¶默认: ''
(空字符串)
要使用的数据库后端。内置的数据库后端有:
'django.db.backends.postgresql'
'django.db.backends.mysql'
'django.db.backends.sqlite3'
'django.db.backends.oracle'
你可以通过将 ENGINE
设置为一个完全限定的路径(例如: mypackage.backends.whatever
),来使用一个不在 Django 中的数据库后端。
HOST
¶默认: ''
(空字符串)
连接到数据库时使用的主机。空字符串表示本地主机。不用于 SQLite。
如果这个值以斜线('/'
)开头,并且你正在使用 MySQL,MySQL 将通过 Unix 套接字连接到指定的套接字。例如:
"HOST": "/var/run/mysql"
如果你使用的是 MySQL,并且这个值 没有 以斜线开头,那么这个值被认为是主机。
如果你使用的是 PostgreSQL,默认情况下(空 HOST
),与数据库的连接是通过 UNIX 域套接字(pg_hba.conf
中的 'local' )完成的。如果你的 UNIX 域套接字不在标准位置,请使用 postgresql.conf
中的 unix_socket_directory
的相同值。如果你想通过 TCP 套接字连接,将 HOST
设置为 'localhost' 或 '127.0.0.1'(pg_hba.conf
中的 'host' 行)。在 Windows 上,你应该总是定义 HOST
,因为 UNIX 域套接字是不可用的。
NAME
¶默认: ''
(空字符串)
要使用的数据库的名称。对于 SQLite,它是数据库文件的完整路径。当指定路径时,总是使用斜线,即使在 Windows 上也是如此(例如 C:/homes/user/mysite/sqlite3.db
)。
CONN_MAX_AGE
¶默认: 0
The lifetime of a database connection, as an integer of seconds. Use 0
to
close database connections at the end of each request — Django's historical
behavior — and None
for unlimited persistent database connections.
CONN_HEALTH_CHECKS
¶默认:False
If set to True
, existing persistent database connections will be health checked before they are
reused in each request performing database access. If the health check fails,
the connection will be reestablished without failing the request when the
connection is no longer usable but the database server is ready to accept and
serve new connections (e.g. after database server restart closing existing
connections).
OPTIONS
¶默认: {}
(空字典)
连接到数据库时要使用的额外参数。可用的参数根据你的数据库后端不同而不同。
关于可用参数的一些信息可以在 数据库后端 文档中找到。更多信息,请查阅你的后端模块自己的文档。
TIME_ZONE
¶默认: None
代表该数据库连接时区的字符串或 None
。DATABASES
配置的这个内部选项与一般的 TIME_ZONE
配置接受相同的值。
当 USE_TZ
为 True
且设置了这个选项时,从数据库中读取日期时间会返回这个时区的感知日期时间,而不是 UTC。当 USE_TZ
为 False
时,设置该选项是错误的。
如果数据库后端不支持时区(如 SQLite、MySQL、Oracle),如果设置了这个选项,Django 会根据这个选项以当地时间读写日期,如果没有设置,则以 UTC 时间读写。
改变连接时区会改变从数据库中读取和写入日期的方式。
如果数据库后端支持时区(如 PostgreSQL),很少需要 TIME_ZONE
选项。它可以在任何时候改变;数据库会负责将日期时间转换为所需的时区。
设置数据库连接的时区对于运行涉及数据库提供的日期/时间函数的原始 SQL 查询(如 date_trunc
)可能很有用,因为其结果取决于时区。
However, this has a downside: receiving all datetimes in local time makes datetime arithmetic more tricky — you must account for possible offset changes over DST transitions.
考虑在原始 SQL 查询中使用 AT TIME ZONE
明确转换为当地时间,而不是设置 TIME_ZONE
选项。
DISABLE_SERVER_SIDE_CURSORS
¶默认:False
如果你想通过 QuerySet.iterator()
禁用服务器端游标的使用,请将其设置为 True
。 事务池和服务器端游标 描述了使用情况。
这是 PostgreSQL 特有的配置。
TEST
¶默认: {}
(空字典)
测试数据库的设置字典;关于测试数据库的创建和使用的更多细节,见 测试数据库。
下面是一个测试数据库配置的例子:
DATABASES = {
"default": {
"ENGINE": "django.db.backends.postgresql",
"USER": "mydatabaseuser",
"NAME": "mydatabase",
"TEST": {
"NAME": "mytestdatabase",
},
},
}
TEST
字典中的下列键可供使用:
CHARSET
¶默认: None
用于创建测试数据库的字符集编码。这个字符串的值是直接传递给数据库的,所以它的格式是特定于后端的。
由 PostgreSQL (postgresql
)和 MySQL (mysql
)后端支持。
MIRROR
¶默认: None
The alias of the database that this database should mirror during
testing. It depends on transactions and therefore must be used within
TransactionTestCase
instead of
TestCase
.
该配置允许测试多个数据库的主/副本(某些数据库称为主/从)配置。详情请参见 测试主/副本配置 的文档。
NAME
¶默认: None
运行测试套件时要使用的数据库名称。
如果 SQLite 数据库引擎使用默认值(None
),则测试将使用内存常驻数据库。对于所有其他数据库引擎,测试数据库将使用 'test_' + DATABASE_NAME
的名称。
查看 测试数据库。
SERIALIZE
¶布尔值,用于控制默认的测试运行器是否在运行测试之前将数据库序列化为内存中的 JSON 字符串(如果没有事务,用于在测试之间恢复数据库状态)。如果你没有任何带有 serialized_rollback=True 的测试类,你可以将其设置为 False
以加快创建时间。
4.0 版后已移除: This setting is deprecated as it can be inferred from the
databases
with the
serialized_rollback option enabled.
TBLSPACE_TMP
¶默认: None
这是 Oracle 特有的配置。
运行测试时使用的临时表空间的名称。如果没有提供,Django 将使用 'test_' + USER + '_temp'
。
DATAFILE_TMP
¶默认: None
这是 Oracle 特有的配置。
TBLSPACE_TMP 的数据文件名。如果没有提供,Django 将使用 TBLSPACE_TMP + '.dbf'
。
DATA_UPLOAD_MAX_MEMORY_SIZE
¶默认: 2621440
(即 2.5 MB)。
请求体在引发 SuspiciousOperation
(RequestDataTooBig
)之前的最大字节数。这个检查是在访问 request.body
或 request.POST
时进行的,是根据请求的总大小计算的,不包括任何文件上传数据。你可以将其设置为 None
以禁用该检查。预计会收到非常大的上传表单的应用程序应该调整这个配置。
请求数据的数量与处理请求和填充 GET 和 POST 字典所需的内存量相关。如果不进行检查,大的请求可能会被用作拒绝服务的攻击载体。由于 Web 服务器通常不会进行深层的请求检查,所以不可能在这个层面进行类似的检查。
DATA_UPLOAD_MAX_NUMBER_FIELDS
¶默认: 1000
在发生 SuspiciousOperation
(TooManyFields
)之前,可以通过 GET 或 POST 接收到的参数的最大数量。你可以将其设置为 None
来禁用该检查。预计会收到异常多的表单字段的应用程序应该调整这个配置。
请求参数的数量与处理请求和填充 GET 和 POST 字典所需的时间有关。如果不加以检查,大的请求可能会被用作拒绝服务攻击的载体。由于 Web 服务器通常不会进行深层的请求检查,所以不可能在这个层面进行类似的检查。
DATA_UPLOAD_MAX_NUMBER_FILES
¶Default: 100
The maximum number of files that may be received via POST in a
multipart/form-data
encoded request before a
SuspiciousOperation
(TooManyFiles
) is
raised. You can set this to None
to disable the check. Applications that
are expected to receive an unusually large number of file fields should tune
this setting.
The number of accepted files is correlated to the amount of time and memory needed to process the request. Large requests could be used as a denial-of-service attack vector if left unchecked. Since web servers don't typically perform deep request inspection, it's not possible to perform a similar check at that level.
DATE_FORMAT
¶默认: 'N j, Y'
(例如 Feb. 4, 2003
)
在系统的任何部分显示日期字段时使用的默认格式。请注意,如果 USE_L10N
被设置为 True
,那么本地决定的格式具有更高的优先权,并将被应用。参见 允许的日期格式字符串
。
DATE_INPUT_FORMATS
¶默认:
[
"%Y-%m-%d", # '2006-10-25'
"%m/%d/%Y", # '10/25/2006'
"%m/%d/%y", # '10/25/06'
"%b %d %Y", # 'Oct 25 2006'
"%b %d, %Y", # 'Oct 25, 2006'
"%d %b %Y", # '25 Oct 2006'
"%d %b, %Y", # '25 Oct, 2006'
"%B %d %Y", # 'October 25 2006'
"%B %d, %Y", # 'October 25, 2006'
"%d %B %Y", # '25 October 2006'
"%d %B, %Y", # '25 October, 2006'
]
在日期字段上输入数据时接受的格式列表。格式将按顺序被尝试,使用第一个有效的格式。注意这些格式字符串使用 Python 的 datetime 模块语法,而不是来自 date
模板过滤器的格式字符串。
当 USE_L10N
为 True
时,将采用本地规定的格式,具有更高的优先权。
DATETIME_FORMAT
¶默认: 'N j, Y, P'
(例如 Feb. 4, 2003, 4 p.m.
)
在系统的任何部分显示日期时间字段时使用的默认格式。请注意,如果 USE_L10N
被设置为 True
,那么本地决定的格式具有更高的优先权,并将被应用。参见 允许的日期格式字符串
。
DATETIME_INPUT_FORMATS
¶默认:
[
"%Y-%m-%d %H:%M:%S", # '2006-10-25 14:30:59'
"%Y-%m-%d %H:%M:%S.%f", # '2006-10-25 14:30:59.000200'
"%Y-%m-%d %H:%M", # '2006-10-25 14:30'
"%m/%d/%Y %H:%M:%S", # '10/25/2006 14:30:59'
"%m/%d/%Y %H:%M:%S.%f", # '10/25/2006 14:30:59.000200'
"%m/%d/%Y %H:%M", # '10/25/2006 14:30'
"%m/%d/%y %H:%M:%S", # '10/25/06 14:30:59'
"%m/%d/%y %H:%M:%S.%f", # '10/25/06 14:30:59.000200'
"%m/%d/%y %H:%M", # '10/25/06 14:30'
]
在日期时间字段上输入数据时可接受的格式列表。格式将按顺序被尝试,使用第一个有效的格式。注意这些格式字符串使用 Python 的 datetime 模块语法,而不是 date
模板过滤器的格式字符串。纯日期格式不包括在内,因为日期时间字段会在最后时刻自动尝试 DATE_INPUT_FORMATS
。
当 USE_L10N
为 True
时,将采用本地规定的格式,具有更高的优先权。
DEBUG
¶默认:False
一个开启、关闭调试模式的布尔值。
永远不要在 DEBUG
开启的情况下将网站部署到生产中。
调试模式的主要功能之一是显示详细的错误页面。如果你的应用程序在 DEBUG
为 True
时引发了异常,Django 会显示一个详细的回溯,包括很多关于你的环境的元数据,比如所有当前定义的 Django 配置(来自 settings.py
)。
作为一项安全措施,Django将 不 包含可能是敏感的配置,如 SECRET_KEY
。具体来说,它将排除任何名称中包含以下内容的配置。
'API'
'KEY'
'PASS'
'SECRET'
'SIGNATURE'
'TOKEN'
请注意,这些是 部分 匹配。'PASS'
也将与 PASSWORD 匹配,正如 'TOKEN'
也将与 TOKENIZED 匹配,以此类推。
不过,请注意,你的调试输出中总会有一些部分是不适合公开的。文件路径、配置选项等都会给攻击者提供关于你的服务器的额外信息。
同样重要的是,当 DEBUG
开启时,Django 会记住它执行的每个 SQL 查询。这在调试时很有用,但在生产服务器上会迅速消耗内存。
最后,如果 DEBUG
为 False
,还需要正确设置 ALLOWED_HOSTS
配置。否则,所有的请求都会以 “Bad Request (400) ” 返回。
备注
默认的 settings.py
文件由 django-admin startproject
创建,为了方便,设置 DEBUG = True
。
DEBUG_PROPAGATE_EXCEPTIONS
¶默认:False
If set to True
, Django's exception handling of view functions
(handler500
, or the debug view if DEBUG
is True
) and logging of 500 responses (django.request) is
skipped and exceptions propagate upward.
这对于一些测试配置是有用的。除非你想让你的 web 服务器(而不是 Django)生成“内部服务器错误”的响应,否则它不应该被用于实时站点。在这种情况下,确保你的服务器不会在响应中显示堆栈跟踪或其他敏感信息。
DECIMAL_SEPARATOR
¶默认: '.'
(点)
格式化小数时使用的默认小数分隔符。
请注意,如果 USE_L10N
设置为 True
,那么将采用本地决定的格式,具有更高的优先权。
另见 NUMBER_GROUPING
、THOUSAND_SEPARATOR
和 USE_THOUSAND_SEPARATOR
。
DEFAULT_EXCEPTION_REPORTER
¶默认: '
django.views.debug.ExceptionReporter
'
如果还没有为 HttpRequest
实例分配任何异常报告类,则使用默认的异常报告类。参见 自定义错误报告。
DEFAULT_EXCEPTION_REPORTER_FILTER
¶默认: '
django.views.debug.SafeExceptionReporterFilter
'
如果还没有为 HttpRequest
实例分配任何异常报告过滤类,则使用默认的异常报告过滤类。参见 过滤错误报告。
DEFAULT_FILE_STORAGE
¶默认: '
django.core.files.storage.FileSystemStorage
'
默认的文件存储类,用于任何与文件相关的操作,不指定特定的存储系统。参见 管理文件。
4.2 版后已移除: This setting is deprecated. Starting with Django 4.2, default file storage
engine can be configured with the STORAGES
setting under the
default
key.
DEFAULT_FROM_EMAIL
¶默认: 'webmaster@localhost'
默认电子邮件地址,用于网站管理员的各种自动通信。这不包括发送到 ADMINS
和 MANAGERS
的错误信息;关于这一点,请参见 SERVER_EMAIL
。
DISALLOWED_USER_AGENTS
¶默认: []
(空列表)
编译后的正则表达式对象列表,代表全系统范围内不允许访问任何页面的 User-Agent 字符串。用于机器人/爬虫。只有在安装了 CommonMiddleware
的情况下才会使用(参见 中间件)。
EMAIL_HOST_PASSWORD
¶默认: ''
(空字符串)
在 EMAIL_HOST
中定义的 SMTP 服务器使用的密码。这个配置和 EMAIL_HOST_USER
中的密码一起使用。如果这两个配置中的任何一个为空,Django 就不会尝试验证。
另见 EMAIL_HOST_USER
。
EMAIL_SUBJECT_PREFIX
¶默认: '[Django] '
用 django.core.mail.mail_admins
或 django.core.mail.mail_managers
发送邮件的主题行前缀。你可能会想要包含尾部的空格。
EMAIL_USE_TLS
¶默认:False
与 SMTP 服务器对话时是否使用 TLS(安全)连接。这用于显式 TLS 连接,一般在 587 端口。如果你遇到挂起的连接,请查看隐式 TLS 配置 EMAIL_USE_SSL
。
EMAIL_USE_SSL
¶默认:False
与 SMTP 服务器对话时是否使用隐式 TLS(安全)连接。在大多数电子邮件文档中,这种类型的 TLS 连接被称为 SSL。它通常在 465 端口使用。如果你遇到问题,请查看显式 TLS 配置 EMAIL_USE_TLS
。
注意 EMAIL_USE_TLS
/ EMAIL_USE_SSL
是相互排斥的,所以只能将其中一个设置为 True
。
EMAIL_SSL_CERTFILE
¶默认: None
如果 EMAIL_USE_SSL
或 EMAIL_USE_TLS
是 True
,你可以选择指定一个 PEM 格式的证书链文件的路径,用于 SSL 连接。
EMAIL_SSL_KEYFILE
¶默认: None
如果 EMAIL_USE_SSL
或 EMAIL_USE_TLS
为 True
,你可以选择性地指定用于 SSL 连接的 PEM 格式化私钥文件的路径。
请注意,设置 EMAIL_SSL_CERTFILE
和 EMAIL_SSL_KEYFILE
不会导致任何证书检查。它们被传递给底层的 SSL 连接。请参考 Python 的 ssl.wrap_socket()
函数的文档,了解如何处理证书链文件和私钥文件。
FILE_UPLOAD_HANDLERS
¶默认:
[
"django.core.files.uploadhandler.MemoryFileUploadHandler",
"django.core.files.uploadhandler.TemporaryFileUploadHandler",
]
上传过程中使用的处理程序列表。改变这个配置可以完全自定义——甚至替换——Django 的上传过程。
详情参见 管理文件。
FILE_UPLOAD_DIRECTORY_PERMISSIONS
¶默认: None
适用于上传文件过程中创建的目录的数字模式。
当使用 collectstatic
管理命令时,这个配置也决定了收集的静态目录的默认权限。覆盖它的细节请参见 collectstatic
。
这个值反映了 FILE_UPLOAD_PERMISSIONS
配置的功能和注意事项。
FILE_UPLOAD_PERMISSIONS
¶默认: 0o644
设置新上传文件的数字模式(即 0o644
)。关于这些模式的更多信息,请参见 os.chmod()
的文档。
如果 None
,你会得到操作系统依赖的行为。在大多数平台上,临时文件的模式为 0o600
,从内存中保存的文件将使用系统的标准 umask 保存。
出于安全考虑,这些权限不应用于存储在 FILE_UPLOAD_TEMP_DIR
中的临时文件。
当使用 collectstatic
管理命令时,这个配置也决定了收集的静态文件的默认权限。覆盖它的细节请参见 collectstatic
。
警告
总是在模式前加上 **`0o` 。**
如果你不熟悉文件模式,请注意 0o
的前缀是非常重要的:它表示一个八进制数,这就是模式必须被指定的方式。如果你试图使用 644
,你会得到完全错误的行为。
FILE_UPLOAD_TEMP_DIR
¶默认: None
上传文件时要临时存储数据的目录(一般是大于 FILE_UPLOAD_MAX_MEMORY_SIZE
的文件)。如果 None
,Django 将使用操作系统的标准临时目录。例如,在 *nix 风格的操作系统上,会默认为 /tmp
。
详情参见 管理文件。
FIRST_DAY_OF_WEEK
¶默认: 0
(星期日)
代表一周第一天的数字。这在显示日历时特别有用。该值仅在不使用格式国际化时使用,或者当无法为当前语言环境找到格式时使用。
该值必须是 0 到 6 的整数,其中 0 代表周日,1 代表周一,以此类推。
FIXTURE_DIRS
¶默认: []
(空列表)
List of directories searched for fixture files,
in addition to the fixtures
directory of each application, in search order.
请注意,这些路径应该使用 Unix 风格的斜线,即使在 Windows 上也是如此。
参见 使用固定数据提供数据 和 辅助工具加载。
FORCE_SCRIPT_NAME
¶默认: None
如果不是 None
,将作为任何 HTTP 请求中 SCRIPT_NAME
环境变量的值。这个设置可以用来覆盖服务器提供的 SCRIPT_NAME
的值,这个值可能是首选值的重写版本,也可能根本没有提供。它还被 django.setup()
用来在请求/响应周期之外设置 URL 解析器脚本前缀(例如在管理命令和独立脚本中),以便在 SCRIPT_NAME
不是 /
时生成正确的 URL。
FORM_RENDERER
¶默认: '
django.forms.renderers.DjangoTemplates
'
The class that renders forms and form widgets. It must implement the low-level render API. Included form renderers are:
FORMAT_MODULE_PATH
¶默认: None
一个 Python 包的完整 Python 路径,该 Python 包包含了项目 locale 的自定义格式定义。如果不是 None
,Django 将检查当前 locale 目录下的 formats.py
文件,并将使用该文件中定义的格式。
For example, if FORMAT_MODULE_PATH
is set to mysite.formats
,
and current language is en
(English), Django will expect a directory tree
like:
mysite/
formats/
__init__.py
en/
__init__.py
formats.py
你也可以将此设置为 Python 路径列表,例如:
FORMAT_MODULE_PATH = [
"mysite.formats",
"some_app.formats",
]
当 Django 搜索某个格式时,它将通过所有给定的 Python 路径,直到找到一个真正定义该格式的模块。这意味着在列表中较远处的包中定义的格式将优先于较远处的包中的格式。
可用格式:
IGNORABLE_404_URLS
¶默认: []
(空列表)
编译的正则表达式对象列表,这些对象描述了在通过电子邮件报告 HTTP 404 错误时应该被忽略的 URL(参见 如何管理错误报告)。正则表达式与 request 的完整路径
(包括查询字符串,如果有的话)进行匹配。如果你的网站没有提供常用的请求文件,如 favicon.ico
或 robots.txt
,请使用此选项。
只有当 BrokenLinkEmailsMiddleware
被启用时,才会使用这个功能(参见 中间件)。
INSTALLED_APPS
¶默认: []
(空列表)
一个字符串的列表,表示在这个 Django 安装中所有被启用的应用程序。每一个字符串都应该是一个 Python 的点分隔路径。
使用应用程序注册进行自省
你的代码不应该直接访问 INSTALLED_APPS
。使用 django.apps.apps
代替。
在 INSTLED_APPS
中,应用程序名称和标签必须是唯一的。
应用程序 名称
——指向应用程序包的点分隔 Python 路径——必须是唯一的。没有办法将同一个应用程序包含两次,除非用另一个名字复制它的代码。
应用程序 标签
——默认情况下,名称的最后一部分也必须是唯一的。例如,你不能同时包含 django.contrib.auth
和 myproject.auth
。但是,你可以用自定义配置重新标注一个应用程序,定义不同的 label
。
无论 INSTALLED_APPS
引用的是应用程序配置类还是应用包,这些规则都适用。
当多个应用程序提供同一资源的不同版本(模板、静态文件、管理命令、翻译)时, INSTALLED_APPS
中排在第一位的应用程序具有优先权。
INTERNAL_IPS
¶默认: []
(空列表)
一个 IP 地址的列表,作为字符串,它:
debug()
上下文处理器为模板上下文添加一些变量。AdminEmailHandler
邮件中被标记为“internal”(与 “EXTERNAL”相对)。LANGUAGE_CODE
¶默认: 'en-us'
代表本次安装的语言代码的字符串。这应该是标准的 language ID 格式。例如,美国英语是 "en-us"
。也请参见 语言标识符列表 和 国际化和本地化。
:setting:`USE_I18N' 必须是激活状态,该配置才会有效果。
它有两个作用:
更多细节请参考 Django 如何发现语言偏好。
LANGUAGE_COOKIE_DOMAIN
¶默认: None
语言 cookie 使用的域。将其设置为一个字符串,如 "example.com"
用于跨域 cookie,或使用 None
用于标准域 cookie。
在生产型网站上更新此配置时要谨慎。如果你更新此配置,在以前使用标准域 cookie 的网站上启用跨域 cookie,则现有的具有旧域的用户 cookie 将不会被更新。这将导致网站用户无法切换语言,只要这些 cookie 持续存在。执行切换的唯一安全可靠的方案是永久更改语言 cookie 名称(通过 LANGUAGE_COOKIE_NAME
设置),并添加一个中间件,将旧 cookie 的值复制到新 cookie 中,然后删除旧 cookie。
LANGUAGE_COOKIE_HTTPONLY
¶默认:False
是否对语言 cookie 使用 HttpOnly
标志。如果设置为 True
,客户端的 JavaScript 将无法访问语言 cookie。
关于 HttpOnly
的详细信息,请参见 SESSION_COOKIE_HTTPONLY
。
LANGUAGE_COOKIE_NAME
¶默认: 'django_language'
用于语言 cookie 的 cookie 名称。这可以是任何你想要的(只要它与你的应用程序中的其他 cookie 名称不同)。参见 国际化和本地化。
LANGUAGE_COOKIE_PATH
¶默认: '/'
语言 cookie 上设置的路径。这个路径应该与你的 Django 安装的 URL 路径相匹配,或者是该路径的父路径。
如果你有多个 Django 实例在同一个主机名下运行,这个功能很有用。他们可以使用不同的 cookie 路径,每个实例只能看到自己的语言 cookie。
在生产型网站上更新此配置时要谨慎。如果你更新此配置,使用比以前更深的路径,则现有的用户 cookie 的旧路径将不会被更新。这将导致网站用户无法切换语言,只要这些 cookie 持续存在。执行切换的唯一安全可靠的方案是永久更改语言 cookie 的名称(通过 LANGUAGE_COOKIE_NAME
配置),并添加一个中间件,将旧 cookie 的值复制到新的 cookie 中,然后删除这个 cookie。
LANGUAGE_COOKIE_SAMESITE
¶默认: None
语言 cookie 上 SameSite 标志的值。该标志可防止在跨站点请求中发送 cookie。
关于 SameSite
的详细信息,请参见 SESSION_COOKIE_SAMESITE
。
LANGUAGE_COOKIE_SECURE
¶默认:False
是否对语言 cookie 使用安全 cookie。如果设置为 True
,cookie 将被标记为“安全”,这意味着浏览器可以确保 cookie 只在 HTTPS 连接下发送。
LANGUAGES
¶默认值。所有可用语言的清单。这个列表在不断的增加,如果在这里加入一个副本,那么不可避免的会很快过时。你可以在 django/conf/global_settings.py 中查看当前的翻译语言列表。
该列表是一个由两个元组组成的列表,其格式为 (language code, language name
) ——例如,('ja', 'Japanese')
。这指定了哪些语言可以选择。见 国际化和本地化。
一般来说,默认值就可以了。只有当你想将语言选择限制在 Django 提供的语言子集时,才需要设置此配置。
如果你定义了一个自定义的 LANGUAGES
配置,你可以使用 gettext_lazy()
函数将语言名称标记为翻译字符串。
以下是一个示例配置文件:
from django.utils.translation import gettext_lazy as _
LANGUAGES = [
("de", _("German")),
("en", _("English")),
]
LANGUAGES_BIDI
¶默认值。所有从右到左书写的语言代码的列表。你可以在 django/conf/global_settings.py 中查看这些语言的当前列表。
列表中包含 语言代码,用于从右到左书写的语言。
一般来说,默认值就可以了。只有当你想将语言选择限制在 Django 提供的语言子集时,才设置这个配置。如果你定义了一个自定义的 LANGUAGES
配置,双向语言列表中可能会包含一些在特定网站上没有启用的语言代码。
LOCALE_PATHS
¶默认: []
(空列表)
Django 寻找翻译文件的目录列表。参见 Django 如何发现翻译。
举例:
LOCALE_PATHS = [
"/home/www/project/common_files/locale",
"/var/local/translations/locale",
]
Django 会在这些路径中寻找包含实际翻译文件的 <locale_code>/LC_MESSAGES
目录。
LOGGING
¶默认:日志配置字典。
A data structure containing configuration information. When not-empty, the
contents of this data structure will be passed as the argument to the
configuration method described in LOGGING_CONFIG
.
其中,当 DEBUG
为 False
时,默认的日志配置会将 HTTP 500 服务器错误传递给电子邮件日志处理程序。也请参见 日志模块的配置。
你可以通过查看 django/utils/log.py 中的默认日志配置。
LOGGING_CONFIG
¶默认: 'logging.config.dictConfig'
Django 项目中用于配置日志的可调用路径。默认指向 Python 的 dictConfig 配置方法的实例。
如果将 LOGGING_CONFIG
配置为 None
,将跳过日志配置过程。
MEDIA_ROOT
¶默认: ''
(空字符串)
保存 用户上传的文件 目录的绝对文件系统路径。
例如: "/var/www/example.com/media/"
另见 MEDIA_URL
。
警告
MEDIA_ROOT
和 STATIC_ROOT
必须有不同的值。在引入 STATIC_ROOT
之前,通常依靠或回溯 MEDIA_ROOT
来提供静态文件;然而,由于这可能会产生严重的安全影响,因此有一个验证检查来防止这种情况。
MEDIA_URL
¶默认: ''
(空字符串)
处理从 MEDIA_ROOT
提供的媒体的 URL,用于 管理存储文件。如果设置为非空值,则必须以斜线结束。在开发和生产环境中,你都需要 配置这些文件被服务。
如果你想在模板中使用 {{ MEDIA_URL }}
,在 TEMPLATES
的 ''context_processors'
选项中添加 'django.template.context_processors.media'
。
例如: "http://media.example.com/"
警告
如果接收不受信任的用户的上传会有安全隐患, 请阅读 用户上传内容 获取详情.
警告
MEDIA_URL
和 STATIC_URL
必须有不同的值。更多细节请参见 MEDIA_ROOT
。
备注
如果 MEDIA_URL
是一个相对路径,那么它将以服务器提供的 SCRIPT_NAME
的值为前缀(如果没有设置,则为 /
)。这使得在子路径中服务 Django 应用时更容易,而无需额外增加配置。
MIGRATION_MODULES
¶默认: {}
(空字典)
一个指定包的字典,在每个应用程序的基础上可以找到迁移模块。这个配置的默认值是一个空字典,但迁移模块的默认包名是 migrations
。
举例:
{"blog": "blog.db_migrations"}
在这种情况下,与 blog
应用有关的迁移将包含在 blog.db_migrations
包中。
如果你提供了 app_label
参数, makemigrations
将自动创建包,如果它还不存在。
当你为一个应用程序提供 None
作为一个值时,Django 会将该应用程序视为一个没有迁移的应用程序,而不考虑是否存在 migrations
子模块。例如,在测试设置文件中,这可以用来在测试时跳过迁移(仍然会为应用程序的模型创建表)。要在测试期间禁止所有应用程序的迁移,你可以将 MIGRATE
设置为 False
。如果在你的一般项目配置中使用了 MIGRATION_MODULES
,如果你想为应用程序创建表,记得使用 migrate --run-syncdb
选项。
MONTH_DAY_FORMAT
¶默认: 'F j'
在 Django admin change-list 页面上的日期字段的默认格式——也可能被系统的其他部分使用——在只显示月份和日期的情况下。
例如,当 Django 管理员的变更列表页面被日期 drilldown 过滤时,给定的一天的标题会显示日期和月份。不同的地域有不同的格式。例如,美国英语会说“January 1”,而西班牙语可能会说“1 Enero”。
请注意,如果 USE_L10N
设置为 True
,则相应的本地决定的格式具有更高的优先权,并将被应用。
查看 允许的日期格式字符串
。另见 DATE_FORMAT
、DATETIME_FORMAT
、TIME_FORMAT
和 YEAR_MONTH_FORMAT
。
NUMBER_GROUPING
¶默认: 0
一个数字的整数部分的数字组合在一起的数量。
常见的用途是显示千位数的分隔符。如果该设置为 0
,则不会对该数字进行分组。如果这个设置大于 0
,那么 THOUSAND_SEPARATOR
将被用作这些组之间的分隔符。
有些地方使用非统一的数字分组,例如 en_IN
中的 10,00,00,000
。对于这种情况,你可以提供一个序列,其中包含要应用的数字组大小。第一个数字定义小数定界符之前的组的大小,后面的每个数字定义前面组的大小。如果序列以 -1
结束,则不会再进行分组。如果序列以 0
结束,则在剩余的数字中使用最后一组的大小。
en_IN
的元组示例:
NUMBER_GROUPING = (3, 2, 0)
请注意,如果 USE_L10N
设置为 True
,那么将采用本地决定的格式,具有更高的优先权。
另见 DECIMAL_SEPARATOR
、THOUSAND_SEPARATOR
和 USE_THOUSAND_SEPARATOR
。
PREPEND_WWW
¶默认:False
是否给没有“www.”子域的 URL 加前缀。只有在安装了 CommonMiddleware
的情况下才会使用(参见 中间件)。也请参见 APPEND_SLASH
。
ROOT_URLCONF
¶默认:未定义
一个字符串,代表你的根 URLconf 的完整 Python 导入路径,例如 "mydjangoapps.urls"
。可以通过在传入的 HttpRequest
对象上设置属性 urlconf
来覆盖每个请求。详情请参见 Django 如何处理一个请求。
SECRET_KEY
¶默认: ''
(空字符串)
一个特定 Django 安装的密钥。用于提供 加密签名,并且应该设置为一个唯一的、不可预测的值。
django-admin startproject
自动为每个新项目添加一个随机生成的 SECRET_KEY
。
键的使用不应该假设是文本或字节。每次使用都应该通过 force_str()
或 force_bytes()
将其转换为所需类型。
如果 SECRET_KEY
没有设置,Django 将拒绝启动。
密钥用于:
django.contrib.session.backends.cache
以外的任何其他会话后端,或者使用的是默认的 get_session_auth_hash()
。CookieStorage
或 FallbackStorage
。PasswordResetView
密钥。When a secret key is no longer set as SECRET_KEY
or contained within
SECRET_KEY_FALLBACKS
all of the above will be invalidated. When
rotating your secret key, you should move the old key to
SECRET_KEY_FALLBACKS
temporarily. Secret keys are not used for
passwords of users and key rotation will not affect them.
备注
默认的 settings.py
文件由 django-admin startproject
创建,为方便起见,创建了一个唯一的 SECRET_KEY
。
SECRET_KEY_FALLBACKS
¶Default: []
A list of fallback secret keys for a particular Django installation. These are
used to allow rotation of the SECRET_KEY
.
In order to rotate your secret keys, set a new SECRET_KEY
and move the
previous value to the beginning of SECRET_KEY_FALLBACKS
. Then remove the
old values from the end of the SECRET_KEY_FALLBACKS
when you are ready to
expire the sessions, password reset tokens, and so on, that make use of them.
备注
Signing operations are computationally expensive. Having multiple old key
values in SECRET_KEY_FALLBACKS
adds additional overhead to all checks
that don't match an earlier key.
As such, fallback values should be removed after an appropriate period, allowing for key rotation.
Uses of the secret key values shouldn't assume that they are text or bytes.
Every use should go through force_str()
or
force_bytes()
to convert it to the desired type.
SECURE_CONTENT_TYPE_NOSNIFF
¶默认: True
如果 True
,则 SecurityMiddleware
会在所有响应中设置 X-Content-Type-Options: nosniff 头。
SECURE_CROSS_ORIGIN_OPENER_POLICY
¶默认: 'same-origin'
Unless set to None
, the
SecurityMiddleware
sets the
Cross-Origin Opener Policy header on all responses that do not already
have it to the value provided.
SECURE_HSTS_INCLUDE_SUBDOMAINS
¶默认:False
如果 True
,则 SecurityMiddleware
在 HTTP 严格传输安全 头中添加 includeSubDomains
指令。除非 SECURE_HSTS_SECONDS
被设置为非零值,否则它没有任何效果。
警告
如果设置不正确,可能会不可逆地(对于 SECURE_HSTS_SECONDS
的值)破坏你的网站。请先阅读 HTTP 严格传输安全 文档。
SECURE_HSTS_PRELOAD
¶默认:False
如果 True
,则 SecurityMiddleware
在 HTTP 严格传输安全 头中添加 preload
指令。除非 SECURE_HSTS_SECONDS
设置为非零值,否则没有效果。
SECURE_HSTS_SECONDS
¶默认: 0
如果设置为非零的整数值,则 SecurityMiddleware
会对所有尚未设置 HTTP 严格传输安全 头的响应进行设置。
警告
不正确的设置可能会不可逆地(在一段时间内)破坏你的网站。请先阅读 HTTP 严格传输安全 文档。
SECURE_PROXY_SSL_HEADER
¶默认: None
A tuple representing an HTTP header/value combination that signifies a request
is secure. This controls the behavior of the request object's is_secure()
method.
默认情况下,is_secure()
通过确认请求的 URL 使用 https://
来判断请求是否安全。这个方法对 Django 的 CSRF 保护很重要,你自己的代码或第三方应用可能会用到它。
如果你的 Django 应用是在代理服务器后面,那么无论原始请求是否使用 HTTPS,代理服务器都可能会“吞噬”。如果代理和 Django 之间有一个非 HTTPS 的连接,那么 is_secure()
总是返回 False
——即使是终端用户通过 HTTPS 发出的请求。相反,如果代理和 Django 之间有 HTTPS 连接,那么 is_secure()
将总是返回 True
——即使是对最终用户通过 HTTPS 发出的请求。
在这种情况下,配置你的代理服务器,设置一个自定义的 HTTP 头,告诉 Django 这个请求是否是通过 HTTPS 进来的,并设置 SECURE_PROXY_SSL_HEADER
,这样 Django 就知道要找什么头了。
设置一个包含两个元素的元组——要查找的头的名称和所需的值。例如:
SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")
This tells Django to trust the X-Forwarded-Proto
header that comes from our
proxy and that the request is guaranteed to be secure (i.e., it originally came
in via HTTPS) when:
'https'
, or'https'
in the case of a comma-separated
list of protocols (e.g. 'https,http,http'
).Support for a comma-separated list of protocols in the header value was added.
如果你控制了你的代理或者有其他的保证,你应该 只 设置这个配置,它可以适当地设置/剥离这个头。
需要注意的是,头的格式需要和 request.META
使用的格式一样——全大写,并且可能以 HTTP_
开头。(记住,Django 会在 x-header 名称的开头自动加上 'HTTP_'
,然后才会在 request.META
中使用。)
警告
修改此设置可能会危及你网站的安全。在更改之前,请确保你完全了解你的配置。
在设置之前,请确保以下所有内容为真(假设上面例子中的数值)。
X-Forwarded-Proto
header from all incoming
requests, even when it contains a comma-separated list of protocols. In
other words, if end users include that header in their requests, the
proxy will discard it.X-Forwarded-Proto
头,并将其发送给 Django,但只针对最初通过 HTTPS 进来的请求。如果其中任何一个不是真的,你应该将这个配置设置为 None
,并找到另一种确定 HTTPS 的方法,也许是通过自定义中间件。
SECURE_REDIRECT_EXEMPT
¶默认: []
(空列表)
如果一个 URL 路径与这个列表中的正则表达式相匹配,那么请求将不会被重定向到 HTTPS。SecurityMiddleware
会从 URL 路径中去掉前导斜杠,所以模式不应该包含它们,例如 SECURE_REDIRECT_EXEMPT = [r'^no-ssl/$', ...]
。如果 SECURE_SSL_REDIRECT
是 False
,这个配置就没有效果。
SECURE_REFERRER_POLICY
¶默认: 'same-origin'
如果设置了 SecurityMiddleware
,则会在所有响应中设置 :ref:`referrer-policy`头,如果还没有该头,则将其设置为提供的值。
SECURE_SSL_HOST
¶默认: None
如果是一个字符串(如 secure.example.com
),所有 SSL 重定向都将指向这个主机,而不是最初请求的主机(如 www.example.com
)。如果 SECURE_SSL_REDIRECT
为 False
,则该配置没有效果。
SECURE_SSL_REDIRECT
¶默认:False
如果 True
,则 SecurityMiddleware
重定向 所有非 HTTPS 的请求都会转为 HTTPS(除了那些匹配 SECURE_REDIRECT_EXEMPT
中所列正则表达式的 URL)。
备注
如果将此设置为 True
会导致无限重定向,这可能意味着你的网站是在代理服务器后面运行的,并且无法判断哪些请求是安全的,哪些不是。你的代理服务器可能会设置一个头来指示安全请求;你可以通过找出该头并相应地配置 SECURE_PROXY_SSL_HEADER
设置来纠正这个问题。
SERIALIZATION_MODULES
¶默认:未定义
一个包含序列化器定义(以字符串形式提供)的模块字典,以该序列化类型的字符串标识符为键。例如,要定义一个 YAML 序列化器,使用:
SERIALIZATION_MODULES = {"yaml": "path.to.yaml_serializer"}
SERVER_EMAIL
¶默认: 'root@localhost'
错误信息来自的电子邮件地址,例如发送到 ADMINS
和 MANAGERS
的邮件。
为什么我的邮件从不同的地址发送?
这个地址只用于错误信息。它 不是 用 send_mail()
发送普通邮件的地址;关于这个地址,请看 DEFAULT_FROM_EMAIL
。
SHORT_DATE_FORMAT
¶默认 :'m/d/Y'
(例如 12/31/2003
)
可用于在模板上显示日期字段的可用格式。请注意,如果 USE_L10N
被设置为 True
,那么相应的本地决定的格式具有更高的优先权,并将被应用。参见 允许的日期格式字符串
。
SHORT_DATETIME_FORMAT
¶默认: 'm/d/Y P'
(例如 12/31/2003 4 p.m.
)
可用于在模板上显示日期时间字段的可用格式。请注意,如果 USE_L10N
被设置为 True
,那么相应的本地决定的格式具有更高的优先级,并将被应用。参见 允许的日期格式字符串
。
另见 DATE_FORMAT
和 SHORT_DATE_FORMAT
。
SILENCED_SYSTEM_CHECKS
¶默认: []
(空列表)
你希望永久获取和忽略的系统检查框架生成的消息标识符列表(即 ["models.W001"]
)。静默检查不会被输出到控制台。
另见 系统检查框架 文档。
STORAGES
¶默认:
{
"default": {
"BACKEND": "django.core.files.storage.FileSystemStorage",
},
"staticfiles": {
"BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage",
},
}
A dictionary containing the settings for all storages to be used with Django. It is a nested dictionary whose contents map a storage alias to a dictionary containing the options for an individual storage.
Storages can have any alias you choose. However, there are two aliases with special significance:
default
for managing files.
'
django.core.files.storage.FileSystemStorage
'
is the
default storage engine.staticfiles
for managing static files.
'
django.contrib.staticfiles.storage.StaticFilesStorage
'
is
the default storage engine.The following is an example settings.py
snippet defining a custom file
storage called example
:
STORAGES = {
# ...
"example": {
"BACKEND": "django.core.files.storage.FileSystemStorage",
"OPTIONS": {
"location": "/example",
"base_url": "/example/",
},
},
}
OPTIONS
are passed to the BACKEND
on initialization in **kwargs
.
A ready-to-use instance of the storage backends can be retrieved from
django.core.files.storage.storages
. Use a key corresponding to the
backend definition in STORAGES
.
Is my value merged with the default value?
Defining this setting overrides the default value and is not merged with it.
TEMPLATES
¶默认: []
(空列表)
一个包含所有 Django 模板引擎的配置的列表。列表中的每一项都是一个字典,包含了各个引擎的选项。
下面是一个配置,告诉 Django 模板引擎从每个安装好的应用程序中的 templates
子目录中加载模板:
TEMPLATES = [
{
"BACKEND": "django.template.backends.django.DjangoTemplates",
"APP_DIRS": True,
},
]
以下选项适用于所有后端。
BACKEND
¶默认:未定义
要使用的模板后端。内置的模板后端有:
'django.template.backends.django.DjangoTemplates'
'django.template.backends.jinja2.Jinja2'
你可以通过将 BACKEND
设置为一个完全限定的路径(例如 'mypackage.whatever.Backend'
)来使用一个不在 Django 中的模板后端。
NAME
¶默认:见下方
这个特定模板引擎的别称。它是一个标识符,允许选择一个引擎进行渲染。所有配置的模板引擎的别名必须是唯一的。
它默认为定义引擎类的模块名称,即 BACKEND
的下一个到最后一个,如果没有提供的话。例如,如果后端是 'mypackage.whatever.Backend'
,那么它的默认名称是 'whatever'
。
APP_DIRS
¶默认:False
引擎是否应该在已安装的应用程序中查找模板源文件。
备注
默认的 settings.py
文件由 django-admin startproject
创建,设置 'APP_DIRS': True
。
TEST_NON_SERIALIZED_APPS
¶默认: []
(空列表)
为了在 TransactionTestCase
和没有事务的数据库后端测试之间恢复数据库状态,Django 在启动测试运行时,会 序列化所有应用的内容,这样就可以在运行需要的测试之前,从该副本重新加载。
这将减慢测试运行器的启动时间;如果你有一些应用程序不需要这个功能,你可以在这里添加它们的全名(例如 'django.contrib.contenttypes'
),将它们从这个序列化过程中排除。
THOUSAND_SEPARATOR
¶默认: ','
(英文逗号)
格式化数字时使用的默认千位分隔符。只有当 USE_THOUSAND_SEPARATOR
为 True
和 NUMBER_GROUPING
大于 0
时,才使用此配置。
请注意,如果 USE_L10N
设置为 True
,那么将采用本地决定的格式,具有更高的优先权。
另见 NUMBER_GROUPING
、DECIMAL_SEPARATOR
和 USE_THOUSAND_SEPARATOR
。
TIME_FORMAT
¶默认: 'P'
(例如 4 p.m.
)
在系统的任何部分显示时间字段时使用的默认格式。请注意,如果 USE_L10N
被设置为 True
,那么本地决定的格式具有更高的优先权,并将被应用。参见 允许的日期格式字符串
。
另见 DATE_FORMAT
和 DATETIME_FORMAT
。
TIME_INPUT_FORMATS
¶默认:
[
"%H:%M:%S", # '14:30:59'
"%H:%M:%S.%f", # '14:30:59.000200'
"%H:%M", # '14:30'
]
在时间字段上输入数据时可接受的格式列表。格式将按顺序被尝试,使用第一个有效的格式。注意这些格式字符串使用 Python 的 datetime 模块语法,而不是来自 date
模板过滤器的格式字符串。
当 USE_L10N
为 True
时,将采用本地规定的格式,具有更高的优先权。
TIME_ZONE
¶默认: 'America/Chicago'
表示本次安装的时区的字符串。参见 时区列表 。
备注
自从 Django 首次发布时, TIME_ZONE
设置为 'America/Chicago'
,为了向后兼容,全局配置(如果你的项目 settings.py
中没有定义任何内容,则使用全局配置)仍为 'America/Chicago'
。新项目模板默认为 'UTC'
。
注意,这不一定是服务器的时区。例如,一个服务器可能服务于多个 Django 网站,每个网站都有单独的时区配置。
当 USE_TZ
为 False
时,这是 Django 存储所有日期时间的时区。当 USE_TZ
为 True
时,这是 Django 在模板中显示日期时间和解释表单中输入的日期时间的默认时区。
在 Unix 环境下(实现了 time.tzset()
),Django 将 os.environ['TZ']
变量设置为你在 TIME_ZONE
配置中指定的时区。这样,你所有的视图和模型都会自动在这个时区运行。但是,如果你使用的是 手动设置配置 中描述的手动配置选项,Django 就不会设置 TZ
环境变量。如果 Django 没有设置 TZ
环境变量,那么就需要你确保你的进程运行在正确的环境中。
备注
Django 无法在 Windows 环境下可靠地使用交替时区。如果你在 Windows 上运行 Django, TIME_ZONE
必须设置为与系统时区匹配。
USE_DEPRECATED_PYTZ
¶默认:False
A boolean that specifies whether to use pytz
, rather than zoneinfo
,
as the default time zone implementation.
4.0 版后已移除: This transitional setting is deprecated. Support for using pytz
will be
removed in Django 5.0.
USE_I18N
¶默认: True
一个布尔值,用于指定是否应该启用 Django 的翻译系统。这提供了一个关闭翻译系统的方法,以保证性能。如果设置为 False
,Django 会进行一些优化,以避免加载翻译机制。
另见 LANGUAGE_CODE'、 :setting:`USE_L10N
和 :setting:`USE_TZ'。
备注
默认的 settings.py
文件由 django-admin startproject
创建,包括方便起见 USE_I18N = True
。
USE_L10N
¶默认: True
一个布尔值,用于指定是否默认启用数据的本地化格式。如果设置为 True
,例如,Django 将使用当前语言的格式来显示数字和日期。
另见 LANGUAGE_CODE
、USE_I18N
和 USE_TZ
。
4.0 版后已移除: This setting is deprecated. Starting with Django 5.0, localized formatting of data will always be enabled. For example Django will display numbers and dates using the format of the current locale.
USE_THOUSAND_SEPARATOR
¶默认:False
A boolean that specifies whether to display numbers using a thousand separator.
When set to True
and USE_L10N
is also True
, Django will
format numbers using the NUMBER_GROUPING
and
THOUSAND_SEPARATOR
settings. The latter two settings may also be
dictated by the locale, which takes precedence.
USE_TZ
¶默认:False
备注
在 Django 5.0 中,默认值将从``False`` 更改为``True``。
一个布尔值,用于指定 Django 是否默认使用时区感知。如果设置为 True
,Django 将在内部使用时区感知的日期。
当 USE_TZ
为 False 时,Django 将使用本地时间的本地日期,除非在解析 ISO 8601 格式的字符串时,如果存在时区信息,则会一直保留。
另见 TIME_ZONE
、USE_I18N
和 USE_L10N
。
备注
默认的 settings.py
文件由 django-admin startproject
创建,包括方便起见 USE_TZ = True
。
USE_X_FORWARDED_HOST
¶默认:False
一个布尔值,用于指定是否使用 X-Forwarded-Host
头,而不是 Host
头。只有在使用设置该头的代理时才应启用。
此设置优先于 USE_X_FORWARDED_PORT
。根据 RFC 7239#section-5.3,X-Forwarded-Host
头可以包括端口号,在这种情况下,你不应该使用 USE_X_FORWARDED_PORT
。
USE_X_FORWARDED_PORT
¶默认:False
一个布尔值,用于指定是否使用 X-Forwarded-Port
头,而不是 SERVER_PORT``META
变量。只有在使用设置该头的代理时,才应启用。
USE_X_FORWARDED_HOST
优先于此配置。
WSGI_APPLICATION
¶默认: None
Django 内置服务器(如 runserver
)将使用的 WSGI 应用对象的完整 Python 路径。django-admin startproject
管理命令将创建一个标准的 wsgi.py
文件,其中有一个 application
可调用,并将此配置指向该 application
。
如果没有设置,将使用 django.core.wsgi.get_wsgi_application()
的返回值。在这种情况下, runserver
的行为将与之前的 Django 版本相同。
YEAR_MONTH_FORMAT
¶默认: 'F Y'
在 Django admin change-list 页面中,当只显示年和月的时候,默认的日期字段的格式也可能被系统的其他部分使用。
例如,当 Django 管理员的变更列表页面被日期 drilldown 过滤时,给定月份的头显示月份和年份。不同的地域有不同的格式。例如,美国英语会说“January 2006”,而另一个地方语言可能会说 “2006/January”。
请注意,如果 USE_L10N
设置为 True
,则相应的本地决定的格式具有更高的优先权,并将被应用。
查看 允许的日期格式字符串
。另见 DATE_FORMAT
、DATETIME_FORMAT
、TIME_FORMAT
和 MONTH_DAY_FORMAT
。
django.contrib.auth
的配置。
AUTHENTICATION_BACKENDS
¶默认: ['django.contrib.auth.backends.ModelBackend']
当试图认证用户时,要使用的认证后端类(字符串)列表。详情请参见 认证后端文档。
AUTH_USER_MODEL
¶默认: 'auth.User'
用来表示用户的模型。见 替换一个自定义的 User 模型。。
警告
在项目的生命周期内(即一旦你制作并迁移了依赖它的模型),你无法不费吹灰之力地更改 AUTH_USER_MODEL 配置。它的目的是在项目开始时设置,并且它所引用的模型必须在它所在的应用程序的第一次迁移中可用。详见 替换一个自定义的 User 模型。。
LOGIN_REDIRECT_URL
¶默认: '/accounts/profile/'
LOGIN_URL
¶默认: '/accounts/login/'
当使用 login_required()
装饰器、LoginRequiredMixin
或 AccessMixin
时,重定向请求登录的 URL 或 命名 URL 模式。
LOGOUT_REDIRECT_URL
¶默认: None
如果 LogoutView
没有 next_page
属性,则注销后重定向请求的 URL 或 命名 URL 模式。
如果 None
,将不执行重定向,并显示注销视图。
PASSWORD_RESET_TIMEOUT
¶默认: 259200
(3 天,以秒为单位)
密码重置链接的有效秒数。
由 PasswordResetConfirmView
使用。
备注
减少这个超时的值并不会对攻击者强行重置密码令牌的能力产生任何影响。令牌的设计是安全的,不需要任何超时。
这个超时时间的存在,是为了防止一些不太可能发生的攻击情况,比如有人访问可能包含旧的、未使用的密码重置令牌的电子邮件档案。
PASSWORD_HASHERS
¶查看 Django 如何存储密码。
默认:
[
"django.contrib.auth.hashers.PBKDF2PasswordHasher",
"django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher",
"django.contrib.auth.hashers.Argon2PasswordHasher",
"django.contrib.auth.hashers.BCryptSHA256PasswordHasher",
]
MESSAGE_LEVEL
¶默认: messages.INFO
设置消息框架将记录的最小消息级别。详见 消息级别。
Avoiding circular imports
如果你在配置文件中覆盖了 MESSAGE_LEVEL
,并依赖任何内置的常量,你必须直接导入常量模块以避免循环导入的可能性,例如:
from django.contrib.messages import constants as message_constants
MESSAGE_LEVEL = message_constants.DEBUG
如果需要,可以直接根据上面 常量表 中的数值来指定常量的数值。
MESSAGE_STORAGE
¶默认: 'django.contrib.messages.storage.fallback.FallbackStorage'
控制 Django 存储消息数据的地方。有效值是:
'django.contrib.messages.storage.fallback.FallbackStorage'
'django.contrib.messages.storage.session.SessionStorage'
'django.contrib.messages.storage.cookie.CookieStorage'
详见 消息储存后端。
使用 cookie 的后端—— CookieStorage
和 FallbackStorage
——在设置它们的 cookie 时,使用 SESSION_COOKIE_DOMAIN
、SESSION_COOKIE_SECURE
和 SESSION_COOKIE_HTTPONLY
的值。
MESSAGE_TAGS
¶默认:
{
messages.DEBUG: "debug",
messages.INFO: "info",
messages.SUCCESS: "success",
messages.WARNING: "warning",
messages.ERROR: "error",
}
这设置了消息级别到消息标签的映射,通常在 HTML 中以 CSS 类的形式呈现。如果你指定了一个值,它将扩展默认值。这意味着你只需要指定那些你需要覆盖的值。更多细节请参考上面的 显示消息。
Avoiding circular imports
如果你在配置文件中覆盖了 MESSAGE_TAGS
,并依赖任何内置的常量,你必须直接导入 constants
模块,以避免循环导入的可能性,例如:
from django.contrib.messages import constants as message_constants
MESSAGE_TAGS = {message_constants.INFO: ""}
如果需要,可以直接根据上面 常量表 中的数值来指定常量的数值。
SESSION_COOKIE_DOMAIN
¶默认: None
用于会话 cookie 的域。将其设置为一个字符串,如 "example.com"
,用于跨域 cookie,或使用 None
用于标准域 cookie。
要使用带有 CSRF_USE_SESSIONS
的跨域 cookie,你必须包括一个前导点(例如 ".example.com"
),以适应 CSRF 中间件的引用检查。
在生产型网站上更新此配置时要谨慎。如果你更新此配置,在以前使用标准域 cookie 的网站上启用跨域 cookie,现有用户 cookie 将被设置为旧域。这可能导致他们无法登录,只要这些 cookie 持续存在。
这个配置也会影响到 django.contrib.messages
所设置的 cookies。
SESSION_COOKIE_HTTPONLY
¶默认: True
是否对会话 cookie 使用 HttpOnly
标志。如果设置为 True
,客户端的 JavaScript 将无法访问会话 cookie。
HttpOnly 是包含在 Set-Cookie HTTP 响应头中的一个标志。它是 RFC 6265#section-4.1.2.6 标准中 Cookie 的一部分,可以作为一种有用的方式来降低客户端脚本访问受保护 Cookie 数据的风险。
这使得攻击者将跨站脚本漏洞升级为完全劫持用户的会话变得不那么简单。关闭这个功能的理由不多。你的代码不应该从 JavaScript 中读取会话 cookies。
SESSION_COOKIE_PATH
¶默认: '/'
会话 cookie 上设置的路径。这个路径应该与你的 Django 安装的 URL 路径相匹配,或者是该路径的父路径。
如果你有多个 Django 实例在同一个主机名下运行,这个功能很有用。他们可以使用不同的 cookie 路径,而且每个实例只能看到自己的会话 cookie。
SESSION_COOKIE_SAMESITE
¶默认: 'Lax'
会话 cookie 上的 SameSite 标志的值。这个标志可以防止 cookie 在跨站请求中被发送,从而防止 CSRF 攻击,使一些窃取会话 cookie 的方法变得不可能。
该配置的可能值为:
'Strict'
:防止浏览器在所有跨站点浏览的情况下向目标站点发送 cookie,即使在使用常规链接时也是如此。
例如,对于类似 GitHub 的网站来说,这意味着如果登录的用户通过企业论坛或电子邮件链接到 GitHub 的私人项目,GitHub 将不会收到会话 cookie,用户将无法访问该项目。然而,银行网站很可能不允许从外部网站链接任何交易页面,因此 'Strict'
标志将是合适的。
'Lax'
(默认):为希望在用户从外部链接到达后保持用户登录会话的网站提供安全和可用性之间的平衡。
在 GitHub 的场景下,当跟随外部网站的常规链接时,会话 cookie 将被允许,而在 CSRF 倾向的请求方法(例如 POST
)中被阻止。
'None'
(字符串):会话 cookie 将随所有同站和跨站请求发送。
False
:停用该标志。
备注
现代浏览器为 SameSite
标志提供了一个更安全的默认策略,并将假定 Lax
为没有明确配置值的 cookies。
SESSION_COOKIE_SECURE
¶默认:False
是否对会话 cookie 使用安全 cookie。如果设置为 True
,cookie 将被标记为“安全”,这意味着浏览器可以确保 cookie 只在 HTTPS 连接下发送。
关闭这个配置并不是一个好主意,因为攻击者可以用数据包嗅探器捕获一个未加密的会话 cookie,并使用 cookie 来劫持用户的会话
SESSION_ENGINE
¶默认: 'django.contrib.sessions.backends.db'
控制 Django 存储会话数据的地方。包括的引擎有:
'django.contrib.sessions.backends.db'
'django.contrib.sessions.backends.file'
'django.contrib.sessions.backends.cache'
'django.contrib.sessions.backends.cached_db'
'django.contrib.sessions.backends.signed_cookies'
详见 配置会话(session)引擎。
SESSION_FILE_PATH
¶默认: None
如果你使用的是基于文件的会话存储,那么这个选项设置了 Django 存储会话数据的目录,当使用默认值(None
)时,Django 将使用系统的标准临时目录。
SESSION_SAVE_EVERY_REQUEST
¶默认:False
是否在每次请求时保存会话数据。如果这个配置是 False
(默认),那么会话数据只有在被修改时才会被保存,也就是说,如果它的任何字典值被分配或删除,那么会话数据就会被保存。即使这个配置是活动的,也不会创建空会话。
django.contrib.sites
的配置。
django.contrib.staticfiles
的配置。
STATIC_ROOT
¶默认: None
collectstatic
将收集静态文件进行部署的目录的绝对路径。
例如: "/var/www/example.com/static/"
如果 staticfiles contrib 应用已启用(如在默认的项目模板中), collectstatic
管理命令将收集静态文件到这个目录。更多使用方法请参见 管理静态文件 的操作指南。
警告
这应该是一个初始为空的目标目录,用于将你的静态文件从其永久位置收集到一个目录中,以方便部署;它 不是 永久存储静态文件的地方。你应该在那些会被 静态文件 的 finders
找到的目录中进行,默认情况下,这些目录是 'static/'
应用子目录和你在 STATICFILES_DIRS
中包含的任何目录。
STATIC_URL
¶默认: None
引用位于 STATIC_ROOT
中的静态文件时要使用的 URL。
Example: "static/"
or "http://static.example.com/"
如果不是 None
,这将被用作 资源定义 (Media
类)和 静态文件应用 的基本路径。
如果设置为非空值,必须以斜线结束。
你可能需要 在开发中服务这些文件,在 生产中 肯定需要这样做。
备注
如果 STATIC_URL
是一个相对路径,那么它将以服务器提供的 SCRIPT_NAME
的值为前缀(如果没有设置,则为 /
)。这使得在子路径中服务 Django 应用时更容易,而无需在增加额外的配置。
STATICFILES_DIRS
¶默认: []
(空列表)
这个配置定义了静态文件应用在启用 FileSystemFinder
查找器时将穿越的额外位置,例如,如果你使用 collectstatic
或 findstatic
管理命令或使用静态文件服务视图。
这应该被设置为包含附加文件目录完整路径的字符串列表,例如:
STATICFILES_DIRS = [
"/home/special.polls.com/polls/static",
"/home/polls.com/polls/static",
"/opt/webfiles/common",
]
请注意,这些路径应该使用 Unix 风格的斜线,即使在 Windows 上也是如此(例如 "C:/Users/user/mysite/extra_static_content"
)。
如果你想用一个额外的命名空间来引用其中一个位置的文件,你可以 可选的 提供一个前缀作为 (prefix, path)
的元组,例如:
STATICFILES_DIRS = [
# ...
("downloads", "/opt/webfiles/stats"),
]
For example, assuming you have STATIC_URL
set to 'static/'
, the
collectstatic
management command would collect the "stats" files
in a 'downloads'
subdirectory of STATIC_ROOT
.
这将允许你在你的模板中用 '/static/downloads/polls_20101022.tar.gz'
引用本地文件 '/opt/webfiles/stats/polls_20101022.tar.gz'
,例如:
<a href="{% static 'downloads/polls_20101022.tar.gz' %}">
STATICFILES_STORAGE
¶默认: 'django.contrib.staticfiles.storage.StaticFilesStorage'
使用 collectstatic
管理命令收集静态文件时要使用的文件存储引擎。
A ready-to-use instance of the storage backend defined in this setting
can be found under staticfiles
key in django.core.files.storage.storages
.
例如,参见 从云服务或 CDN 提供静态文件服务。
4.2 版后已移除: This setting is deprecated. Starting with Django 4.2, static files storage
engine can be configured with the STORAGES
setting under the
staticfiles
key.
STATICFILES_FINDERS
¶默认:
[
"django.contrib.staticfiles.finders.FileSystemFinder",
"django.contrib.staticfiles.finders.AppDirectoriesFinder",
]
知道如何找到不同位置的静态文件的查找器后端列表。
默认情况下,将查找存储在 STATICFILES_DIRS
配置中的文件(使用 django.contrib.staticfiles.finders.FileSystemFinder
)和每个应用程序的 static
子目录中的文件(使用 django.contrib.staticfiles.finders.AppDirectoriesFinder
)。如果存在多个同名文件,将使用第一个找到的文件。
One finder is disabled by default:
django.contrib.staticfiles.finders.DefaultStorageFinder
. If added to
your STATICFILES_FINDERS
setting, it will look for static files in
the default file storage as defined by the default
key in the
STORAGES
setting.
备注
当使用 AppDirectoriesFinder
查找器时,通过将应用添加到你的网站的 INSTALLED_APPS
配置中,确保你的应用程序可以通过 staticfiles 找到。
静态文件查找器目前被认为是一个私有接口,因此这个接口是没有文档的。
i18n
/ l10n
)¶DATE_FORMAT
DATE_INPUT_FORMATS
DATETIME_FORMAT
DATETIME_INPUT_FORMATS
DECIMAL_SEPARATOR
FIRST_DAY_OF_WEEK
FORMAT_MODULE_PATH
LANGUAGE_CODE
LANGUAGE_COOKIE_AGE
LANGUAGE_COOKIE_DOMAIN
LANGUAGE_COOKIE_HTTPONLY
LANGUAGE_COOKIE_NAME
LANGUAGE_COOKIE_PATH
LANGUAGE_COOKIE_SAMESITE
LANGUAGE_COOKIE_SECURE
LANGUAGES
LANGUAGES_BIDI
LOCALE_PATHS
MONTH_DAY_FORMAT
NUMBER_GROUPING
SHORT_DATE_FORMAT
SHORT_DATETIME_FORMAT
THOUSAND_SEPARATOR
TIME_FORMAT
TIME_INPUT_FORMATS
TIME_ZONE
USE_I18N
USE_L10N
USE_THOUSAND_SEPARATOR
USE_TZ
YEAR_MONTH_FORMAT
9月 22, 2023