重定向应用
Django 原生自带一个可选的重定向应用。它将简单的重定向保存到数据库中并处理重定向。它默认使用HTTP 响应状态码301 Moved Permanently
。
安装
请依照下面的步骤安装重定向应用:
确保
django.contrib.sites
框架已经安装。添加’
django.contrib.redirects
‘ 到INSTALLED_APPS
设置中。添加’
django.contrib.redirects.middleware.RedirectFallbackMiddleware
‘ 到MIDDLEWARE_CLASSES
设置中。运行命令
manage.py migrate
。
它是如何工作的
manage.py migrate
在数据库中创建一张django_redirect
表。它是一张简单的查询表,具有site_id
、old_path
和new_path
字段。
RedirectFallbackMiddleware
完成所有的工作。每当Django 的应用引发一个404 错误,该中间件将到重定向数据库中检查请求的URL。它会根据old_path
和SITE_ID
设置的站点ID 查找重定向的路径。
如果找到匹配的记录且
new_path
不为空,它将使用301(“Moved Permanently”)重定向到new_path
。你可以子类化RedirectFallbackMiddleware
并设置response_redirect_class
为django.http.HttpResponseRedirect
来使用302 Moved Temporarily 重定向。如果找到匹配的记录而
new_path
为空,它将发送一个410 (“Gone”) HTTP 头和空(没有内容的)响应。如果没有找到匹配的记录,请求将继续正常处理。
这个中间件只针对404 错误启用 —— 不能用于500 或其它状态码。
注意MIDDLEWARE_CLASSES
的顺序很重要。通常可以将RedirectFallbackMiddleware
放在列表的最后,因为它最后执行。
更多的信息可以阅读中间件的文档。
如何添加、修改和删除重定向
通过Admin 接口
如果你已经启用Django 自动生成的Admin
接口,你应该可以在Admin
的主页看到“Redirects”部分。编辑这些重定向,就像编辑系统中的其它对象一样。
通过Python API
class models.Redirect
重定向通过一个标准的Django 模型表示,位于django/contrib/redirects/models.py
。你可以通过Django 的数据库API 访问重定向对象。
中间件
class middleware.RedirectFallbackMiddleware
你可以通过创建RedirectFallbackMiddleware
的子类并覆盖response_gone_class
和/或response_redirect_class
来修改中间件使用的HttpResponse
类。
response_gone_class
New in Django 1.7.
HttpResponse
类,用于找不到请求路径的Redirect
或找到的new_path
值为空的时候。
默认为HttpResponseGone
。
response_redirect_class
New in Django 1.7.
处理重定向的HttpResponse
类。
默认为HttpResponsePermanentRedirect
。
译者:Django 文档协作翻译小组,原文:Redirects。
本文以 CC BY-NC-SA 3.0 协议发布,转载请保留作者署名和文章出处。
Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。交流群:467338606。