Основы¶

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

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

ALLOWED_HOSTS = ['www.example.com']
DEBUG = False
DEFAULT_FROM_EMAIL = 'webmaster@example.com'

Так как файл настроек это модуль Python, верно следующее:

• Не допускаются ошибки синтаксиса Python.

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

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

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

Определения файла настроек¶

DJANGO_SETTINGS_MODULE¶

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

The value of DJANGO_SETTINGS_MODULE should be in Python path syntax, e.g. mysite.settings. Note that the settings module should be on the Python import search path.

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'

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

A Django settings file doesn’t have to define any settings if it doesn’t need to. Each setting has a sensible default value. These defaults live in the module 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, **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()