settings に設定できる値

revision-up-to:11321 (1.1)

このドキュメントでは、利用可能な全ての設定のリストを示します。リストはアル ファベット順で、デフォルト値も示します。

ABSOLUTE_URL_OVERRIDES

デフォルト値: {} (空の辞書)

モデルオブジェクトのパスを表す文字列 "app_label.model_name" から、モデ ルオブジェクトを引数にとり URL を返すような関数への対応づけを行うための辞書 です。 Django で作成したプロジェクトのインストール先ごとに 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_FOR

デフォルト値: () (空のタプル)

admin 用サイトの設定モジュールで設定します。このサイトの admin を他のサイト の admin にする場合、設定モジュールを ('foo.bar.baz' の形式のタプルで) 指定します。

admin サイトはこの変数を使って、モデルやビュー、テンプレートタグのドキュメ ントに対するイントロスペクションを自動的に行います。

ADMIN_MEDIA_PREFIX

デフォルト値: '/media/'

Django の管理インタフェース上で使われている CSS, JavaScript, 画像といった、 いわゆる admin メディアへの URL プレフィクスです。必ず末尾にスラッシュをつ けてください。また、この値は MEDIA_URL と同じにしないでください (さもな いと、二つのファイルに同じ URL がマップされてしまいます)。

ADMINS

デフォルト値: () (空のタプル)

コード中で発生したエラーを報告する連絡先を列挙するタプルです。 DEBUG=False の設定で、ビューが例外を送出すると、 Django はこの設定値に 列挙されている相手全てに全ての例外情報の入った通知メールを送ります。タプル に入れる各メンバは、 (Full name, e-mail address) の形式で指定します。例えば:

(('John', 'john@example.com'), ('Mary', 'mary@example.com'))

Django はエラーが生じたときに、このリストに登録されている 全ての 宛先にメー ルを送信します。詳しくは howto-error-reporting を参照してください。

ALLOWED_INCLUDE_ROOTS

デフォルト値: () (空のタプル)

{% ssi %} テンプレートタグで取り込める URL のプレフィクスを表す文字列か らなるタプルです。この設定はセキュリティを高めるためのもので、テンプレート の作者に取り込みを禁じられているファイルにアクセスさせないようにします。

例えば、 ALLOWED_INCLUDE_ROOTS('/home/html', '/var/www') にして おくと、 {% ssi /home/html/foo.txt %} は期待通りに動作しますが、 {% ssi /etc/passwd %} はうまくいきません。

APPEND_SLASH

デフォルト値: True

URL の末尾に常にスラッシュを追加するかどうかを決めます。 CommonMiddleware がインストールされている場合にしか使われません。 (topics-http-middleware を参照してください。) PREPEND_WWW も参照 してください。

AUTHENTICATION_BACKENDS

デフォルト値: ('django.contrib.auth.backends.ModelBackend',)

認証バックエンドのクラス名を (文字列で) 列挙したタプルです。ユーザ認証を試 みる際に使われます。詳しくは 認証バックエンドのドキュメント を参照して ください。

AUTH_PROFILE_MODULE

デフォルト値: 定義されていません

サイト固有のユーザプロファイルモデルです。詳しくは 追加のユーザ情報の保存 を参照してください。

CACHE_BACKEND

デフォルト値: 'locmem://'

利用するキャッシュバックエンドを指定します。 Django のキャッシュフレームワーク を参照して ください。

CACHE_MIDDLEWARE_KEY_PREFIX

デフォルト値: '' (空文字列)

キャッシュミドルウェアが使うキャッシュキープレフィクスを指定します。 Django のキャッシュフレームワーク を参照してください。

CACHE_MIDDLEWARE_SECONDS

デフォルト値: 600

キャッシュミドルウェアや cache_page() デコレータを使うときに、ページを キャッシュしておく秒数のデフォルト値です。

DATABASE_ENGINE

デフォルト値: '' (空文字列)

どのデータベースバックエンドを使うかを指定します。組み込みのデータベースバッ クエンドは、 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3', 'oracle' です。

Django に組み込まれていないデータベースバックエンドを組み込むために、 DATABASE_ENGINE にバックエンドモジュールの完全指定パス (例えば mypackage.backends.whatever) を指定できます。全く新しいデータベースバッ クエンドの作成は、読者の皆さんに委ねます。他のバックエンドの例を参照してく ださい。 .. versionchanged:: 1.0

1.0 で、外部のデータベースバックエンドをサポートしました。

DATABASE_HOST

デフォルト値: '' (空文字列)

データベース接続先のホストを指定します。空にしておくと localhost になります。 SQLite では使いません。

この変数がスラッシュ ('/') で始まっていて、 MySQL を使っている場合、 MySQL は指定された Unix ソケットを介して接続します。例えば:

DATABASE_HOST = '/var/run/mysql'

のように指定します。 MySQL を使っていて、この変数がスラッシュで始まっていな い場合には、この変数はホスト名として扱われます。

PostgreSQL を使っている場合、 DATABASE_HOST に空文字列を指定すると、 Unix ドメインソケットを使った接続を意味します。ローカルホストに対する TCP/IP 接続を指定したければ localhost と指定してください。

DATABASE_NAME

デフォルト値: '' (空文字列)

データベースの名前です。 SQLite の場合は、データベースファイルへのフルパス です。パスを指定するときは、 Windows 環境でも必ずスラッシュ (/) を区 切り文字に使ってください (例: C:/homes/user/mysite/sqlite3.db)。

DATABASE_OPTIONS

デフォルト値: {} (空の辞書)

データベースに接続するときの追加のパラメタです。利用できるキーワードは個々 のバックエンドモジュールのドキュメントを参照してください。

DATABASE_PASSWORD

デフォルト値: '' (空文字列)

データベースに接続するときのパスワードです。SQLite では使いません。

DATABASE_PORT

デフォルト値: '' (空文字列)

データベースに接続するときのポート番号です。空文字を指定するとデフォルトの ポートを使います。SQLite では使いません。

DATABASE_USER

デフォルト値: '' (空文字列)

データベースに接続するときのユーザ名です。SQLite では使いません。

DATE_FORMAT

デフォルト値: 'N j, Y' (e.g. Feb. 4, 2003)

Django の admin サイトの変更履歴ページ (や、システムの他の部分で) 日付フィー ルドの表示に使うデフォルトのフォーマットです。 利用可能な日付フォーマット文字 を参照してください。

DATETIME_FORMAT , TIME_FORMAT , YEAR_MONTH_FORMAT および MONTH_DAY_FORMAT も参照してください。

DATETIME_FORMAT

デフォルト値: 'N j, Y, P' (e.g. Feb. 4, 2003, 4 p.m.)

Django の admin サイトの変更履歴ページ (や、システムの他の部分で) 日時フィー ルドの表示に使うデフォルトのフォーマットです。 利用可能な日付フォーマット文字 を参照してください。

DATE_FORMAT , TIME_FORMAT , YEAR_MONTH_FORMAT および MONTH_DAY_FORMAT も参照してください。

DEBUG

デフォルト値: False

デバッグモードのオンオフを切替えるブール値です。

settings に自作の設定項目を追加する場合、 django/views/debug.pyHIDDEN_SETTINGS に注意してください。この変数は正規表現になっていて、デ フォルトでは 'SECRET', 'PASSWORD', 'PROFANITIES' といった文字列 を含む全ての設定の DEBUG ビューへの表示を抑制して、信頼されていないユーザが バックトレースから重要な (あるいは攻撃的な) 設定項目を見なくてすむようにし ているからです。

とはいえ、デバッグ出力の様々な情報は、いついかなる状況でも衆目に晒すべきも のではないということを心得ておきましょう。ファイルパス、各設定項目などは、 攻撃者に対してサーバの様々な情報を与えてしまいます。

また、 DEBUG をオンにして Django を起動すると、Django は実行した SQL ク エリを全て記憶してしまうことも忘れないでください。この機能はデバッグ時には 便利ですが、運用時に使うとあっという間にメモリを消費してしまうでしょう。

決して DEBUG をオンにしたままサーバを運用しないでください。

DEBUG_PROPAGATE_EXCEPTIONS

デフォルト値: False

True にすると、 Django が通常ビュー関数に対して行っている例外処理が抑制 され、例外がそのまま送出されるようになります。テスト時に便利な機能ですが、 実運用環境で使うべきではありません。

DEFAULT_CHARSET

デフォルト値: 'utf-8'

全ての HttpResponse オブジェクトで、MIME タイプを手動で指定しなかった場 合に使われるデフォルトの文字セットです。 Content-Type ヘッダの生成時に DEFAULT_CONTENT_TYPE とともに使われます。

DEFAULT_CONTENT_TYPE

デフォルト値: 'text/html'

全ての HttpResponse オブジェクトで、MIME タイプを手動で指定しなかった場 合に使われるデフォルトのコンテンツタイプです。 Content-Type ヘッダの生 成時に DEFAULT_CHARSET とともに使われます。

DEFAULT_FILE_STORAGE

デフォルト値: django.core.files.storage.FileSystemStorage

特定のストレージシステムに依存せずにファイル関連の操作を行うときに使う、 デフォルトのファイルストレージクラスです。 topics-files を参照してく ださい。

DEFAULT_FROM_EMAIL

デフォルト値: 'webmaster@localhost'

サイト管理者からのさまざまな自動応答で使われるデフォルトの e-mail アドレス です。

DEFAULT_TABLESPACE

デフォルト値: '' (空文字列)

テーブルスペース名を明示していないモデルに使われるテーブルスペース 名です。バックエンドがサポートしている場合に限って有効です。

DEFAULT_INDEX_TABLESPACE

デフォルト値: '' (空文字列)

テーブルスペース名を明示していないフィールドインデクスに使われるテーブルス ペース名です。バックエンドがサポートしている場合に限って有効です。

DISALLOWED_USER_AGENTS

デフォルト値: () (空のタプル)

システム全体にわたり、ページの閲覧を許さないクライアントの User-Agent を表 すコンパイル済みの正規表現オブジェクトからなるリストです。相手にしたくない ロボットやクローラがいる場合に使って下さい。この設定は CommonMiddleware がインストールされている場合にしか使われません。 (topics-http-middleware を参照してください)。

EMAIL_HOST

デフォルト値: 'localhost'

e-mail の送信に使われるホスト名です。

EMAIL_PORT も参照してください。

EMAIL_HOST_PASSWORD

デフォルト値: '' (空文字列)

EMAIL_HOST に指定した SMTP サーバにアクセスする際のパスワードです。この 設定は EMAIL_HOST_USER と組み合わせて、 SMTP サーバの認証に使われます。 EMAIL_HOST_USEREMAIL_HOST_PASSWORD のどちらかが空文字列の場合、 Django は SMTP への認証を試みません。

EMAIL_HOST_USER も参照してください。

EMAIL_HOST_USER

デフォルト値: '' (空文字列)

EMAIL_HOST で定義されている SMTP サーバへのアクセスに使われるユーザ名で す。空文字列の場合、 Django は SMTP への認証を試みません。

EMAIL_HOST_PASSWORD も参照してください。

EMAIL_PORT

デフォルト値: 25

EMAIL_HOST で定義されている SMTP サーバのポート番号です。

EMAIL_SUBJECT_PREFIX

デフォルト値: '[Django] '

django.core.mail.mail_adminsdjango.core.mail.mail_managers が送 信するメールの題名に使われるプレフィクスです。末尾にはスペースを入れておいた 方がよいでしょう。

EMAIL_USE_TLS

デフォルト値: False

SMTP サーバとの通信に TLS (安全な接続) を使うかどうかを指定します。

FILE_CHARSET

デフォルト値: 'utf-8'

テンプレートファイルや SQL のデータファイルなどのファイルをファイルシステム から読み出すときに使う文字エンコーディングです。

FILE_UPLOAD_HANDLERS

デフォルト値:

("django.core.files.fileuploadhandler.MemoryFileUploadHandler",
 "django.core.files.fileuploadhandler.TemporaryFileUploadHandler",)

ファイルアップロード時に使うハンドラを指定するタプルです。詳しくは topics-files を参照してください。

FILE_UPLOAD_MAX_MEMORY_SIZE

デフォルト値: 2621440 (2.5 MB).

アップロード中のファイルをファイルシステム上にストリーム書き込み開始するま でに受け入れる最大サイズ (単位バイト) です。詳しくは topics-files を 参照してください。

FILE_UPLOAD_TEMP_DIR

デフォルト値: None

アップロード中のファイルを一時的に保存するためのディレクトリです。 None に指定すると、オペレーティングシステムごとに標準の一時ディレクトリを使いま す。例えば、 *nix スタイルのオペレーティングシステムでは ‘/tmp’ です。

詳しくは topics-files を参照してください。

FILE_UPLOAD_PERMISSIONS

デフォルト値: None

アップロードされたファイルに設定するファイルモードで、数字で表現 (例: 0644) します。ファイルモードの意味は os.chmod のドキュメント を 参照してください。

この値を設定しないか、 None にすると、アップロードされたファイルのモー ドはオペレーティングシステムに依存します。ほとんどのプラットフォームでは、 一時ファイルのファイルモードは 0600 で、メモリからファイルにデータを書 き出すときにはシステム標準の umask を使います。

Warning

ファイルモードの先頭には常に ``0`` をつけてください.

ファイルモードにあまりくわしくないのなら、先頭の 0 がとても 重要だということに注意してください。先頭の 0 は、値が 8 進数で あることを示しています。 644 のように指定すると、全くおかし な挙動になってしまうでしょう。

FIXTURE_DIRS

デフォルト値: () (空のタプル)

フィクスチャデータファイルの検索対象ディレクトリを順に挙げたリストです。 パスの表記は (Windows 環境でも) Unix 形式の前向きスラッシュにせねばなりませ ん。 Djangoアプリケーションのテスト も参照してください。

FORCE_SCRIPT_NAME

デフォルト値: None

None に指定すると、 HTTMP リクエストの SCRIPT_NAME 環境変数の代わり に指定値を使います。この設定は、サーバが指定する SCRIPT_NAME の内容を上 書きしたり、 SCRIPT_NAME を空にしたりするために使えます。

IGNORABLE_404_ENDS

デフォルト値: ('mail.pl', 'mailform.pl', 'mail.cgi', 'mailform.cgi', 'favicon.ico', '.php')

IGNORABLE_404_STARTS と 「 電子メールによるエラー通知 」を参照してく ださい。

IGNORABLE_404_STARTS

デフォルト値: ('/cgi-bin/', '/_vti_bin', '/_vti_inf')

404 通知 e-mail を使っている場合、このタプルに指定した文字列から始まる URL は無視されます。 SEND_BROKEN_LINK_EMAILS, IGNORABLE_404_ENDS および 電子メールによるエラー通知 も参照してくださ い。

INSTALLED_APPS

デフォルト値: () (空のタプル)

現在の Django インストール下で有効にしたい全てのアプリケーションを表す文字 列のタプルです。各文字列は、 django-admin.py startapp で作成した Django アプリケーションの入った Python パッケージを示す完全な Python パスでなければなりません。

INTERNAL_IPS

デフォルト値: () (空のタプル)

文字列で表した IP アドレスのタプルです。

  • DEBUGTrue の場合、デバッグコメント中に表示されます。
  • XViewMiddleware がインストールされている場合、X ヘッダを受信しま す。(topics-http-middleware も参照してください。)

LANGUAGE_CODE

デフォルト値: 'en-us'

現在の Django インストールにおける言語コード文字列です。この値は標準の言語 指定形式にせねばなりません。たとえば U.S. English は "en-us" にします。 topics-i18n も参照してください。

LANGUAGES

デフォルト値: 利用可能な言語からなるタプルです。このリストには頻繁に新たな 言語が登場しているので、そのコピーをここに記載していてもすぐに古い情報になっ てしまいます。現在サポートされている言語のリストは手元のソースコード中の django/conf/global_settings.py (または オンラインのソースコード) を 参照してください。

このリストは、例えば ('ja', 'Japanese') のように、 (言語コード, 言語名) の形式のタプルでできており、国際化機能で選択可能な言語を指定するために使い ます。詳しくは topics-i18n を参照してください。

一般に、デフォルト値をいじる必要はありません。Django が提供している言語セッ トの選択肢を狭めたい場合のみ設定してください。

カスタムの LANGUAGE 設定を定義する場合、(上の例に示したように) 各言語を 翻訳文字列として定義してかまいませんが、 django.utils.translationgettext() 関数ではなく、「ダミーの」 gettext() を使うようにしてくだ さい。設定ファイル内では 決して django.utils.translation を import し ないでください。このモジュールは settings の内容に依存しているため、循環 import を引き起こしてしまうからです。

解決方法は、上でも述べたように「ダミーの」 gettext() を使うというもので す。以下に設定ファイルの例を示します:

gettext = lambda s: s

LANGUAGES = (
    ('de', gettext('German')),
    ('en', gettext('English')),
)

このような書き方をした場合、 django-admin.py makemessage は翻訳対象文字 列をきちんと取り出せます。しかし、実行時に翻訳は行われません。従って、実行 時に LANGUAGES を使うようなコードでは、 本当の gettext() を使って 言語名をラップするようにしてください。

LOCALE_PATHS

デフォルト値: () (空のタプル)

Django が翻訳ファイルを探しに行く場所を指定するためのタプルです。 この変数の詳細とデフォルトの動作については、 translations-in-your-own-projects を参照してください。

LOGIN_REDIRECT_URL

デフォルト値: '/accounts/profile/'

controb.auth.login ビューに next パラメタが指定されていない場合の、 デフォルトのリダイレクト先 URL です。

login_required() デコレータを利用する ときなどに使う設定です。

LOGIN_URL

デフォルト値: '/accounts/login/'

login_required() デコレータを利用す るときなどに、ログインページへのリダイレクト先として使う設定です。

LOGOUT_URL

デフォルト値: '/accounts/logout/'

LOGIN_URL の対極にあたる、ログアウトページへのリダイレクト URL です。

MANAGERS

デフォルト値: () (空のタプル)

ADMINS と同じ形式のタプルで、 SEND_BROKEN_LINK_EMAILS=True の時に壊 れたリンクの通知を受けるメンバを指定します。

MEDIA_ROOT

デフォルト値: '' (空文字列)

現在の Django インストールにおいて、メディアファイルを収めているディレクト リへの絶対パスです。例えば "/home/media/media.lawrence.com/" です。 MEDIA_URL も参照してください。

MEDIA_URL

デフォルト値: '' (空文字列)

MEDIA_ROOT で提供されているメディアファイルを扱う URL です。例えば "http://media.lawrence.com" です。

URL にパス部を含める場合、末尾はスラッシュにせねばなりません。

良い例: "http://www.example.com/static/" 悪い例: "http://www.example.com/static"

MIDDLEWARE_CLASSES

デフォルト値:

('django.middleware.common.CommonMiddleware',
 'django.contrib.sessions.middleware.SessionMiddleware',
 'django.contrib.auth.middleware.AuthenticationMiddleware',)

利用するミドルウェアクラスの Python パス名からなるタプルです。 topics-http-middleware も参照してください。.

MONTH_DAY_FORMAT

デフォルト値: 'F j'

Django の admin サイトにおける変更リストの日付フィールドの他、システムの各 所で月と日だけを表示する際に使われるデフォルトのフォーマットです。

例えば、 Django の admin サイトにおける変更リストページを日付による絞り込み でフィルタする場合、指定日のヘッダには日と月が表示されます。ロケールによっ ては異なったフォーマットになります。例えば、 U.S. English での “January 1” は、スペイン語では “1 Enero.” です。

利用可能な日付フォーマット文字 を参照してください。 DATE_FORMAT, DATETIME_FORMAT , TIME_FORMAT , YEAR_MONTH_FORMAT も参照してください。

PREPEND_WWW

デフォルト値: False

URL にサブドメイン名 “www.” が付いていない場合に付加するかどうかを決めます。 CommonMiddleware がインストールされている場合にのみ使われる設定です (topics-http-middleware を参照してください)。 APPEND_SLASH も参 照してください。

PROFANITIES_LIST

非道徳的な言葉 (profanity) のタプルです。 hasNoProfanities バリデータが 呼び出された際に、エラーを引き起こす単語のリストに使われます。

デフォルト値はここでは示しません。不道徳な言葉が入っているからです。デフォ ルト値を見たければ、 django/conf/global_settings.py を参照してください。

ROOT_URLCONF

デフォルト値: 定義されていません

ルート URLconf への完全な Python import パスを表す表す文字列です。例えば、 "mydjangoapps.urls" です。ルート URLconf は、 HttpRequest オブジェ クトに urlconf 属性を設定することで変更できます。 詳しくは Django のリクエスト処理 を参照してください。

SECRET_KEY

デフォルト値: '' (空文字列)

Django インストール毎に固有の秘密の鍵です。秘密鍵を使ったハッシュアルゴリズ ムのシードを生成するために使います。この値はランダムな文字列に指定してくだ さい。長ければ長いほど好ましくなります。 django-admin.py startproject を実行すると、自動的に値を生成します。

SERIALIZATION_MODULES

デフォルト値: 定義されていません

シリアライザのモジュールパスを (文字列) 指定した辞書です。辞書のキーはシリ アライザの識別名にします。例えば、 YAML のシリアライザを定義するには以下の ようにします:

SERIALIZATION_MODULES = { 'yaml' : 'path.to.yaml_serializer' }

SERVER_EMAIL

デフォルト値: 'root@localhost'

ADMINSMANAGERS にエラーメッセージを送信するときの送信元の e-mail アドレスです。

SESSION_ENGINE

デフォルト値: django.contrib.sessions.backends.db

Django がセッションデータを保存する方法を指定します。利用できる値は以下の通 りです:

  • 'django.contrib.sessions.backends.db'
  • 'django.contrib.sessions.backends.file'
  • 'django.contrib.sessions.backends.cache'

詳しくは セッションの使い方 を参照してください。

SESSION_EXPIRE_AT_BROWSER_CLOSE

デフォルト値: False

ブラウザを閉じたときにセッションを期限切れにするかどうかを決めます。 セッションの使い方 を参照してください。

SESSION_FILE_PATH

デフォルト値: None

ファイルベースのセッションストレージを使っている場合、この値でセッションデー タの保存場所を指定します。詳しくは セッションの使い方 を参照してく ださい。デフォルト値 (None) にすると、システム標準の一時ディレクトリを 使います。

SESSION_SAVE_EVERY_REQUEST

デフォルト値: False

リクエストごとにセッションデータを保存するかどうかを決めます。 セッションの使い方 も参照してください。

SITE_ID

デフォルト値: 定義されていません

django_sites データベース中で現在のサイトを示す ID の整数値です。この値 は、アプリケーションデータが特定のサイトに対してフックできるようにし、一つ のデータベースで複数のサイトのコンテンツを管理できるようにするためのもので す。

“sites” フレームワーク を参照してください。

TEMPLATE_CONTEXT_PROCESSORS

デフォルト値:

("django.core.context_processors.auth",
"django.core.context_processors.debug",
"django.core.context_processors.i18n",
"django.core.context_processors.media")

RequestContext のコンテキストに値を入れてゆく際に使われる呼び出し可能オ ブジェクトからなるタプルです。これらの呼び出し可能オブジェクトはリクエスト オブジェクトを引数にとり、コンテキストに統合する項目からなる辞書を返します。

TEMPLATE_DEBUG

デフォルト値: False

テンプレートのデバッグモードのオンオフを切替えるブール値です。この値を True にすると、 TemplateSyntaxError を報告する際にファンシーなエラー ページを出力します。この報告にはエラーに関係するテンプレートの一部分が表示 され、問題のある部分がハイライト表示されます。

Django は DEBUGTrue の場合にのみエラーページを表示するので、こ の設定の恩恵をうけたければ DEBUG を設定しておく必要があります。

DEBUG も参照してください。

TEMPLATE_DIRS

デフォルト値: () (空のタプル)

テンプレートソースファイルの入っている場所を検索順に並べたリストです。パス の区切りには Windows であっても Unix 形式のスラッシュを使って下さい。

Django テンプレート言語 も参照してください。.

TEMPLATE_LOADERS

デフォルト値:

('django.template.loaders.filesystem.load_template_source',
 'django.template.loaders.app_directories.load_template_source')

様々なソースからのテンプレートの import を実装している、呼び出し可能オブジェ クト (を指す文字列) のタプルです。 Python プログラマのための Django テンプレート言語ガイド も参照してくだ さい。

TEMPLATE_STRING_IF_INVALID

デフォルト値: '' (空文字列)

誤った (スペルを間違えたなど) 変数名に対してテンプレートシステムが出力する 文字列です。 無効な値の扱い を参照してください。

TEST_DATABASE_CHARSET

デフォルト値: None

テストデータベースの作成に使われている文字セットエンコーディングです。この 文字列の値はデータベースバックエンドに直接渡されるので、エンコーディングの 名前や書式はバックエンドごとに異なります。

この設定をサポートしているバックエンドは、 PostgreSQL (postgresql, postgresql_psycopg2) と MySQL (mysql) です。

TEST_DATABASE_COLLATION

デフォルト値: None

テストデータベースを生成する際のコレーション (collation) です。この値はデー タベースバックエンドに直接渡されるので、値の書式はバックエンドごとに異なり ます。

mysql バックエンドだけでサポートされています(くわしくは、MySQLマニュア ルの 10.3.2節 を参照してください)

TEST_DATABASE_NAME

デフォルト値: None

テストスイートを実行するときに使うデータベースの名前です。

データベースエンジンが SQLite のときにデフォルト値 (None) を指定すると、 テストのためのデータベースはメモリ上に展開されます。他のデータベースエンジ ンの場合、テストデータベースの名前として 'test_' + settings.DATABASE_NAME を使います。

Djangoアプリケーションのテスト を参照してください。

TEST_RUNNER

デフォルト値: 'django.test.simple.run_tests'

テストスイートを起動するためのメソッドの名前です。 Djangoアプリケーションのテスト を 参照してください。

TIME_FORMAT

デフォルト値: 'P' (e.g. 4 p.m.)

Django の admin サイトの変更履歴ページ (や、システムの他の部分で) 時刻フィー ルドの表示に使うデフォルトのフォーマットです。 利用可能な日付フォーマット文字 を参照してください。

DATE_FORMAT , DATETIMETIME_FORMAT , YEAR_MONTH_FORMAT および MONTH_DAY_FORMAT も参照してください。

TIME_ZONE

デフォルト値: 'America/Chicago'

現在の Django インストールが使うタイムゾーンを表す文字列です。 利用可能な選択肢 を参照してください。(利用可能な選択肢には、同じ行に複数 の選択肢をリストしていることに注意してください。あるタイムゾーンを表すには いずれか一つを選ぶことになります。例えば、ある行に 'Europe/London GB GB-Eire' と書かれている場合、 TIME_ZONE の設定には、最初の部分である 'Europe/London' だけを使います)。

この値は Django が全ての日付/時刻の変換に使うタイムゾーンであり、かならずし もサーバのタイムゾーンとは一致しないことに注意して下さい。例えば、一つのサー バで複数の Django サイトを運営し、個々に別々のタイムゾーン設定を持たせても かまいません。

通常、 Django は TIME_ZONE の設定に従って os.environ['TZ'] 変数を設 定します。そのため、ビューやモデルは自動的に正しいタイムゾーンを扱えるよう になります。しかしながら、 手動で設定する 場合には、 Django は TZ 環境変数を 操作しない ので、ユーザは自分の責任でプロセス を正しい環境の下で動作させねばなりません。

Note

Windows 環境では、 Django は信頼性のある方法でタイムゾーンを変更できま せん。 Windows で Django を動作させる場合、この変数はシステムのタイムゾー ンと一致させねばなりません。

URL_VALIDATOR_USER_AGENT

デフォルト値: Django/<version> (http://www.djangoproject.com/)

特定の URL が実在するかを Django が調べにゆく際に使う User-Agent ヘッダ の値です。 (URLFieldverify_exists を参照 してください。)

USE_ETAGS

デフォルト値: False

出力に “Etag” ヘッダを含めるかどうかを決めるブール値です。 “Etag” を含める と帯域の節約になりますが、パフォーマンスは低下します。この設定は CommonMiddleware がインストールされている場合にしか使われません。 (topics-http-middleware を参照してください。)

USE_I18N

デフォルト値: True

国際化システムを有効にするかどうかを決めるブール値です。この設定を使うと、 パフォーマンス向上のために簡単に国際化システムを無効化できます。この値を False にすると、 Django は国際化機構をロードしないような最適化を行いま す。

YEAR_MONTH_FORMAT

デフォルト値: 'F Y'

Django の admin サイトにおける変更リストの日付フィールドの他、システムの各 所で年と月だけを表示する際に使われるデフォルトのフォーマットです。

例えば、 Django の admin サイトにおける変更リストページを日付による絞り込み でフィルタする場合、指定月のヘッダには月と年が表示されます。ロケールによっ ては異なったフォーマットになります。例えば、 U.S. English での “January 2006” は、別のロケールでは “2006/January” になるかもしれません。

利用可能な日付フォーマット文字 を参照してください。 DATE_FORMAT , DATETIME_FORMAT , TIME_FORMAT および MONTH_DAY_FORMAT も参照してください。