Настройки Django ¶

Основы ¶

Файл настроек - это просто модуль Python с переменными уровня модуля.

Вот несколько примеров настроек:

ALLOWED_HOSTS = ['www.example.com']
DEBUG = False
DEFAULT_FROM_EMAIL = '[email protected]'

Поскольку файл настроек является модулем Python, применяется следующее:

• Это не допускает синтаксических ошибок Python.

• Он может назначать настройки динамически, используя обычный синтаксис Python. Например:

  MY_SETTING = [str(i) for i in range(30)]
  

• Он может импортировать значения из других файлов настроек.

Назначение настроек ¶

DJANGO_SETTINGS_MODULE¶

Когда вы используете Django, вы должны указать ему, какие настройки вы используете. Сделайте это с помощью переменной среды,DJANGO_SETTINGS_MODULE.

Значение DJANGO_SETTINGS_MODULEдолжен быть в синтаксисе пути Python, например mysite.settings. Обратите внимание, что модуль настроек должен находиться на пути поиска импорта Python .

export DJANGO_SETTINGS_MODULE=mysite.settings
django-admin runserver

set DJANGO_SETTINGS_MODULE=mysite.settings
django-admin runserver

django-admin runserver --settings=mysite.settings

import os

os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'

Настройки по умолчанию ¶

В файле настроек Django нет необходимости определять какие-либо настройки, если это не нужно. У каждой настройки есть разумное значение по умолчанию. Эти значения по умолчанию сохраняются в модуле django/conf/global_settings.py.

Вот алгоритм, который Django использует при компиляции настроек:

• Загрузить настройки из global_settings.py.
• Загрузите настройки из указанного файла настроек, при необходимости переопределив глобальные настройки.

Обратите внимание, что файл настроек не следует импортировать из global_settings, потому что он избыточен.

Использование настроек в коде Python ¶

В ваших приложениях Django используйте настройки, импортировав объект django.conf.settings. Пример:

from django.conf import settings

if settings.DEBUG:
    # Do something

Обратите внимание, что django.conf.settingsэто не модуль - это объект. Таким образом, импорт индивидуальных настроек невозможен:

from django.conf.settings import DEBUG  # This won't work.

Также обратите внимание, что ваш код не должен импортировать ни из global_settingsвашего собственного файла настроек, ни из вашего. django.conf.settingsабстрагирует концепции настроек по умолчанию и настроек для конкретного сайта; он представляет собой единый интерфейс. Он также отделяет код, использующий настройки, от местоположения ваших настроек.

Изменение настроек во время выполнения ¶

Вы не должны изменять настройки в ваших приложениях во время выполнения. Например, не делайте этого в представлении:

from django.conf import settings

settings.DEBUG = True   # Don't do this!

Единственное место, которое вы должны назначить настройкам, - это файл настроек.

Безопасность ¶

Поскольку файл настроек содержит конфиденциальную информацию, такую ​​как пароль базы данных, вы должны делать все возможное, чтобы ограничить доступ к нему. Например, измените права доступа к файлу так, чтобы его могли читать только вы и пользователь вашего веб-сервера. Это особенно важно в среде общего хостинга.

Доступные настройки ¶

Полный список доступных настроек см. В справке по настройкам .

Создание собственных настроек ¶

Вам ничего не мешает создать свои собственные настройки для ваших собственных приложений Django, но следуйте этим рекомендациям:

• Имена настроек должны быть полностью прописными.
• Не изобретайте заново уже существующий сеттинг.

Для настроек, являющихся последовательностями, сам Django использует списки, но это всего лишь соглашение.

Использование настроек без настройки DJANGO_SETTINGS_MODULE¶

В некоторых случаях может потребоваться обойти DJANGO_SETTINGS_MODULE переменная окружения. Например, если вы используете систему шаблонов отдельно, вы, вероятно, не захотите настраивать переменную среды, указывающую на модуль настроек.

В этих случаях вы можете настроить параметры Django вручную. Сделайте это, позвонив:

django.conf.settings.configure( default_settings , ** настройки ) ¶

Пример:

from django.conf import settings

settings.configure(DEBUG=True)

Передайте configure()столько аргументов ключевого слова, сколько хотите, причем каждый аргумент ключевого слова представляет параметр и его значение. Имя каждого аргумента должно быть написано заглавными буквами и иметь то же имя, что и настройки, описанные выше. Если конкретная настройка не передана configure()и понадобится позже, Django будет использовать значение настройки по умолчанию.

Подобная настройка Django в основном необходима - и даже рекомендуется - когда вы используете часть фреймворка внутри более крупного приложения.

Следовательно, при настройке с помощью settings.configure()Django не будет вносить никаких изменений в переменные среды процесса (см. Документацию о том, TIME_ZONEпочему это обычно происходит). В таких случаях предполагается, что вы уже полностью контролируете свою среду.

from django.conf import settings
from myapp import myapp_defaults

settings.configure(default_settings=myapp_defaults, DEBUG=True)

settings.configure(myapp_defaults, DEBUG=True)

from django.conf import settings
if not settings.configured:
    settings.configure(myapp_defaults, DEBUG=True)

import django
from django.conf import settings
from myapp import myapp_defaults

settings.configure(default_settings=myapp_defaults, DEBUG=True)
django.setup()

# Now this script or any imported module can use any part of Django it needs.
from myapp import models

if __name__ == '__main__':
    import django
    django.setup()