Professional Documents
Culture Documents
Estedocument
documento
is for
é para
an insecure
uma versão
version
insegura
of Django
do Django
that isque
no longer
não é mais
supported.
suportada.
Please
Por
upgrade
favor, atualize
to a newer
pararelease!
uma
versão mais nova!
Django
Documentation
Settings
Core Settings
Auth
Messages
Sessions
Sites
Static Files
Warning
Be careful when you override settings, especially when the default value
is a non-empty list or dictionary, such as STATICFILES_FINDERS.
Make sure you keep
the components required by the features of Django you
wish to use.
Core Settings
Here’s a list of settings available in Django core and their default values.
Settings provided by contrib apps are listed below, followed by a topical index
of the core settings. For
introductory material, see the settings topic
guide.
ABSOLUTE_URL_OVERRIDES
Default: (Empty dictionary){}
ABSOLUTE_URL_OVERRIDES = {
Note that the model name used in this setting should be all lower-case, regardless
of the case of the actual model class name.
ADMINS
Default: (Empty list)[]
A list of all the people who get code error notifications. When
DEBUG=False and AdminEmailHandler
is configured in LOGGING (done by default), Django emails these
people the
details of exceptions raised in the request/response cycle.
Each item in the list should be a tuple of (Full name, email address). Example:
Obtendo ajuda
A list of strings representing the host/domain names that this Django site can
serve. This is a security measure to prevent HTTP Host header attacks, which are possible even under
many
seemingly-safe web server configurations.
Django also allows the fully qualified domain name (FQDN) of any entries.
Some browsers include a trailing dot in the header which Django
strips when performing host validation.Host
APPEND_SLASH
Default: True
When set to , if the request URL does not match any of the patterns
in the URLconf and it doesn’t end in a slash, an HTTP redirect is issued to the
same URL with a slash appended. Note
that the redirect may cause any data
submitted in a POST request to be lost.True
CACHES
Default:
'default': {
'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
BACKEND
'django.core.cache.backends.db.DatabaseCache'
'django.core.cache.backends.dummy.DummyCache'
'django.core.cache.backends.locmem.LocMemCache'
Língua: en
'django.core.cache.backends.memcached.MemcachedCache'
KEY_FUNCTION
A string containing a dotted path to a function (or any callable) that defines how to
compose a prefix, version and key into a final cache key. The default
implementation is equivalent to
the function:
You may use any key function you want, as long as it has the same
argument signature.
KEY_PREFIX
LOCATION
The location of the cache to use. This might be the directory for a
file system cache, a host and port for a memcache server, or simply an
identifying name for a local memory cache. e.g.:
CACHES = {
'default': {
'BACKEND': 'django.core.cache.backends.filebased.FileBasedCache',
'LOCATION': '/var/tmp/django_cache',
OPTIONS
Default: None
TIMEOUT
Default: 300
The number of seconds before a cache entry is considered stale. If the value of
this settings is , cache entries will not expire.None
VERSION
Default: 1
Obtendo ajuda
The default version number for cache keys generated by the Django server.
CACHE_MIDDLEWARE_KEY_PREFIX
Default: (Empty string)''
A string which will be prefixed to the cache keys generated by the cache
middleware. This prefix is combined with the
KEY_PREFIX setting; it does not replace it.
CACHE_MIDDLEWARE_SECONDS
Default: 600
The default number of seconds to cache a page for the cache middleware.
CSRF_COOKIE_AGE
Default: (approximately 1 year, in seconds)31449600
CSRF_COOKIE_DOMAIN
Default: None
The domain to be used when setting the CSRF cookie. This can be useful for
easily allowing cross-subdomain requests to be excluded from the normal cross
site request forgery
protection. It should be set to a string such as
to allow a POST request from a form on one subdomain to be
accepted by a view served from another subdomain."example.com"
Please note that the presence of this setting does not imply that Django’s CSRF
protection is safe from cross-subdomain attacks by default - please see the
CSRF limitations section.
CSRF_COOKIE_HTTPONLY
Default: False
Although the setting offers little practical benefit, it’s sometimes required
by security auditors.
If you enable this and need to send the value of the CSRF token with an AJAX
request, your JavaScript must pull the value from a hidden CSRF token form
input on the page instead of
from the cookie.
CSRF_COOKIE_NAME
Default: 'csrftoken'
Obtendo
The name of the cookie to use for the CSRF authentication token. This can be
whatever you want (as long as it’s different from the other cookie names in
your application). See ajuda
Cross Site
Request Forgery protection.
Língua: en
This is useful if you have multiple Django instances running under the same
hostname. They can use different cookie paths, and each instance will only see
its own CSRF cookie.
CSRF_COOKIE_SECURE
Default: False
Whether to use a secure cookie for the CSRF cookie. If this is set to ,
the cookie will be marked as “secure,” which means browsers may ensure that the
cookie is only sent with an HTTPS
connection.True
CSRF_USE_SESSIONS
Default: False
Whether to store the CSRF token in the user’s session instead of in a cookie.
It requires the use of django.contrib.sessions.
Storing the CSRF token in a cookie (Django’s default) is safe, but storing it
in the session is common practice in other web frameworks and therefore
sometimes demanded by security
auditors.
CSRF_FAILURE_VIEW
Default: 'django.views.csrf.csrf_failure'
...
django.views.csrf.csrf_failure() accepts an additional parameter that defaults to . If a template with that name
exists, it will be used to render the
page.template_name'403_csrf.html'
CSRF_HEADER_NAME
Default: 'HTTP_X_CSRFTOKEN'
CSRF_TRUSTED_ORIGINS
Default: (Empty list)[]
A list of hosts which are trusted origins for unsafe requests (e.g. ).
For a secure unsafe
request, Django’s CSRF protection requires that the request have a header that matches the origin
present in the header. This prevents,
for example, a request from from succeeding
against . If you need cross-origin unsafe requests over
HTTPS, continuing the example, add to this list.
The setting also supports subdomains, so you could add , for
example, to allow access from all subdomains of
.POSTRefererHostPOSTsubdomain.example.comapi.example.com"subdomain.example.com"".example.com"example.com
Obtendo ajuda
DATABASES
Padrão: (Dicionário vazio){}
Língua: en
Um dicionário contendo as configurações para todos os bancos de dados a serem usados com Django. É um dicionário aninhado cujo conteúdo mapeia um código de banco de dados
para um dicionário contendo as opções para um banco de dados individual.
Versão da documentação: 2.0
A configuração de BANCOS DE DADOS deve configurar um banco de dados; qualquer número de bancos de dados adicionais também pode ser especificado.default
O arquivo de configurações mais simples possível é para uma configuração de banco de dados único usando o SQLite. Isso pode ser configurado usando o seguinte:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': 'mydatabase',
Ao se conectar a outros backends de banco de dados, como MySQL, Oracle ou PostgreSQL, serão necessários parâmetros adicionais de conexão. Veja a configuração do ENGINE
abaixo sobre como especificar outros tipos de banco de dados. Este exemplo é para PostgreSQL:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'NAME': 'mydatabase',
'USER': 'mydatabaseuser',
'PASSWORD': 'mypassword',
'HOST': '127.0.0.1',
'PORT': '5432',
As seguintes opções internas que podem ser necessárias para configurações mais complexas estão disponíveis:
ATOMIC_REQUESTS
Inadimplência: False
Defina isso para embrulhar cada exibição em uma transação neste banco de dados. Consulte as transações de tying para solicitações HTTP.True
AUTOCOMMIT
Inadimplência: True
Defina isso para se você quiser desativar o gerenciamento de transações da Django e implementar o seu próprio.False
ENGINE
'django.db.backends.postgresql'
'django.db.backends.mysql'
'django.db.backends.sqlite3'
'django.db.backends.oracle'
Você pode usar um backend de banco de dados que não é enviado com o Django, configurando um caminho totalmente qualificado (ou
seja).ENGINEmypackage.backends.whatever
HOST
Qual host usar ao se conectar ao banco de dados. Uma corda vazia significa localhost. Não usado com SQLite.
Obtendo ajuda
Se este valor começar com uma barra para a frente () e você estiver usando o MySQL, o MySQL se conectará através de um soquete Unix ao soquete especificado. Por exemplo:'/'
Língua: en
"HOST": '/var/run/mysql'
Se você estiver usando PostgreSQL, por padrão (HOSTvazio), a conexão com o banco de dados será feita através de tomadas de domínio UNIX (linhas 'locais' em ). Se o seu soquete de
domínio UNIX não estiver no local padrão, use o mesmo valor de . Se você quiser se conectar através de soquetes TCP, defina HOST como 'localhost' ou '127.0.0.1' ('host' linhas em ). No
Windows, você deve sempre definir HOST, já que os soquetes de domínio UNIX não estão disponíveis.pg_hba.confunix_socket_directorypostgresql.confpg_hba.conf
NAME
The name of the database to use. For SQLite, it’s the full path to the database
file. When specifying the path, always use forward slashes, even on Windows
(e.g.
).C:/homes/user/mysite/sqlite3.db
CONN_MAX_AGE
Default: 0
OPTIONS
PASSWORD
The password to use when connecting to the database. Not used with SQLite.
PORT
The port to use when connecting to the database. An empty string means the
default port. Not used with SQLite.
TIME_ZONE
Default: None
A string representing the time zone for datetimes stored in this database
(assuming that it doesn’t support time zones) or . This inner option of
the DATABASES setting accepts the same
values as the general
TIME_ZONE setting.None
DISABLE_SERVER_SIDE_CURSORS
Default: False
Língua: en
Set this to if you want to disable the use of server-side cursors with
QuerySet.iterator(). Transaction pooling and server-side cursors
describes the use case.True
The username to use when connecting to the database. Not used with SQLite.
TEST
A dictionary of settings for test databases; for more details about the
creation and use of test databases, see The test database.
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'USER': 'mydatabaseuser',
'NAME': 'mydatabase',
'TEST': {
'NAME': 'mytestdatabase',
},
},
CHARSET
Default: None
The character set encoding used to create the test database. The value of this
string is passed directly through to the database, so its format is
backend-specific.
COLLATION
Default: None
The collation order to use when creating the test database. This value is
passed directly to the backend, so its format is backend-specific.
Only supported for the backend (see the MySQL manual for details).mysql
DEPENDENCIES
MIRROR
Default: None
The alias of the database that this database should mirror during
testing.
NAME
Default: None
Obtendo ajuda
The name of database to use when running the test suite.
If the default value () is used with the SQLite database engine, the
tests will use a memory resident database. For all other database engines the
test database will use the name
Língua: en
.None'test_' + DATABASE_NAME
Boolean value to control whether or not the default test runner serializes the
database into an in-memory JSON string before running tests (used to restore
the database state between
tests if you don’t have transactions). You can set
this to to speed up creation time if you don’t have any test classes
with serialized_rollback=True.False
TEMPLATE
CREATE_DB
Default: True
CREATE_USER
Default: True
USER
Default: None
The username to use when connecting to the Oracle database that will be used
when running tests. If not provided, Django will use .'test_' + USER
PASSWORD
Default: None
The password to use when connecting to the Oracle database that will be used
when running tests. If not provided, Django will generate a random password.
TBLSPACE
Default: None
The name of the tablespace that will be used when running tests. If not
provided, Django will use .'test_' + USER
TBLSPACE_TMP
Default: None
The name of the temporary tablespace that will be used when running tests. If
not provided, Django will use .'test_' + USER + '_temp'
Língua: en
Default: None
This is an Oracle-specific setting.
The name of the datafile to use for the TBLSPACE. If not provided, Django will
use .TBLSPACE + '.dbf'
DATAFILE_TMP
Default: None
The name of the datafile to use for the TBLSPACE_TMP. If not provided, Django
will use .TBLSPACE_TMP + '.dbf'
DATAFILE_MAXSIZE
Default: '500M'
DATAFILE_TMP_MAXSIZE
Default: '500M'
DATAFILE_SIZE
Default: '50M'
DATAFILE_TMP_SIZE
Default: '50M'
DATAFILE_EXTSIZE
Default: '25M'
The amount by which the DATAFILE is extended when more space is required.
DATAFILE_TMP_EXTSIZE
Obtendo ajuda
New in Django 2.0.
Língua: en
Default: '25M'
Versão da documentação: 2.0
This is an Oracle-specific setting.
The amount by which the DATAFILE_TMP is extended when more space is required.
DATA_UPLOAD_MAX_MEMORY_SIZE
Default: (i.e. 2.5 MB).2621440
DATA_UPLOAD_MAX_NUMBER_FIELDS
Default: 1000
The maximum number of parameters that may be received via GET or POST before a
SuspiciousOperation () is
raised. You can set this to to disable the check. Applications that
are
expected to receive an unusually large number of form fields should tune
this setting.TooManyFieldsNone
DATABASE_ROUTERS
Default: (Empty list)[]
DATE_FORMAT
Default: (e.g. 'N j, Y'Feb. 4, 2003)
The default formatting to use for displaying date fields in any part of the
system. Note that if USE_L10N is set to , then the
locale-dictated format has higher precedence and will be
applied instead. See
allowed date format strings.True
DATE_INPUT_FORMATS
Default:
'%b %d %Y', '%b %d, %Y', # 'Oct 25 2006', 'Oct 25, 2006'
'%d %b %Y', '%d %b, %Y', # '25 Oct 2006', '25 Oct, 2006'
'%B %d %Y', '%B %d, %Y', # 'October 25 2006', 'October 25, 2006'
'%d %B %Y', '%d %B, %Y', # '25 October 2006', '25 October, 2006'
A list of formats that will be accepted when inputting data on a date field.
Formats will be tried in order, using the first valid one. Note that these
format strings use Python’s datetime
module syntax, not the format strings from the date
template filter.
Obtendo ajuda
Língua: en
See also DATETIME_INPUT_FORMATS and TIME_INPUT_FORMATS.
The default formatting to use for displaying datetime fields in any part of the
system. Note that if USE_L10N is set to , then the
locale-dictated format has higher precedence and will be
applied instead. See
allowed date format strings.True
DATETIME_INPUT_FORMATS
Default:
'%Y-%m-%d', # '2006-10-25'
'%m/%d/%Y', # '10/25/2006'
'%m/%d/%y', # '10/25/06'
DEBUG
Default: False
Did you catch that? NEVER deploy a site into production with DEBUG
turned on.
One of the main features of debug mode is the display of detailed error pages.
If your app raises an exception when DEBUG is , Django will
display a detailed traceback, including a lot of
metadata about your
environment, such as all the currently defined Django settings (from
).Truesettings.py
'API'
'KEY'
'PASS'
'SECRET'
'SIGNATURE'
'TOKEN'
Note that these are partial matches. will also match PASSWORD,
just as will also match TOKENIZED and so on.'PASS''TOKEN'
Still, note that there are always going to be sections of your debug output
that are inappropriate for public consumption. File paths, configuration
options and the like all give attackers
extra information about your server.
DEBUG_PROPAGATE_EXCEPTIONS
Default: False
This can be useful for some test setups. It shouldn’t be used on a live site
unless you want your web server (instead of Django) to generate “Internal
Server Error” responses. In that case,
make sure your server doesn’t show the
stack trace or other sensitive information in the response.
DECIMAL_SEPARATOR
Default: (Dot)'.'
DEFAULT_CHARSET
Default: 'utf-8'
DEFAULT_CONTENT_TYPE
Default: 'text/html'
DEFAULT_EXCEPTION_REPORTER_FILTER
Default: django.views.debug.SafeExceptionReporterFilter''
Default exception reporter filter class to be used if none has been assigned to
the HttpRequest instance yet.
See Filtering error reports.
DEFAULT_FILE_STORAGE
Default: django.core.files.storage.FileSystemStorage''
Default file storage class to be used for any file-related operations that don’t
specify a particular storage system. See Managing files.
DEFAULT_FROM_EMAIL
Default: 'webmaster@localhost'
Default email address to use for various automated correspondence from the
site manager(s). This doesn’t include error messages sent to ADMINS
and MANAGERS; for that, see
Obtendo ajuda
SERVER_EMAIL.
Língua: en
DEFAULT_TABLESPACE
Default: (Empty string)''
Default tablespace to use for models that don’t specify one, if the
backend supports it (see Tablespaces).
DISALLOWED_USER_AGENTS
Default: (Empty list)[]
EMAIL_BACKEND
Default: django.core.mail.backends.smtp.EmailBackend''
The backend to use for sending emails. For the list of available backends see
Sending email.
EMAIL_FILE_PATH
Default: Not defined
EMAIL_HOST
Default: 'localhost'
EMAIL_HOST_PASSWORD
Default: (Empty string)''
EMAIL_HOST_USER
Default: (Empty string)''
EMAIL_PORT
Default: 25
Port to use for the SMTP server defined in EMAIL_HOST. Obtendo ajuda
Língua: en
EMAIL_SUBJECT_PREFIX
Versão da documentação: 2.0
Default: '[Django] '
Subject-line prefix for email messages sent with or . You’ll probably want to include the
trailing space.django.core.mail.mail_adminsdjango.core.mail.mail_managers
EMAIL_USE_LOCALTIME
Default: False
Whether to send the SMTP header of email messages in the local time
zone () or in UTC ().DateTrueFalse
EMAIL_USE_TLS
Default: False
Whether to use a TLS (secure) connection when talking to the SMTP server.
This is used for explicit TLS connections, generally on port 587. If you are
experiencing hanging connections,
see the implicit TLS setting
EMAIL_USE_SSL.
EMAIL_USE_SSL
Default: False
Whether to use an implicit TLS (secure) connection when talking to the SMTP
server. In most email documentation this type of TLS connection is referred
to as SSL. It is generally used
on port 465. If you are experiencing problems,
see the explicit TLS setting EMAIL_USE_TLS.
EMAIL_SSL_CERTFILE
Default: None
EMAIL_SSL_KEYFILE
Default: None
EMAIL_TIMEOUT
Default: None
FILE_CHARSET
Default: 'utf-8'
The character encoding used to decode any files read from disk. This includes
template files and initial SQL data files.
Default:
Língua: en
'django.core.files.uploadhandler.MemoryFileUploadHandler',
'django.core.files.uploadhandler.TemporaryFileUploadHandler',
A list of handlers to use for uploading. Changing this setting allows complete
customization – even replacement – of Django’s upload process.
FILE_UPLOAD_MAX_MEMORY_SIZE
Default: (i.e. 2.5 MB).2621440
The maximum size (in bytes) that an upload will be before it gets streamed to
the file system. See Managing files for details.
FILE_UPLOAD_DIRECTORY_PERMISSIONS
Default: None
This setting also determines the default permissions for collected static
directories when using the collectstatic management command. See
collectstatic for details on
overriding it.
FILE_UPLOAD_PERMISSIONS
Default: None
The numeric mode (i.e. ) to set newly uploaded files to. For
more information about what these modes mean, see the documentation for
os.chmod().0o644
For security reasons, these permissions aren’t applied to the temporary files
that are stored in FILE_UPLOAD_TEMP_DIR.
This setting also determines the default permissions for collected static files
when using the collectstatic management command. See
collectstatic for details on overriding it.
Warning
If you’re not familiar with file modes, please note that the leading
is very important: it indicates an octal number, which is the
way that modes must be specified. If
you try to use , you’ll
get totally incorrect behavior.0644
FILE_UPLOAD_TEMP_DIR
Default: None
Obtendo ajuda
FIRST_DAY_OF_WEEK
Default: (Sunday)0 Língua: en
A number representing the first day of the week. This is especially useful
when displaying a calendar. This value is only used when not using
format internationalization, or when a format
cannot be found for the
current locale. Versão da documentação: 2.0
Note that these paths should use Unix-style forward slashes, even on Windows.
FORCE_SCRIPT_NAME
Default: None
If not , this will be used as the value of the environment variable in any HTTP request. This setting can be used to override
the server-provided value of , which may be a rewritten version
of the preferred value or not supplied at all. It is also used by
django.setup() to set the URL resolver script prefix outside of the
request/response cycle (e.g. in management
commands and standalone scripts) to
generate correct URLs when is not .NoneSCRIPT_NAMESCRIPT_NAMESCRIPT_NAME/
FORM_RENDERER
Default: django.forms.renderers.DjangoTemplates''
The class that renders form widgets. It must implement the low-level
render API.
FORMAT_MODULE_PATH
Default: None
A full Python path to a Python package that contains custom format definitions
for project locales. If not , Django will check for a file, under the directory named as the current locale, and
will use the
formats defined in this file.Noneformats.py
mysite/
formats/
__init__.py
en/
__init__.py
formats.py
You can also set this setting to a list of Python paths, for example:
FORMAT_MODULE_PATH = [
'mysite.formats',
'some_app.formats',
When Django searches for a certain format, it will go through all given Python
paths until it finds a module that actually defines the given format. This
means that formats defined in
packages farther up in the list will take
precedence over the same formats in packages farther down.
DATE_FORMAT
Obtendo ajuda
DATE_INPUT_FORMATS
Língua: en
DATETIME_FORMAT,
DECIMAL_SEPARATOR
FIRST_DAY_OF_WEEK
MONTH_DAY_FORMAT
NUMBER_GROUPING
SHORT_DATE_FORMAT
SHORT_DATETIME_FORMAT
THOUSAND_SEPARATOR
TIME_FORMAT
TIME_INPUT_FORMATS
YEAR_MONTH_FORMAT
IGNORABLE_404_URLS
Default: (Empty list)[]
INSTALLED_APPS
Default: (Empty list)[]
INTERNAL_IPS
Default: (Empty list)[]
Obtendo ajuda
Allow the debug() context processor
to add some variables to the template context.
A string representing the language code for this installation. This should be in
standard language ID format. For example, U.S. English
is . See also the list of language identifiers and
Internationalization and localization."en-us"
LANGUAGE_COOKIE_AGE
Default: (expires at browser close)None
LANGUAGE_COOKIE_DOMAIN
Default: None
The domain to use for the language cookie. Set this to a string such as
for cross-domain cookies, or use for a standard
domain cookie."example.com"None
LANGUAGE_COOKIE_NAME
Default: 'django_language'
The name of the cookie to use for the language cookie. This can be whatever
you want (as long as it’s different from the other cookie names in your
application). See Internationalization
and localization.
LANGUAGE_COOKIE_PATH
Default: '/'
The path set on the language cookie. This should either match the URL path of your
Django installation or be a parent of that path.
This is useful if you have multiple Django instances running under the same
hostname. They can use different cookie paths and each instance will only see
its own language cookie.
Be cautious when updating this setting on a production site. If you update this
setting to use a deeper path than it previously used, existing user cookies that
have the old path will not be
updated. This will result in site users being
unable to switch the language as long as these cookies persist. The only safe
and reliable option to perform the switch is to change the
language cookie name
permanently (via the LANGUAGE_COOKIE_NAME setting), and to add
a middleware that copies the value from the old cookie to a new one and then
deletes the one.
LANGUAGES
Default: A list of all available languages. This list is continually growing
and including a copy here would inevitably become rapidly out of date. You can
see the current list of translated
languages by looking in
(or view the online source).django/conf/global_settings.py
Generally, the default value should suffice. Only set this setting if you want
to restrict language selection to a subset of the Django-provided languages.
Língua: en
LANGUAGES = [
('de', _('German')),
('en', _('English')),
LOCALE_PATHS
Default: (Empty list)[]
Example:
LOCALE_PATHS = [
'/home/www/project/common_files/locale',
'/var/local/translations/locale',
Django will look within each of these paths for the directories containing the actual translation files.<locale_code>/LC_MESSAGES
LOGGING
Default: A logging configuration dictionary.
Among other things, the default logging configuration passes HTTP 500 server
errors to an email log handler when DEBUG is . See also
Configuring logging.False
LOGGING_CONFIG
Default: 'logging.config.dictConfig'
MANAGERS
Default: (Empty list)[]
A list in the same format as ADMINS that specifies who should get
broken link notifications when
BrokenLinkEmailsMiddleware is enabled.
MEDIA_ROOT
Default: (Empty string)''
Example: "/var/www/example.com/media/"
Obtendo ajuda
Warning Língua: en
Example: "http://media.example.com/"
Warning
There are security risks if you are accepting uploaded content from
untrusted users! See the security guide’s topic on
User-uploaded content for mitigation details.
Warning
MIDDLEWARE
Default: None
MIGRATION_MODULES
Default: (Empty dictionary){}
Example:
{'blog': 'blog.db_migrations'}
When you supply as a value for an app, Django will consider the app as
an app without migrations regardless of an existing submodule.
This can be used, for example, in a test settings
file to skip migrations while
testing (tables will still be created for the apps’ models). If this is used in
your general project settings, remember to use the migrate
--run-syncdb option
if you want to create tables for the app.Nonemigrations
MONTH_DAY_FORMAT
Default: 'F j'
The default formatting to use for date fields on Django admin change-list
pages – and, possibly, by other parts of the system – in cases when only the
month and day are displayed.
For example, when a Django admin change-list page is being filtered by a date
drilldown, the header for a given day displays the day and month. Different
locales have different formats.
For example, U.S. English would say
“January 1,” whereas Spanish might say “1 Enero.”
Língua: en
NUMBER_GROUPING = (3, 2, 0)
PREPEND_WWW
Default: False
Whether to prepend the “www.” subdomain to URLs that don’t have it. This is only
used if CommonMiddleware is installed
(see Middleware). See also APPEND_SLASH.
ROOT_URLCONF
Default: Not defined
A string representing the full Python import path to your root URLconf. For example:
. Can be overridden on a per-request basis by
setting the attribute on the incoming object. See How
Django processes a request for details."mydjangoapps.urls"urlconfHttpRequest
SECRET_KEY
Default: (Empty string)''
Uses of the key shouldn’t assume that it’s text or bytes. Every use should go
through force_text() or
force_bytes() to convert it to the desired type.
Warning
If you rotate your secret key, all of the above will be invalidated.
Secret keys are not used for passwords of users and key rotation will not
affect them.
Versão da documentação: 2.0
Note
SECURE_BROWSER_XSS_FILTER
Default: False
SECURE_CONTENT_TYPE_NOSNIFF
Default: False
If , the SecurityMiddleware
sets the X-Content-Type-Options: nosniff header on all responses that do not
already have it.True
SECURE_HSTS_INCLUDE_SUBDOMAINS
Default: False
Warning
SECURE_HSTS_PRELOAD
Default: False
SECURE_HSTS_SECONDS
Default: 0
Warning
Setting this incorrectly can irreversibly (for some time) break your site.
Read the HTTP Strict Transport Security documentation first.
SECURE_PROXY_SSL_HEADER
Obtendo ajuda
Default: None
You’ll need to set a tuple with two elements – the name of the header to look
for and the required value. For example:
Warning
You will probably open security holes in your site if you set this
without knowing what you’re doing. And if you fail to set it when you
should. Seriously.
Make sure ALL of the following are true before setting this (assuming the
values from the example above):
If any of those are not true, you should keep this setting set to and find another way of determining HTTPS, perhaps via custom middleware.None
SECURE_REDIRECT_EXEMPT
Default: (Empty list)[]
If a URL path matches a regular expression in this list, the request will not be
redirected to HTTPS. If SECURE_SSL_REDIRECT is , this
setting has no effect.False
SECURE_SSL_HOST
Default: None
SECURE_SSL_REDIRECT
Default: False
If , the SecurityMiddleware
redirects all non-HTTPS requests to HTTPS (except for
those URLs matching a regular expression listed in
SECURE_REDIRECT_EXEMPT).True
Note
Obtendo ajuda
SERIALIZATION_MODULES
Default: Not defined
Língua: en
SERVER_EMAIL
Default: 'root@localhost'
The email address that error messages come from, such as those sent to
ADMINS and MANAGERS.
This address is used only for error messages. It is not the address that
regular email messages sent with send_mail()
come from; for that, see
DEFAULT_FROM_EMAIL.
SHORT_DATE_FORMAT
Default: (e.g. 'm/d/Y'12/31/2003)
SHORT_DATETIME_FORMAT
Default: (e.g. 'm/d/Y P'12/31/2003 4 p.m.)
SIGNING_BACKEND
Default: 'django.core.signing.TimestampSigner'
SILENCED_SYSTEM_CHECKS
Default: (Empty list)[]
TEMPLATES
Default: (Empty list)[]
A list containing the settings for all template engines to be used with
Django. Each item of the list is a dictionary containing the options for an
individual engine.
Obtendo ajuda
Here’s a simple setup that tells the Django template engine to load templates
from the subdirectory inside each installed application:templates
Língua: en
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'APP_DIRS': True,
},
BACKEND
'django.template.backends.django.DjangoTemplates'
'django.template.backends.jinja2.Jinja2'
You can use a template backend that doesn’t ship with Django by setting
to a fully-qualified path (i.e. ).BACKEND'mypackage.whatever.Backend'
NAME
The alias for this particular template engine. It’s an identifier that allows
selecting an engine for rendering. Aliases must be unique across all
configured template engines.
It defaults to the name of the module defining the engine class, i.e. the
next to last piece of BACKEND, when it isn’t
provided. For example if the backend is then
its default name is
.'mypackage.whatever.Backend''whatever'
DIRS
Directories where the engine should look for template source files, in search
order.
APP_DIRS
Default: False
Whether the engine should look for template source files inside installed
applications.
Note
OPTIONS
TEST_RUNNER
Obtendo ajuda
Default: 'django.test.runner.DiscoverRunner'
The name of the class to use for starting the test suite. See
Using different testing frameworks.
Língua: en
TEST_NON_SERIALIZED_APPS
Default: (Empty list)[]
This slows down the startup time of the test runner; if you have apps that
you know don’t need this feature, you can add their full names in here (e.g.
) to exclude them from this
serialization
process.'django.contrib.contenttypes'
THOUSAND_SEPARATOR
Default: (Comma)','
TIME_FORMAT
Default: (e.g. 'P'4 p.m.)
The default formatting to use for displaying time fields in any part of the
system. Note that if USE_L10N is set to , then the
locale-dictated format has higher precedence and will be
applied instead. See
allowed date format strings.True
TIME_INPUT_FORMATS
Default:
'%H:%M:%S', # '14:30:59'
'%H:%M:%S.%f', # '14:30:59.000200'
'%H:%M', # '14:30'
A list of formats that will be accepted when inputting data on a time field.
Formats will be tried in order, using the first valid one. Note that these
format strings use Python’s datetime
module syntax, not the format strings from the date
template filter.
TIME_ZONE
Default: 'America/Chicago'
A string representing the time zone for this installation. See the list of
time zones.
Note
Note that this isn’t necessarily the time zone of the server. For example, one
server may serve multiple Django-powered sites, each with a separate time zone
setting.
USE_ETAGS
Default: False
USE_I18N
Default: True
Note
USE_L10N
Default: False
Note
USE_THOUSAND_SEPARATOR
Default: False
Obtendo ajuda
USE_TZ
Default: False Língua: en
USE_X_FORWARDED_HOST
Default: False
USE_X_FORWARDED_PORT
Default: False
WSGI_APPLICATION
Default: None
The full Python path of the WSGI application object that Django’s built-in
servers (e.g. runserver) will use. The django-admin
startproject management command will create a
simple
file with an callable in it, and point this setting
to that .wsgi.pyapplicationapplication
If not set, the return value of will be used. In this case, the behavior of runserver will be
identical to previous Django versions.django.core.wsgi.get_wsgi_application()
YEAR_MONTH_FORMAT
Default: 'F Y'
The default formatting to use for date fields on Django admin change-list
pages – and, possibly, by other parts of the system – in cases when only the
year and month are displayed.
For example, when a Django admin change-list page is being filtered by a date
drilldown, the header for a given month displays the month and the year.
Different locales have different
formats. For example, U.S. English would say
“January 2006,” whereas another locale might say “2006/January.”
X_FRAME_OPTIONS
Default: 'SAMEORIGIN'
Auth
Settings for django.contrib.auth.
Default: ['django.contrib.auth.backends.ModelBackend']
Língua: en
A list of authentication backend classes (as strings) to use when attempting to
authenticate a user. See the authentication backends documentation for details.
The model to use to represent a User. See Substituting a custom User model.
Warning
LOGIN_REDIRECT_URL
Default: '/accounts/profile/'
The URL where requests are redirected after login when the
view gets no parameter.contrib.auth.loginnext
LOGIN_URL
Default: '/accounts/login/'
The URL where requests are redirected for login, especially when using the
login_required() decorator.
LOGOUT_REDIRECT_URL
Default: None
The URL where requests are redirected after a user logs out using
LogoutView (if the view doesn’t get a
argument).next_page
PASSWORD_RESET_TIMEOUT_DAYS
Default: 3
The number of days a password reset link is valid for. Used by the
django.contrib.auth password reset mechanism.
PASSWORD_HASHERS
See How Django stores passwords.
Default:
'django.contrib.auth.hashers.PBKDF2PasswordHasher',
'django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher',
'django.contrib.auth.hashers.Argon2PasswordHasher',
'django.contrib.auth.hashers.BCryptSHA256PasswordHasher',
'django.contrib.auth.hashers.BCryptPasswordHasher',
Obtendo ajuda
]
Língua: en
The list of validators that are used to check the strength of user’s passwords.
See Password validation for more details. By default, no validation is
performed and all passwords are
accepted.
Messages
Settings for django.contrib.messages.
MESSAGE_LEVEL
Default: messages.INFO
Sets the minimum message level that will be recorded by the messages
framework. See message levels for more details.
Important
MESSAGE_LEVEL = message_constants.DEBUG
If desired, you may specify the numeric values for the constants directly
according to the values in the above constants table.
MESSAGE_STORAGE
Default: 'django.contrib.messages.storage.fallback.FallbackStorage'
'django.contrib.messages.storage.fallback.FallbackStorage'
'django.contrib.messages.storage.session.SessionStorage'
'django.contrib.messages.storage.cookie.CookieStorage'
MESSAGE_TAGS
Default:
messages.DEBUG: 'debug',
messages.INFO: 'info',
messages.SUCCESS: 'success',
messages.WARNING: 'warning',
messages.ERROR: 'error',
Obtendo ajuda
This sets the mapping of message level to message tag, which is typically
rendered as a CSS class in HTML. If you specify a value, it will extend
the default. This means youLíngua:
only have
en to
specify those values which you need
to override. See Displaying messages above for more details.
If desired, you may specify the numeric values for the constants directly
according to the values in the above constants table.
Sessions
Settings for django.contrib.sessions.
SESSION_CACHE_ALIAS
Default: 'default'
SESSION_COOKIE_AGE
Default: (2 weeks, in seconds)1209600
SESSION_COOKIE_DOMAIN
Default: None
The domain to use for session cookies. Set this to a string such as
for cross-domain cookies, or use for a standard
domain cookie."example.com"None
SESSION_COOKIE_HTTPONLY
Default: True
SESSION_COOKIE_NAME
Default: 'sessionid'
The name of the cookie to use for sessions. This can be whatever you want
(as long as it’s different from the other cookie names in your application).
Obtendo ajuda
Língua: en
SESSION_COOKIE_PATH
Default: '/' Versão da documentação: 2.0
The path set on the session cookie. This should either match the URL path of your
Django installation or be parent of that path.
This is useful if you have multiple Django instances running under the same
hostname. They can use different cookie paths, and each instance will only see
its own session cookie.
SESSION_COOKIE_SECURE
Default: False
Whether to use a secure cookie for the session cookie. If this is set to
, the cookie will be marked as “secure,” which means browsers may
ensure that the cookie is only sent under an
HTTPS connection.True
Since it’s trivial for a packet sniffer (e.g. Firesheep) to hijack a user’s
session if the session cookie is sent unencrypted, there’s really no good
excuse to leave this off. It will prevent you
from using sessions on insecure
requests and that’s a good thing.
SESSION_ENGINE
Default: 'django.contrib.sessions.backends.db'
'django.contrib.sessions.backends.db'
'django.contrib.sessions.backends.file'
'django.contrib.sessions.backends.cache'
'django.contrib.sessions.backends.cached_db'
'django.contrib.sessions.backends.signed_cookies'
SESSION_EXPIRE_AT_BROWSER_CLOSE
Default: False
Whether to expire the session when the user closes their browser. See
Browser-length sessions vs. persistent sessions.
SESSION_FILE_PATH
Default: None
SESSION_SAVE_EVERY_REQUEST
Default: False
Whether to save the session data on every request. If this is (default), then the session data will only be saved if it has been modified –
that is, if any of its dictionary values have been
assigned or deleted. Empty
sessions won’t be created, even if this setting is active.False
SESSION_SERIALIZER
Default: 'django.contrib.sessions.serializers.JSONSerializer'
Full import path of a serializer class to use for serializing session data.
Included serializers are:
'django.contrib.sessions.serializers.PickleSerializer'
'django.contrib.sessions.serializers.JSONSerializer'
Obtendo ajuda
Língua: en
Sites
Versão da documentação: 2.0
Settings for django.contrib.sites.
SITE_ID
Default: Not defined
Static Files
Settings for django.contrib.staticfiles.
STATIC_ROOT
Default: None
Example: "/var/www/example.com/static/"
Warning
STATIC_URL
Default: None
Example: or "/static/""http://static.example.com/"
You may need to configure these files to be served in development and will definitely need to do so
in production.
STATICFILES_DIRS
Default: (Empty list)[]
This setting defines the additional locations the staticfiles app will traverse
if the finder is enabled, e.g. if you use the
collectstatic or findstatic management command or use
the
static file serving view.FileSystemFinder
STATICFILES_DIRS = [
"/home/special.polls.com/polls/static",
"/home/polls.com/polls/static",
"/opt/webfiles/common",
Obtendo ajuda
Note that these paths should use Unix-style forward slashes, even on Windows
(e.g. )."C:/Users/user/mysite/extra_static_content"
Língua: en
Prefixes (optional)
In case you want to refer to files in one of the locations with an additional
namespace, you can optionally provide a prefix as tuples, e.g.:(prefix, path)Versão da documentação: 2.0
STATICFILES_DIRS = [
# ...
("downloads", "/opt/webfiles/stats"),
STATICFILES_STORAGE
Default: 'django.contrib.staticfiles.storage.StaticFilesStorage'
The file storage engine to use when collecting static files with the
collectstatic management command.
For an example, see Serving static files from a cloud service or CDN.
STATICFILES_FINDERS
Default:
'django.contrib.staticfiles.finders.FileSystemFinder',
'django.contrib.staticfiles.finders.AppDirectoriesFinder',
The list of finder backends that know how to find static files in
various locations.
Note
Static file finders are currently considered a private interface, and this
interface is thus undocumented.
CACHE_MIDDLEWARE_ALIAS
Versão da documentação: 2.0
CACHE_MIDDLEWARE_KEY_PREFIX
CACHE_MIDDLEWARE_SECONDS
Database
DATABASES
DATABASE_ROUTERS
DEFAULT_INDEX_TABLESPACE
DEFAULT_TABLESPACE
Debugging
DEBUG
DEBUG_PROPAGATE_EXCEPTIONS
Email
ADMINS
DEFAULT_CHARSET
DEFAULT_FROM_EMAIL
EMAIL_BACKEND
EMAIL_FILE_PATH
EMAIL_HOST
EMAIL_HOST_PASSWORD
EMAIL_HOST_USER
EMAIL_PORT
EMAIL_SSL_CERTFILE
EMAIL_SSL_KEYFILE
EMAIL_SUBJECT_PREFIX
EMAIL_TIMEOUT
EMAIL_USE_LOCALTIME
EMAIL_USE_TLS
MANAGERS
SERVER_EMAIL
Error reporting
DEFAULT_EXCEPTION_REPORTER_FILTER
IGNORABLE_404_URLS
MANAGERS
SILENCED_SYSTEM_CHECKS
DEFAULT_FILE_STORAGE
Língua: en
FILE_CHARSET
FILE_UPLOAD_MAX_MEMORY_SIZE
FILE_UPLOAD_PERMISSIONS
FILE_UPLOAD_TEMP_DIR
MEDIA_ROOT
MEDIA_URL
Forms
FORM_RENDERER
Globalization (i18n/l10n)
DATE_FORMAT
DATE_INPUT_FORMATS
DATETIME_FORMAT
DATETIME_INPUT_FORMATS
DECIMAL_SEPARATOR
FIRST_DAY_OF_WEEK
FORMAT_MODULE_PATH
LANGUAGE_CODE
LANGUAGE_COOKIE_AGE
LANGUAGE_COOKIE_DOMAIN
LANGUAGE_COOKIE_NAME
LANGUAGE_COOKIE_PATH
LANGUAGES
LOCALE_PATHS
MONTH_DAY_FORMAT
NUMBER_GROUPING
SHORT_DATE_FORMAT
SHORT_DATETIME_FORMAT
THOUSAND_SEPARATOR
TIME_FORMAT
TIME_INPUT_FORMATS
TIME_ZONE
USE_I18N
USE_L10N
USE_THOUSAND_SEPARATOR
USE_TZ
YEAR_MONTH_FORMAT
HTTP
DATA_UPLOAD_MAX_MEMORY_SIZE Obtendo ajuda
DATA_UPLOAD_MAX_NUMBER_FIELDS
Língua: en
DEFAULT_CHARSET
DISALLOWED_USER_AGENTS
FORCE_SCRIPT_NAME
INTERNAL_IPS
MIDDLEWARE
Security
SECURE_BROWSER_XSS_FILTER
SECURE_CONTENT_TYPE_NOSNIFF
SECURE_HSTS_INCLUDE_SUBDOMAINS
SECURE_HSTS_PRELOAD
SECURE_HSTS_SECONDS
SECURE_PROXY_SSL_HEADER
SECURE_REDIRECT_EXEMPT
SECURE_SSL_HOST
SECURE_SSL_REDIRECT
SIGNING_BACKEND
USE_ETAGS
USE_X_FORWARDED_HOST
USE_X_FORWARDED_PORT
WSGI_APPLICATION
Logging
LOGGING
LOGGING_CONFIG
Models
ABSOLUTE_URL_OVERRIDES
FIXTURE_DIRS
INSTALLED_APPS
Security
Cross Site Request Forgery Protection
CSRF_COOKIE_DOMAIN
CSRF_COOKIE_NAME
CSRF_COOKIE_PATH
CSRF_COOKIE_SECURE
CSRF_FAILURE_VIEW
CSRF_HEADER_NAME
CSRF_TRUSTED_ORIGINS
CSRF_USE_SESSIONS
X_FRAME_OPTIONS
Língua: en
SERIALIZATION_MODULES
Templates
TEMPLATES
Testing
Database: TEST
TEST_NON_SERIALIZED_APPS
TEST_RUNNER
URLs
APPEND_SLASH
PREPEND_WWW
ROOT_URLCONF
SchemaEditor Signals
Learn More
About Django
Team Organization
Code of Conduct
Diversity Statement
Get Involved
Join a Group
Contribute to Django
Obtendo ajuda
Submit a Bug
GitHub
News RSS
Support Us
Sponsor Django
Amazon Smile
© 2005-2021
Django Software
Foundation and individual contributors. Django is a
registered
trademark of the Django Software Foundation.
Obtendo ajuda
Língua: en