Um arquivo de definições do Django contém todas as configurações da sua instalação do Django. Este documento explica como as configurações trabalham e quais definições estão disponíveis.
\nUm arquivo de definições é somente um módulo Python com variáveis de módulo.
\nAqui alguns exemplos de definições:
\nALLOWED_HOSTS = ['www.example.com']\nDEBUG = False\nDEFAULT_FROM_EMAIL = 'webmaster@example.com'\nComo o arquivo de definições é um módulo Python, o seguinte se aplica:
\nEle não permite erros de sintaxe Python.
É possível assinalar definições dinamicamente usando sintaxe Python normalmente. Por exemplo:
\nMY_SETTING = [str(i) for i in range(30)]\nPode importar valores de outros arquivos de definições.
When you use Django, you have to tell it which settings you’re using. Do this\nby using an environment variable, 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 import search path.
django-adminLink para este cabeçalho#Quando usar django-admin, você pode definir a variável de ambiente uam vez, ou passar explicitamente no módulo de definições cada vez que você rodar a ferramenta.
\nExmplo (Bash shell do Unix):
\nexport DJANGO_SETTINGS_MODULE=mysite.settings\ndjango-admin runserver\nExemplo (shell do Windows):
\nset DJANGO_SETTINGS_MODULE=mysite.settings\ndjango-admin runserver\nUse o argumento``–settings`` na linha de comando para especificar manualmente o módulo de definições:
\ndjango-admin runserver --settings=mysite.settings\nmod_wsgi)Link para este cabeçalho#No seu ambiente do servidor de produção , você precisará dizer à sua aplicação WSGI qual arquivo de definições utilizar. Faça isso com os.environ:
import os\n\nos.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'\nLeia a documentação do Django mod_wsgi para mais informações e outros elementos comuns para uma aplicação WSGI Django.
\nUm arquivo de definições do Django não tem que definir qualquer configuração se não for necessária. Cada definição tem um valor padrão. Estes valores padrão estão no módulo django/conf/global_settings.py.
Aqui está o algoritmo que o Django usa enquanto compila as definições:
\nCarrega as definições do global_settings.py.
Carrega as definições do arquivo de definições especificado, sobrescrevendo as definições globais quando necessário.
Note que o arquivo de definições não deve importar o global_settings, porque isso é redundante.
The command python manage.py diffsettings displays differences between the\ncurrent settings file and Django’s default settings.
Para mais detalhes, veja a documentação diffsettings.
Nas suas apps Django, use as definições através da importação do objeto django.conf.settings. Exemplo:
from django.conf import settings\n\nif settings.DEBUG:\n # Do something\nNote que o django.conf.settings não é um módulo – é um objeto. Então não é possível importar definições individuais.
from django.conf.settings import DEBUG # This won't work.\nTambém note que seu código não deve importar nem o global_settings nem seu próprio arquivo de definições. O django.conf.settings torna o conceito das definições padrão abstrato bem como as definições específicas do site; ele apresenta uma única interface. Ele também desacopla o código que usa as definições da localização das suas definições.
Você não deve alterar as definições dentro de sua aplicação durante a execução. Por exemplo, não faça isso em uma “view”:
\nfrom django.conf import settings\n\nsettings.DEBUG = True # Don't do this!\nO único local onde você deve assinalar a definições é em um arquivo de definições.
\nBecause a settings file contains sensitive information, such as the database\npassword, you should make every attempt to limit access to it. For example,\nchange its file permissions so that only you and your web server’s user can\nread it. This is especially important in a shared-hosting environment.
\nPara uma lista completa de configurações disponíveis, veja a referência de configurações.
\nThere’s nothing stopping you from creating your own settings, for your own\nDjango apps, but follow these guidelines:
\nNomes de definições devem estar em maiúsculo.
Não reinvente uma configuração já existente.
Para definições que são sequências, mesmo o Django usa listas, mas isso é apenas uma convenção.
\nDJANGO_SETTINGS_MODULELink para este cabeçalho#In some cases, you might want to bypass the DJANGO_SETTINGS_MODULE\nenvironment variable. For example, if you’re using the template system by\nitself, you likely don’t want to have to set up an environment variable\npointing to a settings module.
Nestes casos, você pode configurar manualmente as definições. Faça isso através da chamada:
\nExemplo
\nfrom django.conf import settings\n\nsettings.configure(DEBUG=True)\nPasse ao configure() quantos argumentos nomeados você quiser, com cada argumento representando uma configuração e seu valor. Cada nome de argumento deve ser todo em maiúsculo, com o mesmo nome da configuração descrita acima. Se uma definição em particular não for passada para o configure() e e for necessária em algum ponto a diante, o Django irá usar o valor padrão para aquela configuração.
Configurando o Django desta maneira é sobretudo necessário – e, realmente, recomendado quando você está usando uma parte do framework dentro de uma aplicação maior.
\nConsequentemente, quando configurado através do settings.configure(), o Django não irá fazer qualquer modificação nas variáveis de ambiente do processo (veja a documentação do TIME_ZONE para o porque disso não ocorrer normalmente). Ele assume que você já está com todo o controle do seu ambiente nestes casos.
Se você quer que os valores padrão venham de algum outro lugar que não o django.conf.global_settings, você pode passar em um módulo ou classe que forneça as definições padrão como o argumento default_settings (ou como o primeiro argumento opcional) na chamada do configure().
Neste exemplo, definições padrão são pegas do myapp_defaults, e a definição de DEBUG é definida como True, apesar de seu valor em myapp_defaults:
from django.conf import settings\nfrom myapp import myapp_defaults\n\nsettings.configure(default_settings=myapp_defaults, DEBUG=True)\nO exemplo seguinte, o qual usa myapp_defaults como um argumento posicional, é equivalente:
settings.configure(myapp_defaults, DEBUG=True)\nNormalmente , você não precisa sobrescrever os padrões desta maneira. Os padrões do Django são suficientemente administráveis de modo que você pode usá-los tranquilamente. Esteja ciente que se você passar um novo módulo padrão, este irá substituir totalmente os padrões do Django, de modo que você precisa especificar um valor para cada definição existente que talvez seja usado no código que estiver importando. Verifique em django.conf.settings.global_settings a lista completa.
configure() or DJANGO_SETTINGS_MODULE is requiredLink para este cabeçalho#If you’re not setting the DJANGO_SETTINGS_MODULE environment\nvariable, you must call configure() at some point before using any code\nthat reads settings.
If you don’t set DJANGO_SETTINGS_MODULE and don’t call\nconfigure(), Django will raise an ImportError exception the first time\na setting is accessed.
If you set DJANGO_SETTINGS_MODULE, access settings values somehow,\nthen call configure(), Django will raise a RuntimeError indicating\nthat settings have already been configured. There is a property for this\npurpose:
Por exemplo:
\nfrom django.conf import settings\nif not settings.configured:\n settings.configure(myapp_defaults, DEBUG=True)\nE mais, é um erro chamar o configure() mais de uma vez, ou chamar o configure() depois que qualquer definição tenha sido acessada.
It boils down to this: Use exactly one of either configure() or\nDJANGO_SETTINGS_MODULE. Not both, and not neither.
django.setup() para o usar o Django de modo “standalone”Link para este cabeçalho#Se você está usando componentes do Django de modo “standalone” – por exemplo, escreveu um script Python o qual carrega alguns templates Django e os renderiza, ou usa o ORM para ler alguns dados – existe mais um passo que é necessário além de configurar as definições.
\nDepois de definir ou o DJANGO_SETTINGS_MODULE ou chamado configure(), precisará chamar django.setup() para carregar suas definições e popular o registro da aplicação Django. Por exemplo:
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\nNote that calling django.setup() is only necessary if your code is truly\nstandalone. When invoked by your web server, or through django-admin, Django will handle this for you.