Приложение перенаправлений

Django поставляется с необязательным приложением перенаправлений. Оно позволяет хранить перенаправления в базе данных и обрабатывать перенаправление за вас. Оно использует код состояния HTTP-ответа 301 Moved Permanently по умолчанию.

Установка

Чтобы установить приложение перенаправлений, выполните следующие шаги:

Убедитесь, что фреймворк django.contrib.sites установлен.
Добавьте 'django.contrib.redirects' в свой параметр INSTALLED_APPS.
Добавьте 'django.contrib.redirects.middleware.RedirectFallbackMiddleware' в свой параметр MIDDLEWARE.
Выполните команду manage.py migrate.

Как это работает

manage.py migrate создает таблицу django_redirect в вашей базе данных. Это таблица поиска с полями site_id, old_path и new_path.

Весь процесс обработки выполняет RedirectFallbackMiddleware. Каждый раз, когда любое приложение Django вызывает ошибку 404, этот middleware проверяет базу данных перенаправлений на запрашиваемый URL в качестве последней попытки. Точнее, он проверяет наличие перенаправления с заданным old_path и идентификатором сайта, соответствующим параметру SITE_ID.

Если он находит совпадение, и new_path не пусто, он перенаправляет на new_path с использованием перенаправления 301 («Перемещено постоянно»). Вы можете создать подкласс RedirectFallbackMiddleware и установить response_redirect_class на django.http.HttpResponseRedirect, чтобы использовать перенаправление 302 Moved Temporarily вместо этого.
Если он находит совпадение, и new_path пусто, он отправляет HTTP-заголовок 410 («Отсутствует») и пустой (без содержимого) ответ.
Если совпадение не найдено, запрос обрабатывается обычным образом.

Middleware активируется только для ошибок 404 – а не для ошибок 500 или ответов с любым другим кодом состояния.

Обратите внимание, что порядок MIDDLEWARE важен. Обычно вы можете поместить RedirectFallbackMiddleware в конец списка, так как это крайняя мера.

Подробнее о middleware читайте в документации по middleware.

Как добавить, изменить и удалить перенаправления

Через интерфейс администрирования

Если вы активировали автоматический интерфейс администрирования Django, вы должны увидеть раздел «Перенаправления» на главной странице администрирования. Редактируйте перенаправления так же, как и любой другой объект в системе.

Через Python API

class models.Redirect

Перенаправления представлены стандартной моделью Django, которая находится в django/contrib/redirects/models.py. Вы можете получить доступ к объектам перенаправлений через API базы данных Django. Например:

>>> from django.conf import settings
>>> from django.contrib.redirects.models import Redirect
>>> # Add a new redirect.
>>> redirect = Redirect.objects.create(
...     site_id=1,
...     old_path="/contact-us/",
...     new_path="/contact/",
... )
>>> # Change a redirect.
>>> redirect.new_path = "/contact-details/"
>>> redirect.save()
>>> redirect
<Redirect: /contact-us/ ---> /contact-details/>
>>> # Delete a redirect.
>>> Redirect.objects.filter(site_id=1, old_path="/contact-us/").delete()
(1, {'redirects.Redirect': 1})

Middleware

class middleware.RedirectFallbackMiddleware

Вы можете изменить используемые классы HttpResponse middleware, создав подкласс RedirectFallbackMiddleware и переопределив response_gone_class и/или response_redirect_class.

response_gone_class

Класс HttpResponse, используемый, когда Redirect не найден для запрашиваемого пути или имеет пустое значение new_path.

По умолчанию HttpResponseGone.

response_redirect_class

Класс HttpResponse, который обрабатывает перенаправление.

По умолчанию HttpResponsePermanentRedirect.

© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/5.2/ref/contrib/redirects/