Voici une liste des réglages disponibles au sein de Django et leurs valeurs par défaut. Les réglages fournis par les applications contrib sont énumérés ci-dessous, suivi d’un index des réglages de base par sujet. Pour du contenu d’initiation, consultez le guide thématique des réglages.
\nABSOLUTE_URL_OVERRIDESLien vers cette rubrique#Valeur par défaut : {} (dictionnaire vide)
Un dictionnaire faisant correspondre des chaînes du style "étiquette_app.nom_modèle" à des fonctions qui acceptent un objet de modèle et renvoient son URL. C’est une façon d’insérer ou de surcharger les méthodes get_absolute_url() en fonction de l’installation. Par exemple :
ABSOLUTE_URL_OVERRIDES = {\n 'blogs.weblog': lambda o: "/blogs/%s/" % o.slug,\n 'news.story': lambda o: "/stories/%s/%s/" % (o.pub_year, o.slug),\n}\nNotez que le nom de modèle utilisé dans ce réglage doit être tout en minuscules, quelle que soit la casse du nom de la classe modèle réelle.
\nADMINSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Une liste de toutes les personnes qui reçoivent les notifications d’erreurs dans le code. Lorsque DEBUG=False et qu’une vue lève une exception, Django envoie un courriel à ces personnes contenant les informations complètes de l’exception. Chaque élément de la liste doit être un tuple au format « (nom complet, adresse électronique) ». Exemple :
[('John', 'john@example.com'), ('Mary', 'mary@example.com')]\nNotez que Django envoie un courriel à toutes ces personnes lors de chaque erreur. Consultez Signalement d’erreurs pour plus d’informations.
\nALLOWED_HOSTSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Une liste de chaînes représentant des noms de domaine/d’hôte que ce site Django peut servir. C’est une mesure de sécurité pour empêcher les attaques d’en-tête Host HTTP, qui sont possibles même avec bien des configurations de serveur Web apparemment sécurisées.
\nLes valeurs de cette liste peuvent être des noms complètement qualifiés (par ex. 'www.example.com'), auquel cas ils seront comparés exactement (insensible à la casse, port exclu) avec l’en-tête Host de la requête. Une valeur commençant par un point peut être utilisée comme métacaractère de sous-domaine : '.example.com' correspondra à example.com, www.example.com, et tout autre sous-domaine de example.com. Une valeur '*' correspond à tout ; dans ce cas, vous êtes responsable de fournir votre propre validation de l’en-tête Host (éventuellement dans un middleware ; dans ce cas, le middleware doit figurer en premier dans MIDDLEWARE).
Django permet également d’écrire un nom de domaine pleinement qualifié (FQDN) dans la liste. Certains navigateurs incluent un point terminal dans l’en-tête Host; Django l’enlève au moment de la validation d’hôte.
Si l’en-tête Host (ou X-Forwarded-Host quand USE_X_FORWARDED_HOST est actif) ne correspond à aucune valeur de cette liste, la méthode django.http.HttpRequest.get_host() lèvera SuspiciousOperation.
Lorsque DEBUG vaut True et que ALLOWED_HOSTS est vide, l’hôte est validé selon ['localhost', '127.0.0.1', '[::1]'].
Cette validation ne s’applique qu’avec get_host() ; si votre code accède directement à l’en-tête Host dans request.META, vous outrepassez cette protection de sécurité.
APPEND_SLASHLien vers cette rubrique#Valeur par défaut : True
Si défini à True et que l’URL de la requête ne correspond à aucun des motifs de l’URLconf et que l’URL ne se termine pas par une barre oblique (slash), Django effectue une redirection HTTP vers la même URL additionnée d’une barre oblique finale. Notez que la redirection peut causer la perte d’éventuelles données envoyées avec une requête POST.
Le réglage APPEND_SLASH n’est utilisé que si CommonMiddleware est installé (voir Intergiciels (« Middleware »)). Voir aussi PREPEND_WWW.
CACHESLien vers cette rubrique#Valeur par défaut :
\n{\n 'default': {\n 'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',\n }\n}\nUn dictionnaire contenant les réglages de tous les caches à utiliser avec Django. C’est un dictionnaire imbriqué dont les contenus sont une correspondance entre les alias des caches et un dictionnaire contenant les options de chacun des caches.
\nLe réglage CACHES doit configurer un cache default (par défaut) ; il est possible d’ajouter autant d’autres caches que souhaité. Si vous utilisez un moteur de cache autre que le cache de mémoire locale ou que vous deviez définir plusieurs caches, d’autres options devront être ajoutées. Les options de cache suivantes sont disponibles.
BACKENDLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Le moteur de cache à utiliser. Les moteurs de cache intégrés à Django sont :
\n'django.core.cache.backends.db.DatabaseCache'
'django.core.cache.backends.dummy.DummyCache'
'django.core.cache.backends.filebased.FileBasedCache'
'django.core.cache.backends.locmem.LocMemCache'
'django.core.cache.backends.memcached.MemcachedCache'
'django.core.cache.backends.memcached.PyLibMCCache'
Vous pouvez utiliser un moteur de cache non livré avec Django en définissant BACKEND à un chemin complètement qualifié d’une classe de moteur de cache (par ex. monpaquet.moteurs.quelquechose.MonCache).
KEY_FUNCTIONLien vers cette rubrique#Une chaîne contenant un chemin pointé vers une fonction (ou tout autre objet exécutable) qui définit la manière de composer un préfixe, une version et une clé pour former une clé de cache finale. L’implémentation par défaut est équivalente à la fonction :
\ndef make_key(key, key_prefix, version):\n return ':'.join([key_prefix, str(version), key])\nVous pouvez utiliser n’importe quelle fonction de clé, tant que la signature des paramètres est la même.
\nConsultez la documentation du cache pour plus d’informations.
\nKEY_PREFIXLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Une chaîne qui sera automatiquement incluse (préfixée par défaut) à toutes les clés de cache utilisées par le serveur Django.
\nConsultez la documentation du cache pour plus d’informations.
\nLOCATIONLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
L’emplacement du cache. Cela peut être un répertoire pour un cache en système de fichiers, un hôte et un port pour le moteur memcache, ou simplement un identifiant pour un cache en mémoire locale, par ex. :
CACHES = {\n 'default': {\n 'BACKEND': 'django.core.cache.backends.filebased.FileBasedCache',\n 'LOCATION': '/var/tmp/django_cache',\n }\n}\nOPTIONSLien vers cette rubrique#Valeur par défaut : None
Paramètres supplémentaires à transmettre au moteur de cache. Les paramètres disponibles varient en fonction du moteur de cache.
\nCertaines informations sur les paramètres disponibles peuvent être trouvées dans la documentation des paramètres de cache. Pour plus d’informations, consultez la documentation propre au module du moteur utilisé.
\nTIMEOUTLien vers cette rubrique#Valeur par défaut : 300
Le nombre de secondes avant qu’une entrée de cache soit considérée comme obsolète. Si la valeur de ce réglage est None, les contenus du cache n’expirent jamais.
VERSIONLien vers cette rubrique#Valeur par défaut : 1
Le numéro de version par défaut des clés de cache générées par le serveur Django.
\nConsultez la documentation du cache pour plus d’informations.
\nCACHE_MIDDLEWARE_ALIASLien vers cette rubrique#Valeur par défaut : default
La connexion de cache à utiliser pour l”intergiciel de cache.
\nCACHE_MIDDLEWARE_KEY_PREFIXLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Une chaîne qui servira de préfixe aux clés de cache générées par l”intergiciel de cache. Ce préfixe est combiné avec le réglage KEY_PREFIX, il ne le remplace pas.
CACHE_MIDDLEWARE_SECONDSLien vers cette rubrique#Valeur par défaut : 600
Le nombre de secondes correspondant à la durée par défaut de mise en cache d’une page pour l”intergiciel de cache.
\n\nCSRF_FAILURE_VIEWLien vers cette rubrique#Valeur par défaut : 'django.views.csrf.csrf_failure'
Un chemin pointé vers la fonction Vue à utiliser lorsqu’une requête entrante est rejetée par la protection CSRF. La fonction doit avoir cette signature :
\ndef csrf_failure(request, reason=""):\n ...\noù reason est un bref message (à l’intention des développeurs ou de la journalisation, par pour les utilisateurs finaux) indiquant la raison du rejet de la requête. Elle devrait renvoyer une réponse HttpResponseForbidden.
django.views.csrf.csrf_failure() accepte un paramètre supplémentaire template_name qui vaut '403_csrf.html' par défaut. Si un gabarit de ce nom existe, il sera utilisé pour produire la page.
CSRF_HEADER_NAMELien vers cette rubrique#Valeur par défaut : 'HTTP_X_CSRFTOKEN'
Le nom de l’en-tête de requête utilisé pour l’authentification CSRF.
\nComme avec d’autres en-têtes HTTP dans request.META, le nom d’en-tête reçu du serveur est normalisé en convertissant tous les caractères en majuscules, remplaçant les tirets par des soulignements et en ajoutant un préfixe HTTP_ au nom. Par exemple, si un client envoie un en-tête 'X-XSRF-TOKEN', le réglage devrait être 'HTTP_X_XSRF_TOKEN'.
CSRF_TRUSTED_ORIGINSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Une liste d’hôtes qui sont des origines de confiance pour les requêtes non sûres (par ex. POST). Pour une requête sécurisée non sûre, la protection CSRF de Django exige que la requête possède un en-tête Referer correspondant à l’origine présente dans l’en-tête Host. Cela empêche par exemple qu’une requête POST à partir de sousdomaine.exemple.com puisse aboutir sur api.exemple.com. En continuant sur cet exemple, si vous avez besoin de pouvoir effectuer des requêtes croisées non sûres entre domaines et par HTTPS, ajoutez "sousdomaine.exemple.com" à cette liste. Le réglage accepte également les sous-domaines, de sorte que par exemple, ".exemple.com" serait aussi valable pour permettre l’accès depuis tous les sous-domaines de exemple.com.
DATABASESLien vers cette rubrique#Valeur par défaut : {} (dictionnaire vide)
Un dictionnaire contenant les réglages de toutes les bases de données à utiliser avec Django. C’est un dictionnaire imbriqué dont les contenus font correspondre l’alias de base de données avec un dictionnaire contenant les options de chacune des bases de données.
\nLe réglage DATABASES doit configurer une base de données default; il est possible de définir autant de bases de données que nécessaire.
Le fichier de réglages le plus simple possible est destiné à une configuration à base de données unique utilisant le moteur SQLite. Cela peut être configuré de cette façon :
\nDATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.sqlite3',\n 'NAME': 'mydatabase',\n }\n}\nLors de la connexion à d’autres moteurs de base de données, tels que MySQL, Oracle ou PostgreSQL, des paramètres de connexion supplémentaires sont requis. Voir le réglage ENGINE ci-dessous sur la façon de spécifier d’autres types de bases de données. Cet exemple vaut pour PostgreSQL :
DATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.postgresql',\n 'NAME': 'mydatabase',\n 'USER': 'mydatabaseuser',\n 'PASSWORD': 'mypassword',\n 'HOST': '127.0.0.1',\n 'PORT': '5432',\n }\n}\nLes options internes suivantes, qui peuvent être nécessaires pour des configurations plus complexes, sont disponibles :
\nATOMIC_REQUESTSLien vers cette rubrique#Valeur par défaut : False
Définissez ce réglage à True pour envelopper chaque vue dans une transaction sur cette base de données. Voir Couplage des transactions aux requêtes HTTP.
AUTOCOMMITLien vers cette rubrique#Valeur par défaut : True
Définissez ce réglage à False si vous souhaitez désactiver la gestion des transactions de Django et implémenter la vôtre.
ENGINELien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Le moteur de base de données à utiliser. Les moteurs de base de données intégrés à Django sont :
\n'django.db.backends.postgresql'
'django.db.backends.mysql'
'django.db.backends.sqlite3'
'django.db.backends.oracle'
Vous pouvez utiliser un moteur de base de données non livré avec Django en définissant ENGINE à un chemin complètement qualifié d’une classe de moteur de base de données (par ex. monpaquet.moteurs.quelquechose).
HOSTLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
L’hôte à utiliser lors de la connexion à la base de données. Une chaîne vide signifie localhost. Non utilisé avec SQLite.
Si cette valeur commence par une barre oblique ('/') et que vous utilisez MySQL, MySQL se connectera par un connecteur Unix au connecteur indiqué. Par exemple :
"HOST": '/var/run/mysql'\nSi vous utilisez MySQL et que cette valeur ne commence pas par une barre oblique, Django part du principe que la valeur est un hôte.
\nSi vous utilisez PostgreSQL, par défaut (HOST vide), la connexion à la base de données se fait au travers de connecteurs Unix (lignes « local » dans pg_hba.conf). Si votre connecteur de domaine UNIX n’est pas à l’emplacement standard, utilisez la même valeur unix_socket_directory que celle de postgresql.conf. Si vous préférez vous connecter via des connecteurs TCP, définissez HOST à « localhost » ou « 127.0.0.1 » (lignes « host » dans pg_hba.conf). Sous Windows, vous devez toujours définir HOST, car les connecteurs de domaine Unix ne sont pas disponibles.
NAMELien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Le nom de la base de données à utiliser. Pour SQLite, c’est le chemin complet vers le fichier de la base de données. Quand un chemin est indiqué, utilisez toujours des barres obliques vers l’avant, même sur Windows (par ex. C:/homes/user/mysite/sqlite3.db).
CONN_MAX_AGELien vers cette rubrique#Valeur par défaut : 0
La durée de vie d’une connexion de base de données, en secondes. Utilisez 0 pour fermer les connexions de base de données à la fin de chaque requête – comportement historique de Django – et None pour les connexions persistantes illimitées.
OPTIONSLien vers cette rubrique#Valeur par défaut : {} (dictionnaire vide)
Des paramètres supplémentaires à utiliser lors de la connexion à la base de données. Les paramètres disponibles varient en fonction du moteur de base de données.
\nCertaines informations sur les paramètres disponibles peuvent être trouvées dans la documentation des moteurs de base de données. Pour plus d’informations, consultez la documentation propre au module du moteur utilisé.
\nPASSWORDLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Le mot de passe à utiliser lors de la connexion à la base de données. Non utilisé avec SQLite.
\nPORTLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Le port à utiliser lors de la connexion à la base de données. Une chaîne vide signifie le port par défaut. Non utilisé avec SQLite.
\nTIME_ZONELien vers cette rubrique#Valeur par défaut : None
Une chaîne représentant le fuseau horaire des dates/heures stockées dans cette base de données (en supposant qu’elle prenne en charge les fuseaux horaires) ou None. Les valeurs acceptées sont les mêmes que pour le réglage général TIME_ZONE.
Ceci permet d’interagir avec des bases de données tierces qui stockent les dates/heures en heure locale plutôt qu’en UTC. Pour éviter des problèmes autour des changements d’heure d’été/hiver, vous ne devriez pas définir cette option pour les bases de données gérées par Django.
\nLa définition de cette option nécessite l’installation de pytz.
\nLorsque USE_TZ vaut True et que la base de données ne gère pas les fuseaux horaires (par ex. SQLite, MySQL, Oracle), Django lit et écrit les dates/heures en heure locale en fonction de cette option quand elle est définie et en UTC si elle ne l’est pas.
Lorsque USE_TZ vaut True et que la base de données prend en charge les fuseaux horaires (par ex. PostgreSQL), la définition de cette option produit une erreur.
Lorsque USE_TZ vaut False, la définition de cette option produit une erreur.
USERLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Le nom d’utilisateur à utiliser lors de la connexion à la base de données. Non utilisé avec SQLite.
\nTESTLien vers cette rubrique#Valeur par défaut : {} (dictionnaire vide)
Un dictionnaire de réglages pour les bases de données de test ; pour plus de détails sur la création et l’utilisation de bases de données de test, voir La base de données de test.
\nVoici un exemple avec une configuration de base de données de test :
\nDATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.postgresql',\n 'USER': 'mydatabaseuser',\n 'NAME': 'mydatabase',\n 'TEST': {\n 'NAME': 'mytestdatabase',\n },\n },\n}\nLes clés suivantes sont disponibles dans le dictionnaire TEST:
CHARSETLien vers cette rubrique#Valeur par défaut : None
Le codage de caractères utilisé pour créer la base de données de test. La valeur de cette chaîne est passée directement à la base de données, son format est donc dépendant du moteur.
\nPris en charge par les moteurs PostgreSQL (postgresql) et MySQL (mysql).
COLLATIONLien vers cette rubrique#Valeur par défaut : None
L’ordre de collation à utiliser lors de la création de la base de données de test. Cette value est directement transmise au moteur, son format est donc spécifique au moteur.
\nPris en charge uniquement pour le moteur mysql (consultez le manuel de MySQL pour plus de détails).
DEPENDENCIESLien vers cette rubrique#Valeur par défaut : ['default'], pour toutes les bases de données, excepté default qui n’a pas de dépendances.
Les dépendances d’ordre de création de la base de données. Consultez la documentation sur le contrôle de l’ordre de création des bases de données de test pour plus de détails.
\nMIRRORLien vers cette rubrique#Valeur par défaut : None
L’alias de la base de données que cette base de données doit refléter durant les tests.
\nCe réglage existe pour permettre de tester des configurations primaire/réplique (aussi appelées maître-esclaves par certaines bases de données) de plusieurs bases de données. Consultez la documentation sur le test de configurations primaire/réplique pour plus de détails.
\nNAMELien vers cette rubrique#Valeur par défaut : None
Le nom de la base de données à utiliser lors du fonctionnement de la suite de tests.
\nSi la valeur par défaut (None) est utilisée avec le moteur de base de données SQLite, les tests utiliseront une base de données en mémoire vive. Pour tous les autres moteurs de base de données, la base de données de test sera nommée 'test_' + DATABASE_NAME.
SERIALIZELien vers cette rubrique#Valeur booléenne permettant de contrôler si le lanceur de tests par défaut sérialise la base de données en une chaîne JSON en mémoire avant de lancer les tests (utilisé pour restaurer l’état de la base de données entre les tests s’il n’y a pas de transactions). Vous pouvez le définir à False pour accélérer nettement le temps de création si aucune de vos classes de test ne comporte serialized_rollback=True.
CREATE_DBLien vers cette rubrique#Valeur par défaut : True
Ce paramètre est spécifique à Oracle.
\nS’il est défini à False, l’espace de tables de test ne sera pas automatiquement créé au début des tests, ni supprimé à la fin.
CREATE_USERLien vers cette rubrique#Valeur par défaut : True
Ce paramètre est spécifique à Oracle.
\nSi défini à False, l’utilisateur test ne sera pas automatiquement créé au début des tests, ni supprimé à la fin.
USERLien vers cette rubrique#Valeur par défaut : None
Ce paramètre est spécifique à Oracle.
\nLe nom d’utilisateur à utiliser lors de la connexion à la base de données Oracle durant les tests. Si non fourni, Django utilise 'test_' + USER.
PASSWORDLien vers cette rubrique#Valeur par défaut : None
Ce paramètre est spécifique à Oracle.
\nLe mot de passe à utiliser lors de la connexion à la base de données Oracle durant les tests. Si non fourni, Django génère un mot de passe aléatoire.
\n\nTBLSPACELien vers cette rubrique#Valeur par défaut : None
Ce paramètre est spécifique à Oracle.
\nLe nom de l’espace de tables utilisé lors des tests. Si non fourni, Django utilise 'test_' + USER.
TBLSPACE_TMPLien vers cette rubrique#Valeur par défaut : None
Ce paramètre est spécifique à Oracle.
\nLe nom de l’espace de tables temporaire utilisé lors des tests. Si non fourni, Django utilise 'test_' + USER + '_temp'.
DATAFILELien vers cette rubrique#Valeur par défaut : None
Ce paramètre est spécifique à Oracle.
\nLe nom du fichier de données à utiliser pour TBLSPACE. Si non fourni, Django utilise TBLSPACE + '.dbf'.
DATAFILE_TMPLien vers cette rubrique#Valeur par défaut : None
Ce paramètre est spécifique à Oracle.
\nLe nom du fichier de données à utiliser pour TBLSPACE_TMP. Si non fourni, Django utilise TBLSPACE_TMP + '.dbf'.
DATAFILE_MAXSIZELien vers cette rubrique#Valeur par défaut : '500M'
Ce paramètre est spécifique à Oracle.
\nLa taille maximale que DATAFILE est autorisé à atteindre.
\nDATAFILE_TMP_MAXSIZELien vers cette rubrique#Valeur par défaut : '500M'
Ce paramètre est spécifique à Oracle.
\nLa taille maximale que DATAFILE_TMP est autorisé à atteindre.
\nValeur par défaut : 2621440 (c-à-d. 2.5 Mio).
La taille maximale en octets d’un corps de requête avant qu’il ne provoque une exception SuspiciousOperation (RequestDataTooBig). Le contrôle est effectué lors de l’accès à request.body ou à request.POST et est calculé par rapport à la taille totale de la requête sans les données d’envoi de fichiers (uploads). Vous pouvez le définir à None pour désactiver le contrôle. Les applications susceptibles de recevoir des envois de formulaires inhabituellement volumineux devraient ajuster ce réglage.
La quantité de données de requête est corrélée à la quantité de mémoire nécessaire pour traiter la requête et remplir les dictionnaires GET et POST. Les grosses requêtes pourraient être utilisées comme vecteur d’attaque par déni de service si elles n’étaient pas contrôlées. Comme les serveurs Web n’effectuent en principe pas d’inspection approfondie des requêtes, il n’est pas possible de procéder à ce genre de contrôle à leur niveau.
\nVoir aussi FILE_UPLOAD_MAX_MEMORY_SIZE.
Valeur par défaut : 1000
Le nombre maximum de paramètres pouvant être reçus via GET ou POST avant qu’une exception SuspiciousOperation (TooManyFields) soit générée. Vous pouvez le définir à None pour désactiver le contrôle. Les applications susceptibles de recevoir un nombre inhabituellement grand de champs de formulaire devraient ajuster ce réglage.
Le nombre de paramètres de requête est corrélé à la quantité de temps nécessaire pour traiter la requête et remplir les dictionnaires GET et POST. Les grosses requêtes pourraient être utilisées comme vecteur d’attaque par déni de service si elles n’étaient pas contrôlées. Comme les serveurs Web n’effectuent en principe pas d’inspection approfondie des requêtes, il n’est pas possible de procéder à ce genre de contrôle à leur niveau.
\nDATABASE_ROUTERSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
La liste des routeurs utilisés pour déterminer à quelle base de données il faut accéder lors de l’exécution d’une requête de base de données.
\nConsultez la documentation sur le routage automatique des bases de données dans des configurations à plusieurs bases.
\nDATE_FORMATLien vers cette rubrique#Valeur par défaut : 'N j, Y' (ex . : Feb. 4, 2003)
Le format par défaut pour l’affichage des champs dates dans les différentes parties du système. Notez que si USE_L10N est défini à True, le format piloté par la locale a une priorité plus élevée et remplacera ce format. Voir les chaînes de format de date autorisées.
Voir aussi DATETIME_FORMAT, TIME_FORMAT et SHORT_DATE_FORMAT.
DATE_INPUT_FORMATSLien vers cette rubrique#Valeur par défaut :
\n[\n '%Y-%m-%d', '%m/%d/%Y', '%m/%d/%y', # '2006-10-25', '10/25/2006', '10/25/06'\n '%b %d %Y', '%b %d, %Y', # 'Oct 25 2006', 'Oct 25, 2006'\n '%d %b %Y', '%d %b, %Y', # '25 Oct 2006', '25 Oct, 2006'\n '%B %d %Y', '%B %d, %Y', # 'October 25 2006', 'October 25, 2006'\n '%d %B %Y', '%d %B, %Y', # '25 October 2006', '25 October, 2006'\n]\nUne liste de formats qui seront acceptés lors de la saisie de données dans un champ date. Les formats seront testés dans l’ordre et le premier correspondant sera utilisé. Notez que ces chaînes de format utilisent la syntaxe du module datetime de Python, et non pas celle des chaînes de format du filtre de gabarit date.
Lorsque USE_L10N vaut True, le format piloté par la locale a une priorité plus élevée et remplace ce format.
Voir aussi DATETIME_INPUT_FORMATS et TIME_INPUT_FORMATS.
DATETIME_FORMATLien vers cette rubrique#Valeur par défaut : 'N j, Y, P' (ex. Feb. 4, 2003, 4 p.m.)
Le format par défaut pour l’affichage des champs dates/heures dans les différentes parties du système. Notez que si USE_L10N est défini à True, le format piloté par la locale a une priorité plus élevée et remplacera ce format. Voir les chaînes de format de date autorisées.
Voir aussi DATE_FORMAT, TIME_FORMAT et SHORT_DATETIME_FORMAT.
DATETIME_INPUT_FORMATSLien vers cette rubrique#Valeur par défaut :
\n[\n '%Y-%m-%d %H:%M:%S', # '2006-10-25 14:30:59'\n '%Y-%m-%d %H:%M:%S.%f', # '2006-10-25 14:30:59.000200'\n '%Y-%m-%d %H:%M', # '2006-10-25 14:30'\n '%Y-%m-%d', # '2006-10-25'\n '%m/%d/%Y %H:%M:%S', # '10/25/2006 14:30:59'\n '%m/%d/%Y %H:%M:%S.%f', # '10/25/2006 14:30:59.000200'\n '%m/%d/%Y %H:%M', # '10/25/2006 14:30'\n '%m/%d/%Y', # '10/25/2006'\n '%m/%d/%y %H:%M:%S', # '10/25/06 14:30:59'\n '%m/%d/%y %H:%M:%S.%f', # '10/25/06 14:30:59.000200'\n '%m/%d/%y %H:%M', # '10/25/06 14:30'\n '%m/%d/%y', # '10/25/06'\n]\nUne liste de formats qui seront acceptés lors de la saisie de données dans un champ date/heure. Les formats seront testés dans l’ordre et le premier correspondant sera utilisé. Notez que ces chaînes de format utilisent la syntaxe du module datetime de Python, et non pas celle des chaînes de format du filtre de gabarit date.
Lorsque USE_L10N vaut True, le format piloté par la locale a une priorité plus élevée et remplace ce format.
Voir aussi DATE_INPUT_FORMATS et TIME_INPUT_FORMATS.
DEBUGLien vers cette rubrique#Valeur par défaut : False
Une valeur booléenne qui active ou désactive le mode de débogage.
\nNe déployez jamais de site en production avec le réglage DEBUG activé.
Avez-vous bien lu ? Ne JAMAIS déployer un site en production avec le réglage DEBUG activé.
L’une des fonctionnalités principales du mode de débogage est l’affichage de pages d’erreur détaillées. Si votre application lève une exception quand DEBUG vaut True, Django affiche une trace détaillée, y compris de nombreuses métadonnées au sujet de votre environnement, comme par exemple la liste complète des réglages Django en vigueur (tirés de settings.py).
Comme mesure de sécurité, Django n’affiche pas les réglages pouvant comporter des données sensibles, comme SECRET_KEY. Plus précisément, il exclut tout réglage dont le nom contient l’un des éléments suivants :
'API'
'KEY'
'PASS'
'SECRET'
'SIGNATURE'
'TOKEN'
Notez qu’il s’agit de correspondances partielles. 'PASS' va aussi intercepter PASSWORD, comme 'TOKEN' interceptera TOKENIZED et ainsi de suite.
Toutefois, notez qu’il y aura toujours des parties de l’affichage de débogage qui contiennent des éléments inappropriés pour le tout public. Des chemins de fichiers, des options de configuration et d’autres choses semblables peuvent tous donner à des attaquants des informations supplémentaires au sujet de votre serveur.
\nIl est aussi important de se rappeler que lorsque un site fonctionne en mode DEBUG, Django mémorise chaque requête SQL qu’il exécute. C’est utile lors de séances de débogage, mais cela va assez rapidement consommer beaucoup de mémoire sur un serveur de production.
Enfin, si DEBUG vaut False, vous devez également définir correctement le réglage ALLOWED_HOSTS. Sans cela, toutes les requêtes renverront l’erreur « Bad Request (400) ».
DEBUG_PROPAGATE_EXCEPTIONSLien vers cette rubrique#Valeur par défaut : False
Si défini à True, la gestion normale des exceptions par Django pour les fonctions de vue sera supprimée et les exceptions vont donc se propager. Cela peut être utile pour certaines configurations de test, mais ne devrait jamais être activé sur un site en production.
DECIMAL_SEPARATORLien vers cette rubrique#Valeur par défaut : '.' (point)
Séparateur décimal par défaut utilisé lors du formatage des nombres à virgule.
\nNotez que lorsque USE_L10N vaut True, le format piloté par la locale a une priorité plus élevée et remplace ce séparateur.
Voir aussi NUMBER_GROUPING, THOUSAND_SEPARATOR et USE_THOUSAND_SEPARATOR.
DEFAULT_CHARSETLien vers cette rubrique#Valeur par défaut : 'utf-8'
Codage de caractères par défaut utilisé pour tous les objets HttpResponse si un type MIME n’est pas manuellement indiqué. Utilisé conjointement avec DEFAULT_CONTENT_TYPE pour construire l’en-tête Content-Type.
DEFAULT_CONTENT_TYPELien vers cette rubrique#Valeur par défaut : 'text/html'
Type de contenu par défaut utilisé pour tous les objets HttpResponse si un type MIME n’est pas manuellement indiqué. Utilisé conjointement avec DEFAULT_CHARSET pour construire l’en-tête Content-Type.
DEFAULT_EXCEPTION_REPORTER_FILTERLien vers cette rubrique#Valeur par défaut : 'django.views.debug.SafeExceptionReporterFilter'
Classe de filtre de rapports d’exception utilisée par défaut si aucune n’a été attribuée à l’instance HttpRequest. Voir Filtrage des rapports d’erreur.
DEFAULT_FILE_STORAGELien vers cette rubrique#Valeur par défaut : 'django.core.files.storage.FileSystemStorage'
Classe de stockage de fichiers utilisée par défaut pour toute opération liée à des fichiers quand un système de stockage n’est pas explicitement indiqué. Voir Gestion des fichiers.
\nDEFAULT_FROM_EMAILLien vers cette rubrique#Valeur par défaut : 'webmaster@localhost'
L’adresse de courriel par défaut à utiliser pour diverses correspondance automatisées de la part des gestionnaires du site. Cela n’inclut pas les messages d’erreur envoyés à ADMINS et MANAGERS; pour cela, voir SERVER_EMAIL.
DEFAULT_INDEX_TABLESPACELien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Espace de tables utilisé par défaut pour les index sur les champs qui n’en indiquent pas, si le moteur les prend en charge (voir Espaces de tables).
\nDEFAULT_TABLESPACELien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Espace de tables utilisé par défaut pour les modèles qui n’en indiquent pas, si le moteur les prend en charge (voir Espaces de tables).
\nDISALLOWED_USER_AGENTSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Liste d’objets d’expressions régulières compilées représentant des chaînes d’agent utilisateur (User-Agent) qui ne sont globalement pas autorisés à visiter le site. Utile pour les robots ou les collecteurs malveillants. Ce réglage n’est utilisé que si CommonMiddleware est installé (voir Intergiciels (« Middleware »)).
EMAIL_BACKENDLien vers cette rubrique#Valeur par défaut : 'django.core.mail.backends.smtp.EmailBackend'
Le moteur à utiliser pour envoyer des courriels. Consultez Envoi de messages électroniques pour obtenir la liste des moteurs disponibles.
\nEMAIL_FILE_PATHLien vers cette rubrique#Valeur par défaut : non définie
\nLe répertoire utilisé par le moteur de messagerie file pour stocker les fichiers qu’il produit.
EMAIL_HOSTLien vers cette rubrique#Valeur par défaut : 'localhost'
L’hôte à utiliser pour envoyer des courriels.
\nVoir aussi EMAIL_PORT.
EMAIL_HOST_PASSWORDLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Mot de passe à utiliser pour le serveur SMTP défini dans EMAIL_HOST. Ce réglage est utilisé conjointement avec EMAIL_HOST_USER lors de l’authentification au serveur SMTP. Si l’un de ces réglages est vide, Django ne tente pas de s’authentifier.
Voir aussi EMAIL_HOST_USER.
EMAIL_HOST_USERLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Nom d’utilisateur à utiliser pour le serveur SMTP défini dans EMAIL_HOST. S’il est vide, Django ne tente pas de s’authentifier.
Voir aussi EMAIL_HOST_PASSWORD.
EMAIL_PORTLien vers cette rubrique#Valeur par défaut : 25
Port à utiliser pour le serveur SMTP défini dans EMAIL_HOST.
EMAIL_SUBJECT_PREFIXLien vers cette rubrique#Valeur par défaut : '[Django] '
Préfixe de la ligne du sujet dans les messages électroniques envoyés avec django.core.mail.mail_admins ou django.core.mail.mail_managers. Une espace finale est probablement adéquate.
EMAIL_USE_TLSLien vers cette rubrique#Valeur par défaut : False
Indique si une connexion TLS (sécurisée) doit être utilisée pour le dialogue avec le serveur SMTP. Ceci s’applique aux connexions TLS explicites, généralement sur le port 587. Si vous obtenez des connexions qui se bloquent, consultez le réglage TLS implicite EMAIL_USE_SSL.
EMAIL_USE_SSLLien vers cette rubrique#Valeur par défaut : False
Indique si une connexion TLS implicite (sécurisée) doit être utilisée pour le dialogue avec le serveur SMTP. Dans la plupart de documentations de messagerie électronique, ce type de connexion TLS s’appelle SSL. C’est généralement le port 465 qui est utilisé. Si vous rencontrez des problèmes, consultez le réglage TLS explicite EMAIL_USE_TLS.
Notez que setting:EMAIL_USE_TLS/EMAIL_USE_SSL sont mutuellement exclusifs, un seul d’entre eux peut donc être défini à True.
EMAIL_SSL_CERTFILELien vers cette rubrique#Valeur par défaut : None
Si EMAIL_USE_SSL ou EMAIL_USE_TLS valent True, vous pouvez définir de manière facultative le chemin vers un fichier de chaîne de certificat de type PEM à utiliser pour la connexion SSL.
EMAIL_SSL_KEYFILELien vers cette rubrique#Valeur par défaut : None
Si EMAIL_USE_SSL ou EMAIL_USE_TLS valent True, vous pouvez définir de manière facultative le chemin vers un fichier de clé privée de type PEM à utiliser pour la connexion SSL.
Notez que la définition de EMAIL_SSL_CERTFILE et de EMAIL_SSL_KEYFILE n’amène à aucune vérification de certificat. Ces valeurs sont transmises à la connexion SSL sous-jacente. Veuillez vous référer à la documentation de la fonction python:ssl.wrap_socket() de Python pour des détails sur la façon dont les fichiers de chaîne de certificat et de clé privée sont traités.
EMAIL_TIMEOUTLien vers cette rubrique#Valeur par défaut : None
Définit un délai d’expiration en secondes pour des opérations bloquantes telles que la tentative de connexion.
\nFILE_CHARSETLien vers cette rubrique#Valeur par défaut : 'utf-8'
Le codage de caractères utilisé pour décoder tout fichier lu à partir du disque. Cela comprend les fichiers de gabarits et les fichiers de données SQL initiales.
\nFILE_UPLOAD_HANDLERSLien vers cette rubrique#Valeur par défaut :
\n[\n 'django.core.files.uploadhandler.MemoryFileUploadHandler',\n 'django.core.files.uploadhandler.TemporaryFileUploadHandler',\n]\nUne liste de gestionnaires à utiliser pour le téléversement de fichiers. Ce réglage permet de personnaliser complètement (même remplacer) le processus de gestion des téléversements par Django.
\nVoir Gestion des fichiers pour plus de détails.
\nFILE_UPLOAD_MAX_MEMORY_SIZELien vers cette rubrique#Valeur par défaut : 2621440 (c-à-d. 2.5 Mio).
La taille maximale (en octets) d’un téléversement avant qu’il ne soit déporté sur le système de fichiers. Voir Gestion des fichiers pour plus de détails.
\nVoir aussi DATA_UPLOAD_MAX_MEMORY_SIZE.
FILE_UPLOAD_DIRECTORY_PERMISSIONSLien vers cette rubrique#Valeur par défaut : None
Le mode numérique à appliquer aux répertoires créés durant le processus de téléversement de fichiers.
\nCe réglage détermine également les permissions par défaut pour les répertoires de recueil des fichiers statiques lors de l’utilisation de la commande d’administration collectstatic. Voir collectstatic pour des détails sur la façon de le redéfinir.
Cette valeur reflète la fonctionnalité et les restrictions du réglage FILE_UPLOAD_PERMISSIONS.
FILE_UPLOAD_PERMISSIONSLien vers cette rubrique#Valeur par défaut : None
Le mode numérique (ex : 0o644) des permissions pour les nouveaux fichiers téléversés. Pour plus d’informations sur la signification des ces modes, consultez la documentation de os.chmod().
Si ce réglage n’est pas défini ou qu’il vaut None, vous obtiendrez un comportement dépendant du système d’exploitation. Sur la plupart des plates-formes, les fichiers temporaires obtiennent un mode 0o600 et les fichiers enregistrés à partir de la mémoire sont enregistrés avec le masque « umask » standard du système.
Pour des raisons de sécurité, ces permissions ne sont pas appliquées aux fichiers temporaires qui sont stockés dans FILE_UPLOAD_TEMP_DIR.
Ce réglage détermine également les permissions par défaut pour les fichiers statiques recueillis par la commande d’administration collectstatic. Voir collectstatic pour des détails sur la façon de le redéfinir.
FILE_UPLOAD_TEMP_DIRLien vers cette rubrique#Valeur par défaut : None
Le répertoire dans lequel stocker temporairement les données (typiquement pour les fichiers plus grands que FILE_UPLOAD_MAX_MEMORY_SIZE) lors des téléversements de fichiers. Avec la valeur None, Django utilise le répertoire temporaire standard du système d’exploitation. Par exemple, il s’agit de /tmp sur les systèmes d’exploitation de type Unix.
Voir Gestion des fichiers pour plus de détails.
\nFIRST_DAY_OF_WEEKLien vers cette rubrique#Valeur par défaut : 0 (dimanche)
Un nombre représentant le premier jour de la semaine. C’est particulièrement utile lors de l’affichage d’un calendrier. Cette valeur n’est utilisée que si les formats internationaux ne sont pas en vigueur ou si un format n’est pas trouvé pour la langue actuelle.
\nLa valeur est un entier de 0 à 6, où 0 signifie dimanche, 1 signifie lundi, etc.
\nFIXTURE_DIRSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Liste de répertoires dans lesquels des fichiers de fixtures sont recherchés, en plus de répertoire fixtures de chaque application, dans l’ordre de recherche.
Notez que ces chemins doivent utiliser les barres obliques de style Unix, même avec Windows.
\nVoir Données initiales par les instantanés et Chargement des instantanés.
\nFORCE_SCRIPT_NAMELien vers cette rubrique#Valeur par défaut : None
Si différent de None, ce réglage est utilisé comme valeur de la variable d’environnement SCRIPT_NAME dans toute requête HTTP. Il peut être utilisé pour surcharger la valeur de SCRIPT_NAME fournie par le serveur, qui peut être une version réécrite de la valeur préférée ou carrément absente. Il est aussi utilisé par django.setup() pour définir le préfixe de script du résolveur d’URL en dehors du cycle requête/réponse (par ex. dans les commandes d’administration et les scripts autonomes) pour générer des URL correctes lorsque SCRIPT_NAME est différent de /.
FORMAT_MODULE_PATHLien vers cette rubrique#Valeur par défaut : None
Un chemin Python complet vers un paquet Python contenant des définitions de formats pour les locales du projet. Si différent de None, Django cherche un fichier formats.py dans le répertoire dont le nom correspond à la locale en cours et utilise les formats définis dans ce fichier.
Par exemple, si FORMAT_MODULE_PATH est défini à mysite.formats et que la langue actuelle est en (anglais), Django s’attend à une arborescence de répertoires comme celle-ci :
mysite/\n formats/\n __init__.py\n en/\n __init__.py\n formats.py\nVous pouvez aussi définir ce réglage à une liste de chemins Python, par exemple :
\nFORMAT_MODULE_PATH = [\n 'mysite.formats',\n 'some_app.formats',\n]\nLorsque Django recherche un certain format, il va parcourir tous les chemins Python indiqués jusqu’à ce qu’il trouve un module qui définit réellement le format recherché. Cela signifie que les formats définis dans les premiers paquets de la liste ont la priorité sur les formats des paquets suivants.
\nLes formats disponibles sont DATE_FORMAT, TIME_FORMAT, DATETIME_FORMAT, YEAR_MONTH_FORMAT, MONTH_DAY_FORMAT, SHORT_DATE_FORMAT, SHORT_DATETIME_FORMAT, FIRST_DAY_OF_WEEK, DECIMAL_SEPARATOR, THOUSAND_SEPARATOR et NUMBER_GROUPING.
IGNORABLE_404_URLSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Liste d’objets expressions régulières compilées décrivant les URL qui doivent être ignorées lors du signalement des erreurs HTTP 404 par courriel (voir Signalement d’erreurs). Les expressions régulières sont comparées aux chemins complets des requêtes (y compris la chaîne de requête, le cas échéant). Ceci est utile si votre site ne fournit pas certains fichiers fréquemment demandés comme favicon.ico ou robots.txt, ou s’il est bombardé par des scripts malveillants.
Ce n’est utilisé que si BrokenLinkEmailsMiddleware est activé (voir Intergiciels (« Middleware »)).
INSTALLED_APPSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Une liste de chaînes désignant toutes les applications activées dans cette installation de Django. Chaque chaîne doit correspondre à un chemin pointé Python vers :
\nune classe de configuration d’application (de préférence), ou
un paquet contenant une application.
En savoir plus sur les configurations d’applications.
\n\n\nLorsque plusieurs applications fournissent différentes versions de la même ressource (gabarit, fichier statique, commande d’administration, traduction), l’application apparaissant en premier dans INSTALLED_APPS a la priorité.
INTERNAL_IPSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Une liste d’adresses IP, sous forme de chaînes, dont les requêtes :
\nPermettent au processeur de contexte debug() d’ajouter quelques variables au contexte du gabarit.
Peuvent utiliser les signets dynamiques de admindocs même si l’utilisateur n’est pas connecté en tant qu’administrateur (staff).
Sont marquées comme « internes » (et non pas « EXTERNAL ») dans les courriels envoyés par AdminEmailHandler.
LANGUAGE_CODELien vers cette rubrique#Valeur par défaut : 'en-us'
Une chaîne représentant le code de langue de cette installation. Elle doit respecter le format de langue standard. Par exemple, l’anglais américain est "en-us". Voir aussi la liste des identifiants de langue et Internationalisation et régionalisation.
USE_I18N doit être activé pour que ce réglage ait un effet.
Ce réglage sert à deux fins :
\nSi l’intergiciel de localisation n’est pas actif, il décide quelle traduction est utilisée pour tous les utilisateurs.
Si l’intergiciel de localisation est actif, il fournit une langue par défaut dans le cas où la langue préférée de l’utilisateur ne peut être déterminée ou n’est pas prise en charge par le site Web. Il fournit également la traduction par défaut lorsqu’une traduction d’une chaîne donnée n’existe pas dans la langue préférée de l’utilisateur.
Voir Processus de découverte de la préférence de langue par Django pour plus de détails.
\nLANGUAGESLien vers cette rubrique#Valeur par défaut : une liste des langues disponibles. Cette liste augmentant continuellement, nous évitons de la reproduire ici, car elle deviendrait vite obsolète. Vous pouvez consultez la liste des langues disposant d’une traduction en examinant le fichier django/conf/global_settings.py (ou en consultant la source en ligne).
La liste est formée de listes binaires dans le format (code de langue, nom_de_langue), par exemple ('ja', 'Japanese'). Cette liste définit les langues disponibles dans la sélection de langues. Voir Internationalisation et régionalisation.
Généralement, la valeur par défaut convient bien. Ne définissez ce réglage que si vous souhaitez restreindre la sélection de langues à un sous-ensemble des langues fournies par Django.
\nSi vous personnalisez le réglage LANGUAGES, vous pouvez marquer les noms des langues en tant que chaînes à traduire en utilisant la fonction ugettext_lazy().
Voici un exemple de fichier de réglages :
\nfrom django.utils.translation import ugettext_lazy as _\n\nLANGUAGES = [\n ('de', _('German')),\n ('en', _('English')),\n]\nLOCALE_PATHSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Une liste de répertoires dans lesquels Django cherche les fichiers de traduction. Voir Processus de découverte des traductions par Django.
\nExemple :
\nLOCALE_PATHS = [\n '/home/www/project/common_files/locale',\n '/var/local/translations/locale',\n]\nDjango cherche dans chacun de ces chemins des répertoires <code_locale>/LC_MESSAGES contenant eux-mêmes les fichiers de traduction réels.
LOGGINGLien vers cette rubrique#Valeur par défaut : un dictionnaire de configuration de la journalisation.
\nUne structure de données contenant les informations de configuration. Le contenu de cette structure de données est transmis comme paramètre à la méthode de configuration indiquée par LOGGING_CONFIG.
Entre autres choses, la configuration par défaut de la journalisation transmet les erreurs de serveur HTTP 500 à un gestionnaire de journal de type courriel lorsque DEBUG vaut False. Voir aussi Configuration de la journalisation.
Vous pouvez voir la configuration par défaut de journalisation en regardant dans django/utils/log.py (ou en affichant le code source en ligne).
LOGGING_CONFIGLien vers cette rubrique#Valeur par défaut : 'logging.config.dictConfig'
Un chemin vers un exécutable qui sera utilisé pour configurer la journalisation du projet Django. Par défaut, il contient une instance de la méthode de configuration dictConfig de Python.
\nSi vous définissez LOGGING_CONFIG à None, le processus de configuration de la journalisation sera court-circuité.
MANAGERSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Une liste dans le même format que ADMINS qui détermine qui doit recevoir les notifications de liens brisés lorsque BrokenLinkEmailsMiddleware est activé.
MEDIA_ROOTLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
Chemin absolu de système de fichiers pointant vers le répertoire qui contiendra les fichiers téléversés par les utilisateurs.
\nExemple : "/var/www/example.com/media/"
Voir aussi MEDIA_URL.
MEDIA_URLLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
URL qui gère les fichiers médias servis à partir de MEDIA_ROOT, utilisée pour la gestion des fichiers stockés. Elle doit se terminer par une barre oblique si elle ne contient pas de valeur vide. Il sera nécessaire de configurer ces fichiers afin d’être servis aussi bien en environnement de développement que de production.
Si vous souhaitez utiliser {{ MEDIA_URL }} dans vos gabarits, ajoutez 'django.template.context_processors.media' dans l’option 'context_processors' de TEMPLATES.
Exemple : "http://media.example.com/"
MIDDLEWARELien vers cette rubrique#Valeur par défaut :: None
Une liste d’intergiciels à utiliser. Voir Intergiciels (« Middleware »).
\nMIDDLEWARE_CLASSESLien vers cette rubrique#Valeur par défaut :
\n[\n 'django.middleware.common.CommonMiddleware',\n 'django.middleware.csrf.CsrfViewMiddleware',\n]\nUne liste de classes d’intergiciel à utiliser. Il s’agissait du réglage par défaut jusqu’à Django 1.9. Django 1.10 a introduit un nouveau style d’intergiciels. Si un de vos anciens projets utilise ce réglage, vous devriez mettre à jour les intergiciels que vous avez vous-même écrits d’après le nouveau style, puis utiliser le réglage MIDDLEWARE.
MIGRATION_MODULESLien vers cette rubrique#Valeur par défaut : {} (dictionnaire vide)
Un dictionnaire indiquant le paquet où les modules de migration peuvent être trouvés pour chaque application. La valeur par défaut de ce réglage est un dictionnaire vide, mais le nom de paquet par défaut pour les modules de migration est migrations.
Exemple :
\n{'blog': 'blog.db_migrations'}\nDans ce cas, les migrations concernant l’application blog seront contenues dans le paquet blog.db_migrations.
Si vous fournissez le paramètre app_label, makemigrations crée automatiquement le paquet s’il n’existe pas déjà.
Lorsque vous fournissez None comme valeur pour une application, Django considère l’application comme sans migrations, sans prendre en compte un éventuel sous-module migrations existant. Ceci peut être utilisé, par exemple, dans un fichier de règlages de test pour sauter les migrations durant les tests (les tables seront quand même créées pour les modèles des applications). Si cela est utilisé dans les réglages généraux du projet, pensez à utiliser l’option migrate --run-syncdb si vous souhaitez créer les tables de l’application.
MONTH_DAY_FORMATLien vers cette rubrique#Valeur par défaut : 'F j'
Le format par défaut à utiliser pour les champs date dans les listes pour modifications des pages de l’administration de Django, et potentiellement dans d’autres parties du système, dans les cas où seuls le mois et le jour sont affichés.
\nPar exemple, lorsqu’une page de liste pour modification de l’administration de Django est filtrée par un choix de date, l’en-tête d’un jour donné affiche le jour et le mois. Différentes locales présentent différents formats. Par exemple, l’anglais américain affichera « January 1, » alors que l’espagnol affichera « 1 Enero. ».
\nNotez que lorsque USE_L10N vaut True, le format piloté par la locale qui correspond a une priorité plus élevée et remplace ce séparateur.
Voir chaînes de format de date autorisées. Voir aussi DATE_FORMAT, DATETIME_FORMAT, TIME_FORMAT et YEAR_MONTH_FORMAT.
NUMBER_GROUPINGLien vers cette rubrique#Valeur par défaut : 0
Nombre de chiffres groupés dans la partie entière d’un nombre.
\nL’utilisation habituelle est d’afficher un séparateur de milliers. Si ce réglage est à 0, aucun groupement n’est effectué. S’il est plus grand que 0, THOUSAND_SEPARATOR est utilisé comme séparateur entre ces groupes.
Notez que lorsque USE_L10N vaut True, le format piloté par la locale a une priorité plus élevée et remplace ce séparateur.
Voir aussi DECIMAL_SEPARATOR, THOUSAND_SEPARATOR et USE_THOUSAND_SEPARATOR.
PREPEND_WWWLien vers cette rubrique#Valeur par défaut : False
Indique s’il faut préfixer le sous-domaine « www. » aux URL qui ne l’ont pas. Utilisé seulement si CommonMiddleware est installé (voir Intergiciels (« Middleware »)). Voir aussi APPEND_SLASH.
ROOT_URLCONFLien vers cette rubrique#Valeur par défaut : non définie
\nUne chaîne représentant le chemin d’importation Python complet vers votre URLconf racine. Par exemple : "mesapplisdjango.urls". Il peut être surchargé pour chaque requête en définissant l’attribut urlconf de l’objet HttpRequest entrant. Voir Processus de traitement des requêtes par Django pour plus de détails.
SECRET_KEYLien vers cette rubrique#Valeur par défaut : '' (Chaîne vide)
La clé secrète d’une installation Django. Elle est utilisée dans le contexte de la signature cryptographique, et doit être définie à une valeur unique et non prédictible.
\ndjango-admin startproject ajoute automatiquement une valeur SECRET_KEY générée aléatoirement dans chaque nouveau projet.
L’emploi de cette clé ne devrait pas présupposer qu’il s’agit de texte ou d’octets. Chaque utilisation devrait faire appel à force_text() ou force_bytes() pour la convertir dans le type souhaité.
Django refuse de démarrer si SECRET_KEY n’est pas défini.
La clé secrète est utilisée pour :
\nToutes les sessions si vous utilisez un autre moteur de sessions que django.contrib.sessions.backends.cache ou que vous utilisez la méthode get_session_auth_hash() par défaut.
Tous les messages si vous utilisez les moteurs de stockage CookieStorage ou FallbackStorage.
Tous les jetons de password_reset().
Tout emploi de la signature cryptographique, sauf si une clé différente est fournie.
Lorsque la clé secrète est modifiée, tous les éléments ci-dessus sont invalidés. Les clés secrètes ne sont pas utilisées pour les mots de passe des utilisateurs ; ceux-ci ne sont pas touchés par un changement de clé.
\n\nSECURE_BROWSER_XSS_FILTERLien vers cette rubrique#Valeur par défaut : False
Si True, l’intergiciel SecurityMiddleware définit l’en-tête X-XSS-Protection: 1; mode=block pour toutes les réponses qui ne l’ont pas déjà.
SECURE_CONTENT_TYPE_NOSNIFFLien vers cette rubrique#Valeur par défaut : False
Si True, l’intergiciel SecurityMiddleware définit l’en-tête X-Content-Type-Options: nosniff pour toutes les réponses qui ne l’ont pas déjà.
SECURE_HSTS_INCLUDE_SUBDOMAINSLien vers cette rubrique#Valeur par défaut : False
Si True, l’intergiciel SecurityMiddleware ajoute la directive includeSubDomains à l’en-tête Sécurité de transport HTTP stricte (HSTS). Il n’a pas d’effet tant que SECURE_HSTS_SECONDS ne contient pas une valeur différente de zéro.
SECURE_HSTS_SECONDSLien vers cette rubrique#Valeur par défaut : 0
Si défini à un nombre entier autre que 0, l’intergiciel SecurityMiddleware définit l’en-tête Sécurité de transport HTTP stricte (HSTS) pour toutes les réponses qui ne l’ont pas déjà.
SECURE_PROXY_SSL_HEADERLien vers cette rubrique#Valeur par défaut : None
Un tuple représentant une combinaison en-tête/valeur HTTP signifiant qu’une requête est sécurisée. Ce réglage contrôle le comportement de la méthode is_secure() de l’objet requête.
Cela demande quelques explications. Par défaut, is_secure() est capable de déterminer si une requête est sécurisée en inspectant le protocole de l’URL demandée (« https:// »). C’est important pour la protection CSRF de Django et peut être utilisé par votre propre code ou des applications tierces.
Si votre application Django est derrière un serveur mandataire (proxy), celui-ci peut masquer le fait que la requête est en HTTPS en utilisant une connexion non HTTPS entre le serveur mandataire et Django. Dans ce cas, is_secure() renvoie toujours False, même pour les requêtes qui ont été initiées en HTTPS par l’utilisateur final.
Dans cette situation, il est alors possible de configurer le serveur mandataire pour qu’il définisse un en-tête HTTP indiquant à Django si la requête est arrivée en HTTPS ; le réglage SECURE_PROXY_SSL_HEADER permet de signaler à Django le nom de l’en-tête où il doit chercher cette information.
Il est nécessaire de définir un tuple contenant deux éléments : le nom de l’en-tête à examiner et la valeur requise. Par exemple :
\nSECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')\nIci, nous disons à Django que nous nous fions à l’en-tête X-Forwarded-Proto ajouté par le serveur mandataire et indiquant par une valeur 'https' que la requête provenait bien d’une connexion sécurisée (c’est-à-dire qu’elle est arrivée par HTTPS). Évidemment, ce réglage ne doit être défini qu’à la condition que vous soyez maître du serveur mandataire ou que vous ayez la garantie que l’en-tête soit ajouté ou enlevé de manière appropriée.
Notez que le nom de l’en-tête doit être dans le format utilisé par request.META, tout en majuscules et commençant probablement par HTTP_ (souvenez-vous que Django ajoute automatiquement 'HTTP_' au début des noms d’en-têtes X avant de les rendre accessibles dans request.META).
SECURE_REDIRECT_EXEMPTLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Si un chemin d’URL correspond à une expression régulière de cette liste, la requête ne sera pas redirigée vers HTTPS. Si SECURE_SSL_REDIRECT vaut False, ce réglage n’a pas d’effet.
SECURE_SSL_HOSTLien vers cette rubrique#Valeur par défaut : None
Si défini à une chaîne (par ex. secure.example.com), toutes les redirections SSL seront redirigées vers cet hôte au lieu de l’hôte d’origine (par ex. www.example.com). Si SECURE_SSL_REDIRECT vaut False, ce réglage n’as pas d’effet.
SECURE_SSL_REDIRECTLien vers cette rubrique#Valeur par défaut : False
Si True, SecurityMiddleware redirige toutes les requêtes non HTTPS vers HTTPS (sauf pour les URL correspondant à une expression régulière figurant dans SECURE_REDIRECT_EXEMPT).
SERIALIZATION_MODULESLien vers cette rubrique#Valeur par défaut : non définie
\nUn dictionnaire de modules contenant des définitions de sérialiseurs (sous forme de chaînes) dont les clés sont des identifiants textuels pour le type de sérialisation correspondant. Par exemple, pour définir un sérialiseur YAML :
\nSERIALIZATION_MODULES = {'yaml': 'path.to.yaml_serializer'}\nSERVER_EMAILLien vers cette rubrique#Valeur par défaut : 'root@localhost'
L’adresse électronique utilisée comme expéditeur des messages d’erreur, comme ceux envoyés aux ADMINS et aux MANAGERS.
SHORT_DATE_FORMATLien vers cette rubrique#Valeur par défaut : 'm/d/Y' (ex . : 12/31/2003)
Un format disponible pour l’affichage des champs dates dans les gabarits. Notez que si USE_L10N est défini à True, le format piloté par la locale a une priorité plus élevée et remplacera ce format. Voir les chaînes de format de date autorisées.
Voir aussi DATE_FORMAT et SHORT_DATETIME_FORMAT.
SHORT_DATETIME_FORMATLien vers cette rubrique#Valeur par défaut : 'm/d/Y P' (ex . : 12/31/2003 4 p.m.)
Un format disponible pour l’affichage des champs dates/heures dans les gabarits. Notez que si USE_L10N est défini à True, le format piloté par la locale a une priorité plus élevée et remplacera ce format. Voir les chaînes de format de date autorisées.
Voir aussi DATE_FORMAT et SHORT_DATE_FORMAT.
SIGNING_BACKENDLien vers cette rubrique#Valeur par défaut : 'django.core.signing.TimestampSigner'
Le moteur utilisé pour signer les cookies et d’autres données.
\nVoir aussi la documentation sur Signatures cryptographiques.
\nSILENCED_SYSTEM_CHECKSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Une liste d’identifiants de messages générés par l’infrastructure de contrôle système (par ex: ["models.W001"]) que vous souhaitez ignorer de manière permanente. Les contrôles ainsi masqués n’apparaissent plus dans la console.
Voir aussi la documentation Infrastructure de contrôle système.
\nTEMPLATESLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Une liste contenant les réglages de tous les moteurs de gabarit à utiliser avec Django. Chaque élément de la liste est un dictionnaire contenant les options de chacun des moteurs.
\nVoici une configuration simple qui indique au moteur de gabarit de Django de charger les gabarits à partir du sous-répertoire templates de chaque application installée :
TEMPLATES = [\n {\n 'BACKEND': 'django.template.backends.django.DjangoTemplates',\n 'APP_DIRS': True,\n },\n]\nLes options suivantes sont disponibles pour tous les moteurs.
\nBACKENDLien vers cette rubrique#Valeur par défaut : non définie
\nLe moteur de gabarit à utiliser. Les moteurs de gabarit intégrés à Django sont :
\n'django.template.backends.django.DjangoTemplates'
'django.template.backends.jinja2.Jinja2'
Vous pouvez utiliser un moteur de gabarit non livré avec Django en définissant BACKEND à un chemin complètement qualifié (par ex. monpaquet.moteurs.Backend).
NAMELien vers cette rubrique#Valeur par défaut :: voir ci-dessous
\nL’alias de ce moteur de gabarit particulier. Il s’agit d’un identifiant qui permet de choisir un moteur pour le processus de rendu. Les alias doivent être uniques parmi tous les moteurs de gabarit configurés.
\nSa valeur par défaut contient le nom du module définissant la classe du moteur, c’est-à-dire l’avant-dernier élément de BACKEND, lorsque celui-ci est présent. Par exemple, si le moteur est 'mypackage.whatever.Backend', le nom par défaut vaut 'whatever'.
DIRSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Répertoires dans lesquels le moteur recherche des fichiers sources de gabarits, dans l’ordre de leur recherche.
\nAPP_DIRSLien vers cette rubrique#Valeur par défaut : False
Indique si le moteur recherche des fichiers sources de gabarits dans les applications installées.
\n\nOPTIONSLien vers cette rubrique#Valeur par défaut : {} (dictionnaire vide)
Paramètres supplémentaires à passer au moteur de gabarit. Les paramètres disponibles varient en fonction du moteur. Voir DjangoTemplates et Jinja2 pour les options des moteurs intégrés.
TEST_RUNNERLien vers cette rubrique#Par défaut : django.test.runner.DiscoverRunner
Le nom de la classe à utiliser pour lancer la suite de tests. Voir Utilisation d’autres infrastructures de test.
\nTEST_NON_SERIALIZED_APPSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Afin de pouvoir restaurer l’état de la base de données entre les tests pour les classes TransactionTestCase et les moteurs de base de données non transactionnels, Django ref:sérialise le contenu de toutes les applications <test-case-serialized-rollback> lorsqu’il lance la suite de tests pour pouvoir ensuite recharger ces données copiées avant de lancer les tests qui ont en besoin.
Cela ralentit le démarrage du lanceur de tests ; si vous savez que certaines applications n’ont pas besoin de cette fonctionnalité, vous pouvez ajouter leur nom complet dans ce réglage (par ex. 'django.contrib.contenttypes') pour les exclure du processus de sérialisation.
THOUSAND_SEPARATORLien vers cette rubrique#Valeur par défaut : ',' (virgule)
Séparateur de milliers utilisé par défaut lors de la mise en forme de nombres. Ce réglage n’est utilisé que lorsque USE_THOUSAND_SEPARATOR vaut True et que NUMBER_GROUPING est plus grand que 0.
Notez que lorsque USE_L10N vaut True, le format piloté par la locale a une priorité plus élevée et remplace ce séparateur.
Voir aussi NUMBER_GROUPING, DECIMAL_SEPARATOR et USE_THOUSAND_SEPARATOR.
TIME_FORMATLien vers cette rubrique#Valeur par défaut : 'P'` (ex . : ``4 p.m.)
Le format par défaut pour l’affichage des champs heures dans les différentes parties du système. Notez que si USE_L10N est défini à True, le format piloté par la locale a une priorité plus élevée et remplacera ce format. Voir les chaînes de format de date autorisées.
Voir aussi DATE_FORMAT et DATETIME_FORMAT.
TIME_INPUT_FORMATSLien vers cette rubrique#Valeur par défaut :
\n[\n '%H:%M:%S', # '14:30:59'\n '%H:%M:%S.%f', # '14:30:59.000200'\n '%H:%M', # '14:30'\n]\nUne liste de formats qui seront acceptés lors de la saisie de données dans un champ heure. Les formats seront testés dans l’ordre et le premier correspondant sera utilisé. Notez que ces chaînes de format utilisent la syntaxe du module datetime de Python, et non pas celle des chaînes de format du filtre de gabarit date.
Lorsque USE_L10N vaut True, le format piloté par la locale a une priorité plus élevée et remplace ce format.
Voir aussi DATE_INPUT_FORMATS et DATETIME_INPUT_FORMATS.
TIME_ZONELien vers cette rubrique#Valeur par défaut : 'America/Chicago'
Une chaîne représentant le fuseau horaire pour cette installation, ou None. Voir la liste des fuseaux horaires.
Notez que cela ne correspond pas forcément au fuseau horaire du serveur. Par exemple, il est imaginable qu’un site serve plusieurs instances de sites Django, chacun ayant leur propre réglage de fuseau horaire.
\nLorsque USE_TZ est défini à False, ce réglage définit le fuseau horaire avec lequel Django stocke tous les objets dates/heures. Lorsque USE_TZ est défini à True, il s’agit alors du fuseau horaire que Django utilise par défaut pour afficher les dates/heures dans les gabarits et pour interpréter les valeurs dates/heures saisies dans les formulaires.
Django définit la variable os.environ['TZ'] au fuseau horaire défini dans le réglage TIME_ZONE. Ainsi, toutes les vues et tous les modèles opèrent automatiquement dans ce fuseau horaire. Cependant, Django ne définit pas la variable d’environnement TZ dans les conditions suivantes :
si vous utilisez l’option de configuration manuelle telle que décrite dans configuration manuelle des réglages, ou
si vous indiquez TIME_ZONE = None. Django se synchronise alors sur le fuseau horaire du système. Toutefois, nous décourageons ce cas de figure lorsque USE_TZ = True, parce qu’il fragilise les conversions entre le temps local et le temps UTC.
Quand Django ne définit pas la variable d’environnement TZ, il est de votre responsabilité de contrôler que les processus fonctionnent dans un environnement correct.
USE_I18NLien vers cette rubrique#Valeur par défaut : True
Une valeur booléenne indiquant si le système de traduction de Django doit être activé. C’est un moyen rapide de le désactiver pour gagner un peu de performances. Si défini à False, Django optimise son fonctionnement pour ne pas charger le mécanisme de traduction.
Voir aussi LANGUAGE_CODE, USE_L10N et USE_TZ.
USE_L10NLien vers cette rubrique#Valeur par défaut : False
Une valeur booléenne indiquant si la régionalisation du format des données est activée. Si défini à True, Django affiche par exemple les nombres et les dates en utilisant la mise en forme correspondant à la locale active.
Voir aussi LANGUAGE_CODE, USE_I18N et USE_TZ.
USE_THOUSAND_SEPARATORLien vers cette rubrique#Valeur par défaut : False
Une valeur booléenne indiquant si les nombres doivent être affichés avec des séparateurs de milliers. Lorsque USE_L10N est défini à True et que ce réglage l’est également, Django utilise les valeurs de THOUSAND_SEPARATOR et de NUMBER_GROUPING pour mettre en forme les nombres, sauf si la locale possède déjà une définition du séparateur de milliers. Dans ce dernier cas, ce séparateur a la priorité et sera utilisé plutôt que le réglage général.
Voir aussi DECIMAL_SEPARATOR, NUMBER_GROUPING et THOUSAND_SEPARATOR.
USE_TZLien vers cette rubrique#Valeur par défaut : False
Une valeur booléenne indiquant si les dates/heures sont conscientes de leur fuseau horaire. Si défini à True, Django utilise en interne des dates/heures conscientes de leur fuseau horaire. Sinon, Django utilise des dates/heures naïves en temps local.
USE_X_FORWARDED_HOSTLien vers cette rubrique#Valeur par défaut : False
Une valeur booléenne indiquant si l’en-tête X-Forwarded-Host doit être favorisé aux dépends de l’en-tête Host. Ceci ne devrait être activé que dans le cas où un serveur mandataire définit cet en-tête en amont de votre application.
Ce réglage a la priorité sur USE_X_FORWARDED_PORT. Selon la RFC 7239 Page 7, l’en-tête X-Forwarded-Host peut inclure le numéro de port, auquel cas il ne faudrait pas utiliser USE_X_FORWARDED_PORT.
USE_X_FORWARDED_PORTLien vers cette rubrique#Valeur par défaut : False
Une valeur booléenne indiquant si l’en-tête X-Forwarded-Port doit être favorisé aux dépends de la variable META SERVER_PORT. Ceci ne devrait être activé que dans le cas où un serveur mandataire définit cet en-tête en amont de votre application.
USE_X_FORWARDED_HOST a la priorité sur ce réglage.
WSGI_APPLICATIONLien vers cette rubrique#Valeur par défaut : None
Le chemin Python complet de l’objet application WSGI que les serveurs intégrés dans Django vont utiliser (par ex. runserver). La commande de gestion django-admin startproject crée un simple fichier wsgi.py contenant un exécutable application et fait pointer ce réglage vers cet objet application.
Si indéfini, c’est la valeur renvoyée par django.core.wsgi.get_wsgi_application() qui sera utilisée. Dans ce cas, le comportement de runserver sera le même que lors des versions précédentes de Django.
YEAR_MONTH_FORMATLien vers cette rubrique#Valeur par défaut : 'F Y'
Le format par défaut à utiliser pour les champs date dans les listes pour modifications des pages de l’administration de Django, et potentiellement dans d’autres parties du système, dans les cas où seuls l’année et le mois sont affichés.
\nPar exemple, lorsqu’une page de liste pour modification de l’administration de Django est filtrée par un choix de date, l’en-tête d’un mois donné affiche le mois et l’année. Différentes locales présentent différents formats. Par exemple, l’anglais américain affichera « January 2006, » alors qu’une autre locale affichera peut-être « 2006/January. ».
\nNotez que lorsque USE_L10N vaut True, le format piloté par la locale qui correspond a une priorité plus élevée et remplace ce séparateur.
Voir chaînes de format de date autorisées. Voir aussi DATE_FORMAT, DATETIME_FORMAT, TIME_FORMAT et MONTH_DAY_FORMAT.
X_FRAME_OPTIONSLien vers cette rubrique#Valeur par défaut : 'SAMEORIGIN'
La valeur par défaut de l’en-tête X-Frame-Options utilisé par XFrameOptionsMiddleware. Voir la documentation sur la protection contre le détournement de clic.
Réglages pour django.contrib.auth.
AUTHENTICATION_BACKENDSLien vers cette rubrique#Valeur par défaut : ['django.contrib.auth.backends.ModelBackend']
Une liste de classes de moteurs d’authentification (sous forme de chaînes) à utiliser durant la tentative d’authentification d’un utilisateur. Consultez la documentation sur les moteurs d’authentification pour plus de détails.
\nAUTH_USER_MODELLien vers cette rubrique#Valeur par défaut : 'auth.User'
Le modèle à utiliser pour représenter un utilisateur. Voir Substitution par un modèle User personnalisé.
\n\nLOGIN_REDIRECT_URLLien vers cette rubrique#Valeur par défaut : '/accounts/profile/'
L’URL vers laquelle seront redirigées les requêtes après un processus de connexion lorsque la vue contrib.auth.login ne reçoit pas de paramètre next .
C’est utilisé par exemple par le décorateur login_required().
Ce réglage accepte aussi des motifs d’URL nommés qui peuvent être utilisés pour réduire les doublons de configuration étant donné qu’il n’est pas nécessaire de définir les URL à deux endroits (settings et configuration d’URL).
LOGIN_URLLien vers cette rubrique#Valeur par défaut : '/accounts/login/'
L’URL vers laquelle sont redirigées les requêtes pour un processus de connexion, plus particulièrement lors de l’utilisation du décorateur login_required().
Ce réglage accepte aussi des motifs d’URL nommés qui peuvent être utilisés pour réduire les doublons de configuration étant donné qu’il n’est pas nécessaire de définir les URL à deux endroits (settings et configuration d’URL).
LOGOUT_REDIRECT_URLLien vers cette rubrique#Valeur par défaut : None
L’URL vers laquelle seront redirigées les requêtes après la déconnexion d’un utilisateur par la vue logout() (si la vue ne reçoit pas de paramètre next_page).
Avec None, aucune redirection n’est effectuée et la vue de déconnexion logout sera produite.
Ce réglage accepte aussi des motifs d’URL nommés qui peuvent être utilisés pour réduire les doublons de configuration étant donné qu’il n’est pas nécessaire de définir les URL à deux endroits (settings et configuration d’URL).
PASSWORD_RESET_TIMEOUT_DAYSLien vers cette rubrique#Valeur par défaut : 3
Le nombre de jours de validité d’un lien de réinitialisation de mot de passe. Utilisé par le mécanisme de réinitialisation de mot de passe de django.contrib.auth.
PASSWORD_HASHERSLien vers cette rubrique#Voir Stockage des mots de passe par Django.
\nValeur par défaut :
\n[\n 'django.contrib.auth.hashers.PBKDF2PasswordHasher',\n 'django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher',\n 'django.contrib.auth.hashers.Argon2PasswordHasher',\n 'django.contrib.auth.hashers.BCryptSHA256PasswordHasher',\n 'django.contrib.auth.hashers.BCryptPasswordHasher',\n]\nAUTH_PASSWORD_VALIDATORSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
La liste des validateurs utilisés pour vérifier la solidité des mots de passe des utilisateurs. Voir Validation des mots de passe pour plus de détails. Par défaut, aucune validation n’est effectuée et tous les mots de passe sont acceptés.
\nRéglages pour django.contrib.messages.
MESSAGE_LEVELLien vers cette rubrique#Valeur par défaut : messages.INFO
Définit le niveau minimum des messages qui seront traités par le système des messages. Voir les niveaux de message pour plus de détails.
\n\nMESSAGE_STORAGELien vers cette rubrique#Valeur par défaut : 'django.contrib.messages.storage.fallback.FallbackStorage'
Contrôle l’emplacement de stockage des données de messages. Les valeurs possibles sont :
\n'django.contrib.messages.storage.fallback.FallbackStorage'
'django.contrib.messages.storage.session.SessionStorage'
'django.contrib.messages.storage.cookie.CookieStorage'
Voir les moteurs de stockage de messages pour plus de détails.
\nLes moteurs qui utilisent des cookies – CookieStorage et FallbackStorage – utilisent les valeurs de SESSION_COOKIE_DOMAIN, SESSION_COOKIE_SECURE et SESSION_COOKIE_HTTPONLY lors de la définition de leurs cookies.
Réglages pour django.contrib.sessions.
SESSION_CACHE_ALIASLien vers cette rubrique#Valeur par défaut : 'default'
Si vous utilisez le stockage des sessions basé en cache, ce réglage choisit le cache à utiliser.
\nSESSION_ENGINELien vers cette rubrique#Valeur par défaut : 'django.contrib.sessions.backends.db'
Contrôle l’emplacement de stockage des données de sessions. Les moteurs inclus sont :
\n'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'
Voir Configuration du moteur de sessions pour plus de détails.
\nSESSION_EXPIRE_AT_BROWSER_CLOSELien vers cette rubrique#Valeur par défaut : False
Indique s’il faut que la session expire lorsque l’utilisateur ferme son navigateur. Voir Expiration ou persistance des sessions.
\nSESSION_FILE_PATHLien vers cette rubrique#Valeur par défaut : None
Si vous utilisez le stockage de sessions basé sur des fichiers, cela définit le répertoire dans lequel Django stocke les données de sessions. Avec la valeur par défaut (None), Django utilise le répertoire temporaire standard du système.
SESSION_SAVE_EVERY_REQUESTLien vers cette rubrique#Valeur par défaut : False
Indique si les données de sessions sont enregistrées lors de chaque requête. Avec la valeur False (par défaut), Django n’enregistre la session dans la base de données qu’au moment où la session a été modifiée, c’est-à-dire qu’au moins une des valeurs de son dictionnaire a été définie ou supprimée. Les sessions vides ne seront pas créées, même si ce réglage est activé.
SESSION_SERIALIZERLien vers cette rubrique#Par défaut : 'django.contrib.sessions.serializers.JSONSerializer'
Chemin d’importation complet d’une classe de sérialisation à utiliser pour la sérialisation des données de session. Les sérialiseurs inclus sont :
\n'django.contrib.sessions.serializers.PickleSerializer'
'django.contrib.sessions.serializers.JSONSerializer'
Voir Sérialisation des sessions pour plus de détails, y compris un avertissement concernant une éventuelle exécution de code à distance lors de l’utilisation de PickleSerializer.
Réglages pour django.contrib.sites.
SITE_IDLien vers cette rubrique#Valeur par défaut : non définie
\nL’identifiant (nombre entier) du site actuel dans la table de base de données django_site. Peut être utilisé par les applications pour lier leurs données à des sites spécifiques et ainsi gérer dans une même base de données du contenu pour plusieurs sites.
Réglages pour django.contrib.staticfiles.
STATIC_ROOTLien vers cette rubrique#Valeur par défaut : None
Le chemin absolu vers le répertoire dans lequel collectstatic rassemble les fichiers statiques en vue du déploiement.
Exemple : "/var/www/example.com/static/"
Si l’application complémentaire staticfiles est activée (c’est le cas dans le modèle de projet par défaut), la commande d’administration collectstatic rassemble les fichiers statiques dans ce répertoire. Consultez le guide pratique sur la gestion des fichiers statiques pour plus de détails sur son utilisation.
STATIC_URLLien vers cette rubrique#Valeur par défaut : None
URL utilisée pour se référer aux fichiers statiques se trouvant dans STATIC_ROOT.
Exemple : "/static/" ou "http://static.example.com/"
Si ce réglage ne vaut pas None, il est utilisé comme chemin de base pour les définitions de fichiers annexes (la classe Media) et l”application staticfiles.
Cette valeur doit se terminer par une barre oblique quand elle est définie.
\nVous devrez peut-être configurer ces fichiers pour être servis en développement et aurez sans aucun doute besoin de le faire en production.
\nSTATICFILES_DIRSLien vers cette rubrique#Valeur par défaut : [] (liste vide)
Ce réglage définit les emplacements supplémentaires que l’application staticfiles parcourt si la recherche par FileSystemFinder est activée, par exemple quand vous utilisez la commande de gestion collectstatic ou findstatic, ou quand vous utilisez la vue de service de fichiers statiques.
Il devrait contenir une liste de chaînes contenant les chemins complets vers les répertoires de fichiers supplémentaires ; par exemple :
\nSTATICFILES_DIRS = [\n "/home/special.polls.com/polls/static",\n "/home/polls.com/polls/static",\n "/opt/webfiles/common",\n]\nNotez que ces chemins doivent utiliser des barres obliques de type Unix, même sur Windows (par ex. "C:/Users/user/mon_site/contenu_statique_suppl").
Dans le cas où vous souhaiteriez vous référer aux fichiers d’un des emplacements avec un espace de noms supplémentaire, il est possible d’indiquer un préfixe sous la forme de tuples (préfixe, chemin), comme par exemple :
STATICFILES_DIRS = [\n # ...\n ("downloads", "/opt/webfiles/stats"),\n]\nPar exemple, en supposant que STATIC_URL soit défini à /static/, la commande de gestion collectstatic recueillera les fichiers « stats » dans un sous-répertoire 'downloads' de STATIC_ROOT.
Cela permettrait de se référer au fichier local '/opt/webfiles/stats/polls_20101022.tar.gz' par '/static/downloads/polls_20101022.tar.gz' dans les gabarits ; par exemple :
<a href="{% static "downloads/polls_20101022.tar.gz" %}">\nSTATICFILES_STORAGELien vers cette rubrique#Par défaut : django.contrib.staticfiles.storage.StaticFilesStorage
Le moteur de stockage de fichiers à utiliser lors de la collecte des fichiers statiques avec la commande d’administration collectstatic.
Une instance prête à l’emploi du moteur de stockage défini dans ce réglage peut être trouvée dans django.contrib.staticfiles.storage.staticfiles_storage.
Pour un exemple, voir Fichiers statiques sur un service cloud ou un CDN.
\nSTATICFILES_FINDERSLien vers cette rubrique#Valeur par défaut :
\n[\n 'django.contrib.staticfiles.finders.FileSystemFinder',\n 'django.contrib.staticfiles.finders.AppDirectoriesFinder',\n]\nLa liste des moteurs de découverte sachant retrouver les fichiers statiques en divers endroits.
\nLe comportement par défaut recherche les fichiers stockés aux emplacements du réglage STATICFILES_DIRS (en utilisant django.contrib.staticfiles.finders.FileSystemFinder) et dans un sous-répertoire static de chaque application (en utilisant django.contrib.staticfiles.finders.AppDirectoriesFinder). Si plusieurs fichiers de même nom sont présents, le premier fichier trouvé est utilisé.
Un moteur de découverte est désactivé par défaut : django.contrib.staticfiles.finders.DefaultStorageFinder. S’il est ajouté au réglage STATICFILES_FINDERS, il recherche les fichiers statiques dans l’emplacement de stockage des fichiers par défaut tel que défini par le réglage DEFAULT_FILE_STORAGE.
Les moteurs de découverte de fichiers statiques sont actuellement considérés comme une interface privée, ce qui explique que cette interface n’est pas documentée.
\ni18n/l10n)Lien vers cette rubrique#Sécurité
\n\nProtection contre le « Cross site request forgery » (CSRF)
\n\nBase de données : TEST