⇪

Django小技巧21: 使用重定向

Posted November 09, 2018

翻译整理自: simpleisbetterthancomplex.com

Django 附带了一组可以轻松安装的可选模块, 其中一个模块就是重定向的模块, 它在您想要更新某些现有URL而不损害您的网站SEO或在任何情况下避免404错误的情况下特别有用。

比如我现有的 URL 是

/tips/2017/08/11/django-tip-21.html
<\>Url

在某一次更新之后 URL 有变动变成了:

/tips/redirects-app/
<\>Url

而且我原有 URL， 已经被搜索引擎收录. 我不想在用户通过搜索引擎点过来是404页面。 这时候就需要做重定向到新的地址

redirects 模块是通过在数据库中创建一张表, 包含两个字段(old_path和new_path)来实现的.每当你的项目出现404错误的时候，redirects 组件将会拦截404响应， 并检索特定的 table 进行匹配, 如果在特定的 table 中匹配到old_path ,将会重定向到所绑定的new_path. 不会返回404, 而返回一个301响应(Moved Permanently).

OK, 让我看看redirects在实践中如何执行

安装

Django redirects 组件需要安装sites框架. 通过settings.py的INSTALLED_APPS来添加到项目中。

settings.py

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',

    'django.contrib.sites',
    'django.contrib.redirects',
]
<\>Python

设置SITE_ID让sites框架能够工作.

settings.py

SITE_ID = 1
<\>Python

现在将redirects的中间件添加到MIDDLEWARE

settings.py

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',

    'django.contrib.redirects.middleware.RedirectFallbackMiddleware',
]
<\>Python

通过migrate创建所需要的表：

python manage.py migrate
<\>Shell

使用

最简单的方式通过 Django Admin 来对这个表添加记录. 如果你没有 Django Admin, 并且此操作是一次性的事情, 你可以通过redirects的 Python API 或者创建一个fixture. 如果你不使用Django Admin 但这个不是一次性的事情， 需要后面维护更新这个表， 那么你需要创建一个自己的视图管理页面.

通过DjangoAdmin管理redirects

默认情况下， 安装后会自动加到 Django Admin 界面

#Django Admin 管理 redirects

只需添加对应的路径， redirects组件将会自动完成这个重定向工作

#redirects table

你可以通过浏览器来访问旧的路径， 看看他是否能够正常的重定向. 另一种方法是检测响应的body, 可以通过curl来完成:

curl --head 127.0.0.1:8000/tips/2017/08/11/django-tip-21.html

HTTP/1.0 301 Moved Permanently
Date: Fri, 11 Aug 2017 15:42:27 GMT
Server: WSGIServer/0.2 CPython/3.6.1
Content-Type: text/html; charset=utf-8
Location: /tips/redirects-app/
X-Frame-Options: SAMEORIGIN
Content-Length: 0
<\>Shell

通过Python API管理redirects

你可以通过 Django ORM 来对 redirects 的 Model 进行操作管理. 它位于django/contrib/redirects/models.py.

以下是创建redirects 条目的示例代码:

from django.contrib.redirects.models import Redirect
from django.contrib.sites.models import Site
from django.conf import settings

site = Site.objects.get(pk=settings.SITE_ID)

Redirect.objects.create(site=site, old_path='/index.html', new_path='/')
Redirect.objects.create(site=site, old_path='/tips/2017/08/11/django-tip-21.html', new_path='/tips/redirects-app/')
<\>Python

通过Fixtures导入redirects

关于Fixtures, 是 Django 提供的一个功能， 可以到这里查看文档了解更多.

首先按照以下示例的模板创建 JSON 文件

redirects-fixture.json

[
   {
      "model":"redirects.redirect",
      "fields":{
         "site":1,
         "old_path":"/tips/2017/08/11/django-tip-21.html",
         "new_path":"/tips/redirects-app/"
      }
   },
   {
      "model":"redirects.redirect",
      "fields":{
         "site":1,
         "old_path":"/index.html",
         "new_path":"/"
      }
   }
]
<\>Json

然后通过命令将其加载到数据库

python manage.py loaddata redirects-fixtures.json
Installed 2 object(s) from 1 fixture(s)
<\>Shell

就是这样~

𝔔
#Django小技巧