中间件¶

缓存中间件¶

class UpdateCacheMiddleware¶

class FetchFromCacheMiddleware¶

启用站点级缓存。如果启用这些功能，每个Django供电页面将被缓存，只要 CACHE_MIDDLEWARE_SECONDS 设置定义。见 缓存文档。

“普通”中间件¶

class CommonMiddleware[源代码]¶

为完美主义者添加一些便利：

• 禁止在 DISALLOWED_USER_AGENTS 设置中访问用户代理，这应该是已编译的正则表达式对象的列表。

• 根据 APPEND_SLASH 和 PREPEND_WWW 设置执行URL重写。

  如果 APPEND_SLASH 是 True，并且初始URL不以斜杠结尾，并且在URLconf中找不到，则通过在末尾添加斜杠形成新的URL。如果在URLconf中找到这个新的URL，Django会将请求重定向到这个新的URL。否则，将照常处理初始URL。

  例如，如果您没有针对 foo.com/bar 的有效网址格式，但 do 对 foo.com/bar/ 有有效的格式，则 foo.com/bar 将重定向到 foo.com/bar/。

  如果 PREPEND_WWW 是 True，则缺少前导“www”的网址。将被重定向到具有领先“www”的相同URL。

  这两个选项都是为了规范化URL。理念是每个URL应该存在于一个，而且只有一个地方。技术上来说，URL foo.com/bar 与 foo.com/bar/ 不同 - 搜索引擎索引器会将它们视为单独的URL，因此最佳做法是规范化URL。

• 根据 USE_ETAGS 设置处理ETag。如果 USE_ETAGS 设置为 True，Django将为MD5计算每个请求的ETag - 散列页面内容，如果适当，它将负责发送 Not Modified 响应。

CommonMiddleware.response_redirect_class¶

默认为 HttpResponsePermanentRedirect。子类 CommonMiddleware 并覆盖该属性以自定义中间件发出的重定向。

class BrokenLinkEmailsMiddleware[源代码]¶

• 将断开的链接通知电子邮件发送给 MANAGERS （请参阅 报告错误）。

异常中间件¶

class ExceptionMiddleware¶

捕获在请求/响应周期中引发的异常并返回适当的响应。

• Http404 由 handler404 处理（或者如果 DEBUG=True 是更友好的调试页面）。

• PermissionDenied 由 handler403 处理。

• MultiPartParserError 由 handler400 处理。

• SuspiciousOperation 由 handler400 处理（或者如果 DEBUG=True 是更友好的调试页面）。

• 任何其他异常由 handler500 处理（或者如果 DEBUG=True 是更友好的调试页面）。

Django使用这个中间件，不管你是否将它包含在 MIDDLEWARE 中，但是，如果你自己的中间件需要将这些异常转换为适当的响应，你可能想要子类化。 LocaleMiddleware 这样做，例如。

GZip中间件¶

class GZipMiddleware¶

压缩了解GZip压缩（所有现代浏览器）的浏览器的内容。

此中间件应放置在任何其他需要读取或写入响应主体的中间件之前，以便之后进行压缩。

如果满足以下任一条件，它不会压缩内容：

• 内容主体的长度小于200字节。

• 响应已设置 Content-Encoding 头。

• 请求（浏览器）尚未发送包含 gzip 的 Accept-Encoding 头。

您可以使用 gzip_page() 装饰器将GZip压缩应用于单个视图。

条件GET中间件¶

class ConditionalGetMiddleware[源代码]¶

处理条件GET操作。如果响应具有 ETag 或 Last-Modified 报头，并且请求具有 If-None-Match 或 If-Modified-Since，则响应由 HttpResponseNotModified 替换。

还设置 Date 和 Content-Length 响应标头。

语言环境中间件¶

class LocaleMiddleware¶

根据请求中的数据启用语言选择。它为每个用户定制内容。见 国际化文档。

LocaleMiddleware.response_redirect_class¶

默认为 HttpResponseRedirect。子类 LocaleMiddleware 并覆盖该属性以自定义中间件发出的重定向。

消息中间件¶

class MessageMiddleware[源代码]¶

启用基于cookie和基于会话的消息支持。见 消息文档。

安全中间件¶

class SecurityMiddleware[源代码]¶

django.middleware.security.SecurityMiddleware 对请求/响应周期提供若干安全增强。每个都可以通过设置独立启用或禁用。

• SECURE_BROWSER_XSS_FILTER

• SECURE_CONTENT_TYPE_NOSNIFF

• SECURE_HSTS_INCLUDE_SUBDOMAINS

• SECURE_HSTS_SECONDS

• SECURE_REDIRECT_EXEMPT

• SECURE_SSL_HOST

• SECURE_SSL_REDIRECT

会话中间件¶

class SessionMiddleware¶

启用会话支持。见 会话文档。

网站中间件¶

class CurrentSiteMiddleware[源代码]¶

将表示当前站点的 site 属性添加到每个传入的 HttpRequest 对象。参见 网站文档。

认证中间件¶

class AuthenticationMiddleware¶

将表示当前登录的用户的 user 属性添加到每个传入的 HttpRequest 对象。参见 Web请求中的身份验证。

class RemoteUserMiddleware¶

使用Web服务器提供的身份验证的中间件。有关使用详细信息，请参阅 使用 REMOTE_USER 的验证。

class PersistentRemoteUserMiddleware¶

用于仅在登录页面上启用Web服务器提供的身份验证的中间件。有关使用详细信息，请参阅 仅在登录页面上使用 REMOTE_USER。

CSRF保护中间件¶

class CsrfViewMiddleware¶

通过向POST表单添加隐藏的表单字段并检查正确值的请求，添加对跨站点请求伪造的保护。见 跨站请求伪造保护文档。

X-Frame-Options 中间件¶

class XFrameOptionsMiddleware[源代码]¶

简单 点击防护通过X-Frame-Options标题。