Djangoの設定ファイルには、インストールしたDjangoの全ての設定が含まれています。このドキュメントでは、各設定の役割と、どのような設定を利用できるか説明していきます。
\n設定ファイルはモジュールレベルの変数が記述された、ただのPythonモジュールです。
\n設定例を幾つか示します:
\nALLOWED_HOSTS = ["www.example.com"]\nDEBUG = False\nDEFAULT_FROM_EMAIL = "webmaster@example.com"\n設定ファイルはPythonのモジュールなので、以下のような性質を備えています。
\nPythonの構文エラーになってはいけません。
通常の Pythonの構文を使って、動的に値を設定する事ができます。例えば:
\nMY_SETTING = [str(i) for i in range(30)]\n他の設定ファイルから値を import できます。
Django を使うとき、どの設定を使うかを Django に伝える必要があります。そのためには環境変数 DJANGO_SETTINGS_MODULE を使います。
The value of DJANGO_SETTINGS_MODULE should be in Python path syntax,\ne.g. mysite.settings. Note that the settings module should be on the\nPython sys.path.
django-admin ユーティリティLink to this heading#django-admin を使う場合、環境変数を予め指定しておくか、ユーティリティを起動する度に設定モジュールを明示的に渡します。
\n例 (Unix Bash シェル):
\nexport DJANGO_SETTINGS_MODULE=mysite.settings\ndjango-admin runserver\n例 (Windows シェル):
\nset DJANGO_SETTINGS_MODULE=mysite.settings\ndjango-admin runserver\nコマンドライン引数で設定モジュールを指定するには、次のように --settings を使用します。
django-admin runserver --settings=mysite.settings\nmod_wsgi) の設定Link to this heading#実際のサーバ環境では、 WSGI アプリケーションにどの設定ファイルを使うのか教えてあげる必要があります。これには os.environ:: を使います。
import os\n\nos.environ["DJANGO_SETTINGS_MODULE"] = "mysite.settings"\nさらなる情報や他のDjango WSGI アプリケーションでの共通の設定は Django mod_wsgi ドキュメント を参照してください。
\nDjango の設定ファイルでは、特に必要のない限り設定を行う必要はありません。各々の設定には注意深く決められたデフォルト値が入っています。デフォルト値は django/conf/global_settings.py に記述されています。
\nDjango が設定をコンパイルする際には、以下のようなアルゴリズムを使います:
\nglobal_settings.py から設定を読みだす。
指定された設定ファイルから設定を読み込み、グローバルな設定を必要に応じて上書きします。
設定ファイルから global_settings を読み込むのは冗長なのでやらないでください。
python manage.py diffsettings コマンドは、現在の設定と Django のデフォルトの設定との違いを表示します。
詳しくは diffsettings のドキュメントを参照してください。
自作のDjangoアプリケーションからは django.conf.settings をimportすることで設定を参照できます。例:
from django.conf import settings\n\nif settings.DEBUG:\n # Do something\n ...\ndjango.conf.settings はモジュールではなく、ただのオブジェクトです。そのため個々の設定は別々にimportできません。
from django.conf.settings import DEBUG # This won't work.\nまた global_settings や自作の設定ファイルをimportしてはいけません。 django.conf.settings はデフォルト設定とサイト固有の設定を抽象化し、単一のインタフェースを提供しています。また設定を使うコードと設定ファイルの場所を分離しています。
アプリケーションの実行中に設定を変えてはいけません。例えば、viewの中で以下の実装を行ってはいけません。
\nfrom django.conf import settings\n\nsettings.DEBUG = True # Don't do this!\n設定を変えて良いのは、設定ファイルの中だけです。
\n設定ファイルにはデータベースのパスワードのような重要な情報が入っているため、設定ファイルへのアクセスはできるだけ制限してください。たとえば、設定ファイルのパーミッションを、あなたとウェブサーバだけが読み取れるようにしてください。共有ホスティング環境で運用する場合、これは極めて重要な事項です。
\n利用可能な設定は settings リファレンス を参照してください。
\nDjango アプリケーションの設定項目は自由に作成できますが、以下のガイドラインに従ってください。
\n設定項目の変数名は、全て大文字にしなければなりません。
既存の設定の再発明はやめましょう。
設定値をシーケンスにする際は、リストを使ってください。ただしこれはDjangoの慣習です。
\nDJANGO_SETTINGS_MODULE 設定を使わない設定方法Link to this heading#DJANGO_SETTINGS_MODULE 環境変数をパイパスしたい場合もあるかもしれません。たとえば、テンプレートシステムを単体で使いたい場合、設定モジュールを示すような環境変数は設定したくないでしょう。
こういったケースのため、Djangoでは以下の関数を呼ぶことで手動で設定できるようになっています。
\n実装例:
\nfrom django.conf import settings\n\nsettings.configure(DEBUG=True)\nconfigure() には、キーワード引数を好きなだけ渡すことができ、各キーワード引数は設定とその値を表します。各引数名はすべて大文字で、上述の設定と同じ名前であるべきです。特定の設定が configure() に渡されず、後で必要になった場合、Djangoはデフォルトの設定値を使用します。
この方法でDjangoを設定することは、主にフレームワークの一部をより大きなアプリケーション内で使用している場合に必要であり、実際に推奨されています。
\nしたがって、settings.configure() を介して設定された場合、Djangoはプロセス環境変数を変更しません (これが通常発生する理由については、TIME_ZONE のドキュメントを参照してください)。これらの場合、すでに環境を完全に制御していることが前提となります。
デフォルト値を django.conf.global_settings 以外の場所から取得したい場合は、デフォルト設定を提供するモジュールやクラスを configure() 呼び出し時の default_settings 引数（または最初の位置引数）として渡すことができます。
この例では、デフォルトの設定は myapp_defaults から取得され、 DEBUG 設定は myapp_defaults での値に関係なく True に設定されます:
from django.conf import settings\nfrom myapp import myapp_defaults\n\nsettings.configure(default_settings=myapp_defaults, DEBUG=True)\n次の例では、 myapp_defaults を位置引数として使っていますが、等価です:
settings.configure(myapp_defaults, DEBUG=True)\n通常、このような方法でデフォルトを上書きする必要はありません。Django のデフォ ルトは十分に無難なので、安全に使うことができます。新しいデフォルトモジュールを渡す場合、Djangoのデフォルトを完全に 置き換える ため、インポートしているコードで使用される可能性のあるすべての設定に対して値を指定する必要があることに注意してください。全リストは django.conf.settings.global_settings を参照してください。
configure() と DJANGO_SETTINGS_MODULE は片方だけが必要Link to this heading#環境変数 DJANGO_SETTINGS_MODULE を設定していない場合、設定を読み込むコードを使用する前に configure() を呼び出す 必要があります 。
DJANGO_SETTINGS_MODULE を設定せず、 configure() を呼び出さない場合、 Django は設定に初めてアクセスしたときに ImportError 例外を発生させます。
DJANGO_SETTINGS_MODULE を設定し、何らかの方法で設定値にアクセスし、 その後に configure() を呼び出すと、Django は設定が既に設定されていることを示す RuntimeError を送出します。このためのプロパティがあります:
例:
\nfrom django.conf import settings\n\nif not settings.configured:\n settings.configure(myapp_defaults, DEBUG=True)\nまた、 configure() を2回以上呼び出したり、設定にアクセスした後に configure() を呼び出したりするとエラーになります。
結論はこうです： configure() と DJANGO_SETTINGS_MODULE のどちらか片方だけを使ってください。両方使うのも、両方使わないのもいけません。
django.setup() を呼び出す必要があるLink to this heading#Django のコンポーネントを "スタンドアロン" で使う場合、たとえば、 Django テンプレートを読み込んでレンダリングする Python スクリプトを書いたり、 ORM を使ってデータを取得したりする場合、設定の他にもう一つ必要なステップがあります。
\nAfter you've either set DJANGO_SETTINGS_MODULE or called\nconfigure(), you'll need to call django.setup() to load your\nsettings and populate Django's application registry. For example:
import django\nfrom django.conf import settings\nfrom myapp import myapp_defaults\n\nsettings.configure(default_settings=myapp_defaults, DEBUG=True)\ndjango.setup()\n\n# Now this script or any imported module can use any part of Django it needs.\nfrom myapp import models\ndjango.setup() を呼び出す必要があるのは、あなたのコードが本当にスタンドアロンである場合だけだということに注意してください。ウェブサーバから起動された場合、あるいは django-admin から起動された場合は、Django がこの処理を行います。