Django_-_podrobnoe_rukovodstvo

Кроме того, не разрешается вызывать функцию configure() более одного раза или вызывать ее после любого обращения к параметрам.

Проще говоря, используйте какой-нибудь один механизм: configure()

или DJANGO_SETTINGS_MODULE, причем однократно.

Перечень имеющихся параметров

В следующих разделах приводится перечень основных параметров в алфавитном порядке с указанием значений по умолчанию.

ABSOLUTE_URL_OVERRIDES

Значение по умолчанию: {} (пустой словарь)

Это словарь, отображающий строки вида “app_label.model_name” на функции, которые принимают объект модели и возвращают его URL. Применяется для переопределения методов get_absolute_url() в конкретной инсталляции. Например:

ABSOLUTE_URL_OVERRIDES = {

‘blogs.weblog’: lambda o: “/blogs/%s/” % o.slug,

‘news.story’: lambda o: “/stories/%s/%s/” % (o.pub_year, o.slug),

}

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

ADMIN_MEDIA_PREFIX

Значение по умолчанию: ‘/media/’

Префикс URL для вспомогательных файлов, используемых в админис­ тративном интерфейсе: CSS, JavaScript и изображений. Должен заканчиваться символом слеша.

ADMINS

Значение по умолчанию: () (пустой кортеж)

В этом кортеже перечисляются лица, которым следует посылать извещения об ошибках. Если DEBUG=False и представление возбуждает исключение, то Django посылает на их адреса электронной почты сообщения с подробной информацией об исключении. Каждый элемент кортежа должен быть кортежем вида (Полное имя, адрес электронной почты), например:

((‘John’, ‘john@example.com’), (‘Mary’, ‘mary@example.com’))

Подчеркнем, что Django посылает сообщения всем перечисленным лицам при возникновении любой ошибки.

ALLOWED_INCLUDE_ROOTS

Значение по умолчанию: () (пустой кортеж)

Кортеж строк, описывающих допустимые префиксы файлов, указываемых в шаблонном­ теге {% ssi %}. Это мера безопасности, не позволяющая авторам шаблонов­ обращаться к файлам, которые не имеют к ним отношения.

Например, если предположить, что параметр ALLOWED_INCLUDE_ROOTS имеет значение (‘/home/html’, ‘/var/www’), то тег {% ssi /home/html/foo.txt %} будет работать, а {% ssi /etc/passwd %} приведет к ошибке.

APPEND_SLASH

Значение по умолчанию: True

Определяет, нужно ли завершать URL-адреса символом слеша. Используется, только если установлен дополнительный процессор CommonMiddleware (см. главу 17). См. также описание параметра PREPEND_ WWW.

CACHE_BACKEND

Значение по умолчанию: ‘locmem://’

Определяет используемый механизм кэширования (см. главу 15).

CACHE_MIDDLEWARE_KEY_PREFIX

Значение по умолчанию: ‘’ (пустая строка)

Префикс ключа кэша, используемый дополнительным процессором кэширования (см. главу 15).

DATABASE_ENGINE

Значение по умолчанию: ‘’ (пустая строка)

Определяет реализацию механизма доступа к СУБД (например,

‘postgresql_psycopg2’ или ‘mysql’).

DATABASE_HOST

Значение по умолчанию: ‘’ (пустая строка)

Адрес сервера базы данных. Пустая строка означает localhost. Для SQLite игнорируется.

Если вы работаете с СУБД MySQL и значение параметра начинается с символа слеша (/), то подключение к MySQL будет производиться посредством UNIX-сокета:

DATABASE_HOST = ‘/var/run/mysql’

Если вы работаете с СУБД MySQL и значение параметра не начинается с символа слеша, то предполагается, что это доменное имя или IP-адрес сервера.

DATABASE_NAME

Значение по умолчанию: ‘’ (пустая строка)

Имя базы данных. Для SQLite полный путь к файлу базы данных.

DATABASE_OPTIONS

Значение по умолчанию: {} (пустой словарь)

Дополнительные параметры, необходимые для подключения к базе данных. Их названия описаны в документации по модулю интерфейса с соответствующей СУБД.

DATABASE_PASSWORD

Значение по умолчанию: ‘’ (пустая строка)

Пароль для подключения к базе данных. Для SQLite игнорируется.

DATABASE_PORT

Значение по умолчанию: ‘’ (пустая строка)

Номер порта для подключения к базе данных. Пустая строка означает, что следует использовать стандартный номер порта. Для SQLite игнорируется.

DATABASE_USER

Значение по умолчанию: ‘’ (пустая строка)

Имя пользователя для подключения к базе данных. Для SQLite игнорируется.

DATE_FORMAT

Значение по умолчанию: ‘N j, Y’ (например, Feb. 4, 2003)

Формат полей даты по умолчанию, используемый в списках для изменения, отображаемых в административном интерфейсе Django, и, возможно, в других местах системы­. Синтаксис определения формата такой же, как в теге now (см. приложение E, табл. E.2).

См. также описания параметров DATETIME_FORMAT, TIME_FORMAT, YEAR_MONTH_ FORMAT и MONTH_DAY_FORMAT.

DATETIME_FORMAT

Значение по умолчанию: ‘N j, Y, P’ (например, Feb. 4, 2003, 4 p.m.)

DISALLOWED_USER_AGENTS

Значение по умолчанию: () (пустой кортеж)

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

EMAIL_HOST

Значение по умолчанию: ‘localhost’

Почтовый сервер, через который отправляется электронная почта. См. также описание параметра EMAIL_PORT.

EMAIL_HOST_PASSWORD

Значение по умолчанию: ‘’ (пустая строка)

Пароль для доступа к SMTP-серверу, указанному в параметре EMAIL_ HOST. Используется в сочетании с параметром EMAIL_HOST_USER для аутентификации на почтовом сервере. Если хотя бы один из этих параметров пуст, Django не будет пытаться аутентифицироваться.

См. также описание параметра EMAIL_HOST_USER.

EMAIL_HOST_USER

Значение по умолчанию: ‘’ (пустая строка)

Имя пользователя для доступа к SMTP-серверу, указанному в параметре EMAIL_HOST. Если значение пусто, то Django не будет пытаться аутентифицироваться. См. также описание параметра EMAIL_HOST_PASSWORD.

EMAIL_PORT

Значение по умолчанию: 25

Номер порта для доступа к SMTP-серверу, заданному в параметре EMAIL_ HOST.

EMAIL_SUBJECT_PREFIX

Значение по умолчанию: ‘[Django] ‘

Префикс темы в заголовке Subject сообщений, отправляемых с помощью модулей django.core.mail.mail_admins или django.core.mail.mail_ managers. Рекомендуется добавлять в конце пробел.

FIXTURE_DIRS

Значение по умолчанию: () (пустой кортеж)

Перечень каталогов расположения файлов тестовых данных в порядке просмотра. Отметим, что компоненты пути в именах каталогов должны разделяться символами прямого слеша, даже для платформы Windows. Используется в системе­ тестирования Django, которая подробно описана на странице http://docs.djangoproject.com/en/dev/topics/testing/.

IGNORABLE_404_ENDS

Значение по умолчанию: (‘mail.pl’, ‘mailform.pl’, ‘mail.cgi’, ‘mailform.cgi’, ‘favicon.ico’, ‘.php’)

Этот кортеж состоит из строк, описывающих суффиксы URL, которые должны игнорироваться при рассылке извещений об ошибке 404 (подробнее об этом см. главу 12).

Извещения об ошибках 404, возникших при обращении к адресу URL, заканчивающемуся любой из таких строк, не посылаются.

См. также описания параметров IGNORABLE_404_STARTS и SEND_BROKEN_LINK_ EMAILS.

IGNORABLE_404_STARTS

Значение по умолчанию: (‘/cgi-bin/’, ‘/_vti_bin’, ‘/_vti_inf’)

То же, что и параметр IGNORABLE_404_ENDS, но относится к префиксам URL.

См. также описания параметров IGNORABLE_404_ENDS и SEND_BROKEN_LINK_ EMAILS.

INSTALLED_APPS

Значение по умолчанию: () (пустой кортеж)

Кортеж строк, описывающий все активированные приложения в данной инсталляции Django. Каждая строка должна содержать полный путь Python к пакету приложения Django. Подробнее о приложениях см. главу 5.

LANGUAGE_CODE

Значение по умолчанию: ‘en-us’

Код языка для данной инсталляции. Должен быть указан в стандартном формате; например, американский диалект английского языка обозначается “en-us”. См. главу 19.

LANGUAGES

Значение по умолчанию: кортеж, содержащий все поддерживаемые языки. Этот список постоянно расширяется, поэтому какой бы перечень мы здесь ни привели, он очень быстро устареет. Актуальный пере-

чень языков, на которые переведен Django, можно найти в файле django/ conf/global_settings.py.

Перечень представляет собой кортеж, каждый элемент которого является кортежем вида (код языка, название языка), например, (‘ja’, ‘Japanese’). Из этого перечня можно выбирать язык сайта. О выборе языка см. главу 19.

Обычно значения по умолчанию вполне достаточно. Изменять этот параметр следует лишь в том случае, если вы хотите ограничить выбор языка подмножеством из всех доступных.

Если вы переопределите параметр LANGUAGES, то названия языков можно задавать как строки для перевода, но ни в коем случае не следует импортировать модуль django.utils.translation из файла параметров, потому что сам этот модуль зависит от параметров, и импортирование этого модуля приведет к образованию циклической­ зависимости.

Решить проблему можно путем использования «фиктивной» функции gettext(). Вот пример фрагмента файла параметров:

gettext = lambda s: s

LANGUAGES = (

(‘de’, gettext(‘German’)), (‘en’, gettext(‘English’)),

)

В этом случае утилита make-messages.py найдет и пометит эти строки для перевода, но на этапе выполнения перевод производиться не будет; вы должны не забыть обернуть названия языков настоящей функцией gettext() в любом месте программы, где используется параметр

LANGUAGES.

MANAGERS

Значение по умолчанию: () (пустой кортеж)

Кортеж в таком же формате, как ADMINS; определяет, кто должен получать извещения о «битых» ссылках, когда параметр SEND_BROKEN_LINK_ EMAILS=True.

MEDIA_ROOT

Значение по умолчанию: ‘’ (пустая строка)

Абсолютный путь к каталогу, где хранятся мультимедийные файлы для данной инсталляции (например, “/home/media/media.lawrence.com/”). См. также описание параметра MEDIA_URL.

MEDIA_URL

Значение по умолчанию: ‘’ (пустая строка)