En Django-inställningsfil innehåller all konfiguration av din Django-installation. I detta dokument förklaras hur inställningar fungerar och vilka inställningar som finns tillgängliga.
\nEn inställningsfil är bara en Python-modul med variabler på modulnivå.
\nHär är några exempel på inställningar:
\nALLOWED_HOSTS = ["www.example.com"]\nDEBUG = False\nDEFAULT_FROM_EMAIL = "webmaster@example.com"\nEftersom en inställningsfil är en Python-modul gäller följande:
\nDet tillåter inte syntaxfel i Python.
Den kan tilldela inställningar dynamiskt med hjälp av normal Python-syntax. Till exempel:
\nMY_SETTING = [str(i) for i in range(30)]\nDen kan importera värden från andra inställningsfiler.
När du använder Django måste du tala om vilka inställningar du använder. Detta gör du genom att använda miljövariabeln 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-adminLink to this heading#När du använder django-admin kan du antingen ställa in miljövariabeln en gång, eller uttryckligen skicka in inställningsmodulen varje gång du kör verktyget.
\nExempel (Unix Bash-skal):
\nexport DJANGO_SETTINGS_MODULE=mysite.settings\ndjango-admin runserver\nExempel (Windows-skal):
\nset DJANGO_SETTINGS_MODULE=mysite.settings\ndjango-admin runserver\nAnvänd kommandoradsargumentet --settings för att ange inställningarna manuellt:
django-admin runserver --settings=mysite.settings\nmod_wsgi)Link to this heading#I din live-servermiljö måste du tala om för din WSGI-applikation vilken inställningsfil som ska användas. Gör det med os.environ:
import os\n\nos.environ["DJANGO_SETTINGS_MODULE"] = "mysite.settings"\nLäs Django mod_wsgi documentation för mer information och andra vanliga element i en Django WSGI-applikation.
\nEn Django-inställningsfil behöver inte definiera några inställningar om den inte behöver det. Varje inställning har ett förnuftigt standardvärde. Dessa standardvärden finns i modulen django/conf/global_settings.py.
\nHär är den algoritm som Django använder för att sammanställa inställningar:
\nLadda inställningar från global_settings.py.
Ladda inställningar från den angivna inställningsfilen och åsidosätt de globala inställningarna vid behov.
Observera att en inställningsfil inte bör importera från global_settings, eftersom det är överflödigt.
Kommandot python manage.py diffsettings visar skillnader mellan den aktuella inställningsfilen och Djangos standardinställningar.
Mer information finns i diffsettings-dokumentationen.
I dina Django-appar kan du använda inställningar genom att importera objektet django.conf.settings. Exempel:
from django.conf import settings\n\nif settings.DEBUG:\n # Do something\n ...\nObservera att django.conf.settings inte är en modul - det är ett objekt. Så det är inte möjligt att importera enskilda inställningar:
from django.conf.settings import DEBUG # This won't work.\nObservera också att din kod inte ska importera från varken global_settings eller din egen inställningsfil. django.conf.settings abstraherar begreppen standardinställningar och platsspecifika inställningar; det presenterar ett enda gränssnitt. Det frikopplar också koden som använder inställningar från platsen för dina inställningar.
Du bör inte ändra inställningarna i dina program under körning. Gör till exempel inte så här i en vy:
\nfrom django.conf import settings\n\nsettings.DEBUG = True # Don't do this!\nDen enda plats där du bör tilldela inställningar är i en inställningsfil.
\nEftersom en inställningsfil innehåller känslig information, t.ex. databasens lösenord, bör du göra allt du kan för att begränsa åtkomsten till den. Ändra t.ex. filbehörigheterna så att endast du och webbserverns användare kan läsa den. Detta är särskilt viktigt i en miljö med delat värdskap.
\nFör en fullständig lista över tillgängliga inställningar, se inställningsreferens.
\nDet finns inget som hindrar dig från att skapa dina egna inställningar för dina egna Django-appar, men följ dessa riktlinjer:
\nAlla namn på inställningarna måste vara versaler.
Uppfinn inte en redan existerande miljö på nytt.
För inställningar som är sekvenser använder Django själv listor, men detta är bara en konvention.
\nDJANGO_SETTINGS_MODULELink to this heading#I vissa fall kanske du vill kringgå miljövariabeln DJANGO_SETTINGS_MODULE. Om du till exempel använder mallsystemet i sig självt, vill du förmodligen inte behöva ställa in en miljövariabel som pekar på en inställningsmodul.
I dessa fall kan du konfigurera Djangos inställningar manuellt. Detta gör du genom att anropa:
\nExempel:
\nfrom django.conf import settings\n\nsettings.configure(DEBUG=True)\nSkicka configure() så många nyckelordsargument som du vill, där varje nyckelordsargument representerar en inställning och dess värde. Varje argumentnamn ska vara versalt och ha samma namn som de inställningar som beskrivs ovan. Om en viss inställning inte skickas till configure() och behövs vid ett senare tillfälle, kommer Django att använda standardinställningsvärdet.
Att konfigurera Django på det här sättet är oftast nödvändigt - och rekommenderas faktiskt - när du använder en del av ramverket i en större applikation.
\nFöljaktligen kommer Django inte att göra några ändringar i processmiljövariablerna när de konfigureras via settings.configure() (se dokumentationen av TIME_ZONE för varför detta normalt skulle inträffa). Det förutsätts att du redan har full kontroll över din miljö i dessa fall.
Om du vill att standardvärdena ska komma från någon annanstans än django.conf.global_settings, kan du skicka in en modul eller klass som tillhandahåller standardinställningarna som default_settings-argument (eller som det första positionsargumentet) i anropet till configure().
I det här exemplet hämtas standardinställningarna från myapp_defaults, och inställningen DEBUG` sätts till True, oavsett dess värde i myapp_defaults:
from django.conf import settings\nfrom myapp import myapp_defaults\n\nsettings.configure(default_settings=myapp_defaults, DEBUG=True)\nFöljande exempel, som använder myapp_defaults som ett positionellt argument, är likvärdigt:
settings.configure(myapp_defaults, DEBUG=True)\nNormalt sett behöver du inte åsidosätta standardinställningarna på detta sätt. Djangos standardvärden är tillräckligt tama för att du säkert kan använda dem. Tänk på att om du skickar in en ny standardmodul, ersätter den helt och hållet Djangos standardinställningar, så du måste ange ett värde för varje möjlig inställning som kan användas i den kod du importerar. Kolla in django.conf.settings.global_settings för den fullständiga listan.
configure() eller DJANGO_SETTINGS_MODULELink to this heading#Om du inte ställer in miljövariabeln DJANGO_SETTINGS_MODULE måste du anropa configure() någon gång innan du använder någon kod som läser inställningar.
Om du inte ställer in DJANGO_SETTINGS_MODULE och inte anropar configure(), kommer Django att göra ett ImportError undantag första gången en inställning nås.
Om du ställer in DJANGO_SETTINGS_MODULE, kommer åt inställningsvärden på något sätt, därefter anropar configure(), kommer Django att ge ett RuntimeError som indikerar att inställningarna redan har konfigurerats. Det finns en egenskap för detta ändamål:
Till exempel:
\nfrom django.conf import settings\n\nif not settings.configured:\n settings.configure(myapp_defaults, DEBUG=True)\nDet är också ett fel att anropa configure() mer än en gång, eller att anropa configure() efter att någon inställning har använts.
Det kokar ner till detta: Använd exakt en av antingen configure() eller DJANGO_SETTINGS_MODULE. Inte både och, och inte varken eller.
django.setup() krävs för ”fristående” Django-användningLink to this heading#Om du använder komponenter i Django ”fristående” - till exempel skriver ett Python-skript som laddar några Django-mallar och renderar dem, eller använder ORM för att hämta data - finns det ytterligare ett steg du behöver utöver att konfigurera inställningar.
\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\nObservera att anrop av django.setup() endast är nödvändigt om din kod verkligen är fristående. När den anropas av din webbserver, eller genom django-admin, kommer Django att hantera detta åt dig.