Установка
Каждый из следующих шагов должен быть настроен, чтобы Django Debug Toolbar работал корректно
Содержание
Полуить код
Рекомендуемый способ установить Django Debug Toolbar через pip:
$ pip install django-debug-toolbar
Если вы не знакомы с pip, вы также можете получить копию каталога debug_toolbar и добавить его к библиотекам Python.
Это можно осуществить с помощью следующей команды:
$ pip install -e git+https://github.com/jazzband/django-debug-toolbar.git#egg=django-debug-toolbar
Предпосылки
Убедитесь, что django.contrib.staticfiles настроен правильно, и добавьте debug_toolbar в настройку INSTALLED_APPS:
INSTALLED_APPS = [
# ...
'django.contrib.staticfiles',
# ...
'debug_toolbar',
]
STATIC_URL = '/static/'
Если вы выполняете обновление с предыдущей версии, вам следует просмотреть журнал изменений и найти конкретные инструкции по обновлению.
Настройка URLconf
Добавьте URL панели отладки в URLconf вашего проекта следующим образом:
from django.conf import settings
from django.conf.urls import include, url # For django versions before 2.0
from django.urls import include, path # For django versions from 2.0 and up
if settings.DEBUG:
import debug_toolbar
urlpatterns = [
path('__debug__/', include(debug_toolbar.urls)),
# For django versions before 2.0:
# url(r'^__debug__/', include(debug_toolbar.urls)),
] + urlpatterns
В этом примере используется префикс __debug__, но вы можете использовать любой префикс, который не конфликтует с URL-адресами вашего приложения. Обратите внимание на отсутствие кавычек вокруг debug_toolbar.urls.
Включение middleware
Панель инструментов отладки в основном реализована в промежуточном программном обеспечении. Включите его в вашем модуле настроек следующим образом:
MIDDLEWARE = [
# ...
'debug_toolbar.middleware.DebugToolbarMiddleware',
# ...
]
Предупреждение
Порядок
MIDDLEWARE
важен. Вы должны включить промежуточное программное обеспечение панели отладки как можно раньше в список. Однако он должен следовать за любым другимmiddleware, кодирующим содержимое ответа, таким как GZipMiddleware.
Настройка внутренних IP-адресов
Панель инструментов отладки отображается только в том случае, если ваш IP-адрес указан в настройке INTERNAL_IPS. Это означает, что для локальной разработки вы должны добавить ‘127.0.0.1’ в INTERNAL_IPS; вам нужно создать этот параметр, если он еще не существует в вашем модуле настроек:
INTERNAL_IPS = [
# ...
'127.0.0.1',
# ...
]
Вы можете изменить логику определения того, должна ли отображаться панель инструментов отладки, с помощью опции SHOW_TOOLBAR_CALLBACK. Эта опция позволяет вам указать пользовательскую функцию для этой цели.