Настройки 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 , так как это будет лишним.

Использование настроек в коде 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, но следуйте этим рекомендациям:

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

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

Использование настроек без настройки 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 особенно необходима (и даже рекомендуется) при использовании части инфраструктуры Django в более крупном приложении.

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

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()