{"title":"Infrastructure de contrôle système","version":"4.2","locale":"fr","docname":"ref/checks","url":"/fr/4.2/ref/checks/","canonical":"https://djangodocs.dev/fr/4.2/ref/checks/","summary":"L’infrastructure de contrôle système est un ensemble de contrôles statiques pour valider les projets Django. Elle détecte les problèmes courants et fournit des…","html":"

Infrastructure de contrôle systèmeLien vers cette rubrique#

\n

L’infrastructure de contrôle système est un ensemble de contrôles statiques pour valider les projets Django. Elle détecte les problèmes courants et fournit des conseils sur la façon de les corriger. L’infrastructure est extensible de sorte que vous pouvez facilement ajouter vos propres contrôles.

\n

Pour plus de détails sur la façon d’ajouter vos propres contrôles et les intégrer aux contrôles systèmes de Django, consultez le Guide thématique sur la vérification système.

\n
\n

Référence de l’APILien vers cette rubrique#

\n
\n

CheckMessageLien vers cette rubrique#

\n
\n
\nclass CheckMessage(level, msg, hint=None, obj=None, id=None)Lien vers cette définition#
\n
\n\n

Les avertissements et les erreurs signalés par les contrôles systèmes doivent être des instances de CheckMessage. Une instance encapsule une seule erreur à signaler ou un seul avertissement. Elle fournit également des indicateurs et le contexte applicables au message, et un identifiant unique qui est utilisé à des fins de filtrage.

\n

Les arguments du constructeur sont :

\n
\n
level

La gravité du message. Utilisez l’une des valeurs prédéfinies : DEBUG, INFO, WARNING, ERROR, CRITICAL. Si le niveau est supérieur ou égal à ERROR, Django empêchera l’exécution des commandes de gestion. Les messages avec un niveau inférieur à ERROR (i.e. les avertissements) sont présentés dans la console, mais peuvent être réduits au silence.

\n
\n
msg

Une courte chaîne (moins de 80 caractères) décrivant le problème. La chaîne ne doit pas contenir des sauts de ligne.

\n
\n
hint

Une chaîne d’une seule ligne offrant un indicateur pour résoudre le problème. Si aucun indicateur ne peut être fourni, ou s’il est évident à partir du message d’erreur, l’indicateur peut être omis, ou une valeur None peut être utilisée.

\n
\n
obj

Facultatif. Un objet fournissant le contexte du message (par exemple, le modèle où le problème a été découvert). L’objet doit être un modèle, un champ, un gestionnaire ou tout autre objet qui définit la méthode __str__(). La méthode est utilisée lors de la collecte de tous les messages et son résultat précède le message.

\n
\n
id

Chaîne facultative. Un identifiant unique pour le problème. Les identifiants doivent suivre le modèle applabel.X001, où X est l’une des lettres CEWID, indiquant la gravité du message (C pour critique, E pour les erreurs et ainsi de suite). Le numéro peut être attribué par l’application, mais doit être unique au sein de cette application.

\n
\n
\n

Il existe des sous-classes pour faciliter la création des messages avec les niveaux de base. Lorsque vous les utilisez, vous pouvez omettre le paramètre level car il est sous-entendu par le nom de la classe.

\n
\n
\nclass Debug(msg, hint=None, obj=None, id=None)Lien vers cette définition#
\n
\n\n
\n
\nclass Info(msg, hint=None, obj=None, id=None)Lien vers cette définition#
\n
\n\n
\n
\nclass Warning(msg, hint=None obj=None, id=None)Lien vers cette définition#
\n
\n\n
\n
\nclass Error(msg, hint=None, obj=None, id=None)Lien vers cette définition#
\n
\n\n
\n
\nclass Critical(msg, hint=None, obj=None, id=None)Lien vers cette définition#
\n
\n\n
\n
\n
\n

Étiquettes prédéfiniesLien vers cette rubrique#

\n

Les contrôles systèmes de Django sont organisés en utilisant les étiquettes suivantes :

\n\n

Certains contrôles peuvent être enregistrés sous plusieurs étiquettes.

\n
\n
\n

Vérifications systèmes du noyauLien vers cette rubrique#

\n
\n

Gestion du code asynchroneLien vers cette rubrique#

\n

Les contrôles suivants vérifient votre configuration concernant Gestion du code asynchrone:

\n\n
\n
\n

RétrocompatibilitéLien vers cette rubrique#

\n

Les contrôles de compatibilité alertent sur des problèmes potentiels pouvant se produire après une mise à jour de Django.

\n\n
\n
\n

CachesLien vers cette rubrique#

\n

Les contrôles suivants vérifient que le réglage CACHES est configuré correctement :

\n\n
\n
\n

Base de donnéesLien vers cette rubrique#

\n
\n

MySQL et MariaDBLien vers cette rubrique#

\n

Si vous utilisez MySQL ou MariaDB, les contrôles suivants seront effectués :

\n
    \n

  • mysql.E001 : MySQL/MariaDB ne permet pas aux champs CharField uniques d’avoir un attribut max_length > 255. Ce contrôle a été transformé en mysql.W003 dans Django 3.1 car la taille maximale réelle dépend de plusieurs facteurs.

    • \n

  • mysql.W002 : le mode strict de MySQL/MariaDB n’est pas défini pour la connexion de base de données <alias>. Voir aussi Définition de sql_mode.

    • \n

  • mysql.W003 : MySQL/MariaDB pourrait ne pas permettre aux champs CharField uniques d’avoir un attribut max_length > 255.

    • \n
\n
\n
\n
\n

Gestion des fichiersLien vers cette rubrique#

\n

Les contrôles suivants vérifient votre configuration concernant Gestion des fichiers:

\n\n
\n
\n

Champs de modèleLien vers cette rubrique#

\n\n
\n

Champs de type fichierLien vers cette rubrique#

\n
    \n

  • fields.E200 : unique n’est pas un paramètre valable pour un champ FileField. Ce contrôle est supprimé dans Django 1.11.

    • \n

  • fields.E201 : primary_key n’est pas un paramètre valable pour un champ FileField.

    • \n

  • fields.E202 : le paramètre upload_to de FileField doit être un chemin relatif, et non absolu.

    • \n

  • fields.E210 : impossible d’utiliser ImageField car Pillow n’est pas installé.

    • \n
\n
\n
\n

Champs de liaisonLien vers cette rubrique#

\n
    \n

  • fields.E300 : le champ définit une relation avec le modèle <model>, qui n’est pas installé ou qui est abstrait.

    • \n

  • fields.E301 : le champ définit une relation avec le modèle <étiquette_app>.<modèle> qui a été substitué.

    • \n

  • fields.E302 : l’accesseur inverse <modèle lié>.<nom accesseur> pour <étiquette_app>.<modèle>.<nom champ> entre en conflit avec le nom du champ <étiquette_app>.<modèle>.<nom champ>.

    • \n

  • fields.E303 : le nom de requête inverse pour <étiquette_app>.<modèle>.<nom_de_champ> entre en conflit avec le nom du champ <étiquette_app>.<modèle>.<nom_de_champ>.

    • \n

  • fields.E304 : l’accesseur inverse <modèle lié>.<nom accesseur> pour <étiquette_app>.<modèle>.<nom champ> entre en conflit avec l’accesseur inverse pour <étiquette_app>.<modèle>.<nom champ>.

    • \n

  • fields.E305 : le nom de requête inverse de <étiquette_app>.<modèle>.<nom_de_champ> entre en conflit avec le nom de requête inverse de <étiquette_app>.<modèle>.<nom_de_champ>.

    • \n

  • fields.E306 : le nom <name> n’est pas un nom related_name valable pour le champ <modèle>.<nom_de_champ>.

    • \n

  • fields.E307 : le champ <étiquette_app>.<modèle>.<nom_de_champ> a été déclaré avec une référence différée à <étiquette_app>.<modèle>, mais l’application <étiquette_app> n’est pas installée ou ne fournit pas de modèle <modèle>.

    • \n

  • fields.E308 : le nom de requête inverse <nom_requête_inverse> ne doit pas se terminer par un soulignement.

    • \n

  • fields.E309 : le nom de requête inverse <nom_requête_inverse> ne doit pas contenir '__'.

    • \n

  • fields.E310 : aucun sous-ensemble des champs <champ1>, <champ2>, … du modèle <modèle> n’a de contrainte unique.

    • \n

  • fields.E311 : <modèle>.<nom de champ> doit être unique car il est référencé par une clé ForeignKey.

    • \n

  • fields.E312 : le paramètre to_field <nom_champ> n’existe pas dans le modèle lié <étiquette_app>.<modèle>.

    • \n

  • fields.E320 : le champ contient on_delete=SET_NULL mais il ne peut pas être nul.

    • \n

  • fields.E321 : le champ contient on_delete=SET_DEFAULT mais il n’a pas de valeur par défaut.

    • \n

  • fields.E330 : les champs ManyToManyField ne peuvent pas être uniques.

    • \n

  • fields.E331 : le champ définit une relation plusieurs-à-plusieurs via le modèle <modèle> qui n’a pas été installé.

    • \n

  • fields.E332 : les champs plusieurs-à-plusieurs avec des tables intermédiaires ne peuvent pas être symétriques. Ce contrôle est apparu avant Django 3.0.

    • \n

  • fields.E333 : le modèle est utilisé en tant que modèle intermédiaire par <modèle> mais il a plus de deux clés étrangères vers <modèle>, ce qui est ambigu. Vous devez indiquer laquelle des deux clés étrangères Django doit utiliser via le paramètre nommé through_fields.

    • \n

  • fields.E334 : le modèle est utilisé en tant que modèle intermédiaire par <modèle> mais il a plus d’une clé étrangère depuis <modèle>, ce qui est ambigu. Vous devez indiquer quelle clé étrangère Django doit utiliser via le paramètre nommé through_fields.

    • \n

  • fields.E335 : le modèle est utilisé en tant que modèle intermédiaire par <modèle> mais il a plus d’une clé étrangère vers <modèle>, ce qui est ambigu. Vous devez indiquer quelle clé étrangère Django doit utiliser via le paramètre nommé through_fields.

    • \n

  • fields.E336 : le modèle est utilisé en tant que modèle intermédiaire par <modèle> mais il n’a pas de clé étrangère vers <modèle> ou <modèle>.

    • \n

  • fields.E337 : le champ définit through_fields mais ne fournit pas le nom des deux champs de liaison qui doivent être utilisés pour la relation via <modèle>.

    • \n

  • fields.E338 : le modèle intermédiaire <through model> n’a pas de champ <nom_de_champ>.

    • \n

  • fields.E339 : <modèle>.<nom_de_champ> n’est pas une clé étrangère vers <modèle>.

    • \n

  • fields.E340 : la table intermédiaire du champ <nom table> entre en conflit avec le nom de la table de <modèle>/<modèle>.<nom champ>.

    • \n

  • fields.W340 : null n’a pas d’effet sur le champ ManyToManyField.

    • \n

  • fields.W341 : ManyToManyField ne prend pas en charge le paramètre validators.

    • \n

  • fields.W342 : la définition de unique=True sur un champ ForeignKey a le même effet que d’utiliser un champ OneToOneField.

    • \n

  • fields.W343 : limit_choices_to n’a aucun effet sur le champ ManyToManyField avec modèle intermédiaire. Ce contrôle est apparu avant Django 4.0.

    • \n

  • fields.W344 : la table intermédiaire du champ <nom table> entre en conflit avec le nom de la table de <modèle>/<modèle>.<nom champ>.

    • \n

  • fields.W345 : related_name n’a aucun effet sur le champ ManyToManyField avec une relation symétrique, par ex. vers self.

    • \n

  • fields.W346 : db_comment n’a aucun effet sur les champs ManyToManyField.

    • \n
\n
\n
\n
\n

ModèlesLien vers cette rubrique#

\n\n
\n
\n

SécuritéLien vers cette rubrique#

\n

Les contrôles de sécurité ne rendent pas votre site sûr. Ils n’auditent pas votre code, ne font pas de détection d’intrusion ou quoi que ce soit d’autre de particulièrement complexe. Ils s’occupent plutôt d’une liste de contrôles automatisés détectant les problèmes les plus évidents qui peuvent vous aider à améliorer la sécurité d’un site.

\n

Certains de ces contrôles ne sont pas forcément adéquats pour votre configuration de déploiement particulière. Par exemple, si vous avez délégué la redirection HTTP vers HTTPS à un répartiteur de charge, il serait gênant d’être constamment averti que le réglage SECURE_SSL_REDIRECT n’est pas actif. Utilisez SILENCED_SYSTEM_CHECKS pour réduire au silence les contrôles non nécessaires.

\n

Les contrôles suivants sont exécutés si l’option check --deploy est indiquée :

\n\n

Les contrôles suivants vérifient que les réglages liés à la sécurité sont correctement configurés :

\n\n
\n
\n

SignauxLien vers cette rubrique#

\n\n
\n
\n

GabaritsLien vers cette rubrique#

\n

Les contrôles suivants vérifient que le réglage TEMPLATES est configuré correctement :

\n\n
\n
\n

TraductionLien vers cette rubrique#

\n

Les contrôles suivants sont effectués sur votre configuration de traduction :

\n\n
\n
\n

URLLien vers cette rubrique#

\n

Les contrôles suivants sont effectués sur votre configuration d’URL :

\n\n
\n
\n
\n

Contrôles des applications contribLien vers cette rubrique#

\n
\n

adminLien vers cette rubrique#

\n

Les contrôles de l’interface d’administration sont tous effectués sous l’étiquette admin.

\n

Les contrôles suivants sont effectués sur toute classe (ou sous-classe de) ModelAdmin qui est inscrite auprès du site d’administration :

\n\n
\n

ModelAdminLien vers cette rubrique#

\n

Les contrôles suivants sont effectués sur toute classes (ou sous-classe de) ModelAdmin qui est enregistrée auprès du site d’administration:

\n
    \n

  • admin.E101: La valeur de save_as doit être un booléen.

    • \n

  • admin.E102: La valeur de save_on_top doit être un booléen.

    • \n

  • admin.E103: La valeur de inlines doit être une liste ou un tuple.

    • \n

  • admin.E104 : <InlineModelAdmin class> doit hériter de InlineModelAdmin.

    • \n

  • admin.E105: <InlineModelAdmin class> doit avoir un attribut model.

    • \n

  • admin.E106: La valeur de <InlineModelAdmin class>.model doit être un Model.

    • \n

  • admin.E107: La valeur de list_display doit être une liste ou un tuple.

    • \n

  • admin.E108 : la valeur de list_display[n] fait référence à <label>, qui n’est pas un objet exécutable, un attribut de <classe ModelAdmin>, ni un attribut ou une méthode de <modèle>.

    • \n

  • admin.E109 : la valeur de list_display[n] ne peut pas être un champ ManyToManyField.

    • \n

  • admin.E110 : La valeur de list_display_links doit être une liste, un tuple ou None.

    • \n

  • admin.E111 : la valeur de list_display_links[n] fait référence à <label>, qui n’est pas défini dans list_display.

    • \n

  • admin.E112 : La valeur de list_filter doit être une liste ou un tuple.

    • \n

  • admin.E113 : la valeur de list_filter[n] doit hériter de ListFilter.

    • \n

  • admin.E114 : la valeur de list_filter[n] ne doit pas hériter de FieldListFilter.

    • \n

  • admin.E115 : la valeur de list_filter[n][1] doit hériter de FieldListFilter.

    • \n

  • admin.E116 : la valeur de list_filter[n] fait référence à <label>, qui ne fait pas référence à un champ Field.

    • \n

  • admin.E117 : la valeur de list_select_related doit être une valeur booléenne, un tuple ou une liste.

    • \n

  • admin.E118 : la valeur de list_per_page doit être un nombre entier.

    • \n

  • admin.E119 : la valeur de list_max_show_all doit être un nombre entier.

    • \n

  • admin.E120 : la valeur de list_editable doit être une liste ou un tuple.

    • \n

  • admin.E121 : la valeur de list_editable[n] fait référence à <label>, qui n’est pas un champ de <modèle>.

    • \n

  • admin.E122 : la valeur de list_editable[n] fait référence à <label>, qui ne figure pas dans list_display.

    • \n

  • admin.E123 : la valeur de list_editable[n] ne peut pas être à la fois dans list_editable et dans list_display_links.

    • \n

  • admin.E124 : la valeur de list_editable[n] fait référence au tout premier champ dans list_display (<label>), qui ne peut pas utilisé tant que list_display_links n’est pas défini.

    • \n

  • admin.E125 : la valeur de list_editable[n] fait référence à <nom_de_champ>, qui n’est pas modifiable dans l’interface d’administration.

    • \n

  • admin.E126 : La valeur de search_fields doit être une liste ou un tuple.

    • \n

  • admin.E127 : la valeur de date_hierarchy fait référence à <nom_de_champ>, qui ne se réfère pas à un champ.

    • \n

  • admin.E128 : la valeur de date_hierarchy doit être un champ DateField ou DateTimeField.

    • \n

  • admin.E129 : <modeladmin> doit définir une méthode has_<foo>_permission() pour l’action <action>.

    • \n

  • admin.E130 : les attributs __name__ des actions définies dans <modeladmin> doivent être uniques. Le nom <nom> n’est pas unique.

    • \n
\n
\n
\n

InlineModelAdminLien vers cette rubrique#

\n

Les contrôles suivants sont effectués sur chaque InlineModelAdmin qui est inscrit comme élément intégré dans une classe ModelAdmin.

\n
    \n

  • admin.E201 : vous ne pouvez pas exclure le champ <nom_de_champ>, car il s’agit de la clé étrangère vers le modèle parent <étiquette_application>.<modèle>.

    • \n

  • admin.E202 : <modèle> n’a pas de clé ForeignKey vers <modèle parent>./ <modèle> `` a plus d'une clé ``ForeignKey vers <modèle parent>. Vous devez indiquer un attribut fk_name.

    • \n

  • admin.E203 : la valeur de extra doit être un nombre entier.

    • \n

  • admin.E204 : la valeur de max_num doit être un nombre entier.

    • \n

  • admin.E205 : la valeur de min_num doit être un nombre entier.

    • \n

  • admin.E206 : la valeur de formset doit hériter de BaseModelFormSet.

    • \n
\n
\n
\n

GenericInlineModelAdminLien vers cette rubrique#

\n

Les contrôles suivants sont effectués sur chaque GenericInlineModelAdmin qui est inscrit comme élément intégré dans une classe ModelAdmin.

\n
    \n

  • admin.E301 : 'champ_ct' fait référence à <label>, qui n’est pas un champ de <modèle>.

    • \n

  • admin.E302 : 'champ_ct_fk' fait référence à <label>, qui n’est pas un champ de <modèle>.

    • \n

  • admin.E303 : <modèle> n’a pas de clé GenericForeignKey.

    • \n

  • admin.E304 : <modèle> n’a pas de clé GenericForeignKey utilisant le champ de type de contenu <nom_de_champ> et le champ d’identifiant d’objet <nom_de_champ>.

    • \n
\n
\n
\n

AdminSiteLien vers cette rubrique#

\n

Les contrôles suivants sont effectués sur l’objet AdminSite par défaut :

\n\n
\n
\n
\n

authLien vers cette rubrique#

\n\n
\n
\n

contenttypesLien vers cette rubrique#

\n

Les contrôles suivants sont effectués quand un modèle contient une clé GenericForeignKey ou une relation GenericRelation:

\n\n
\n
\n

postgresLien vers cette rubrique#

\n

Les contrôles suivants s’appliquent aux champs de modèle django.contrib.postgres:

\n\n
\n
\n

sitesLien vers cette rubrique#

\n

Les contrôles suivants sont effectués sur chaque modèle utilisant un gestionnaire CurrentSiteManager:

\n\n

Les contrôles suivants vérifient que django.contrib.sites est configuré correctement :

\n\n
\n
\n

staticfilesLien vers cette rubrique#

\n

Les contrôles suivants vérifient que django.contrib.staticfiles est configuré correctement :

\n\n
\n
","rootId":"system-check-framework","toc":[{"title":"Référence de l’API","anchor":"api-reference","children":[{"title":"CheckMessage","anchor":"checkmessage","children":[]}]},{"title":"Étiquettes prédéfinies","anchor":"builtin-tags","children":[]},{"title":"Vérifications systèmes du noyau","anchor":"core-system-checks","children":[{"title":"Gestion du code asynchrone","anchor":"asynchronous-support","children":[]},{"title":"Rétrocompatibilité","anchor":"backwards-compatibility","children":[]},{"title":"Caches","anchor":"caches","children":[]},{"title":"Base de données","anchor":"database","children":[{"title":"MySQL et MariaDB","anchor":"mysql-and-mariadb","children":[]}]},{"title":"Gestion des fichiers","anchor":"managing-files","children":[]},{"title":"Champs de modèle","anchor":"model-fields","children":[{"title":"Champs de type fichier","anchor":"file-fields","children":[]},{"title":"Champs de liaison","anchor":"related-fields","children":[]}]},{"title":"Modèles","anchor":"models","children":[]},{"title":"Sécurité","anchor":"security","children":[]},{"title":"Signaux","anchor":"signals","children":[]},{"title":"Gabarits","anchor":"templates","children":[]},{"title":"Traduction","anchor":"translation","children":[]},{"title":"URL","anchor":"urls","children":[]}]},{"title":"Contrôles des applications contrib","anchor":"contrib-app-checks","children":[{"title":"admin","anchor":"admin","children":[{"title":"ModelAdmin","anchor":"modeladmin","children":[]},{"title":"InlineModelAdmin","anchor":"inlinemodeladmin","children":[]},{"title":"GenericInlineModelAdmin","anchor":"genericinlinemodeladmin","children":[]},{"title":"AdminSite","anchor":"adminsite","children":[]}]},{"title":"auth","anchor":"auth","children":[]},{"title":"contenttypes","anchor":"contenttypes","children":[]},{"title":"postgres","anchor":"postgres","children":[]},{"title":"sites","anchor":"sites","children":[]},{"title":"staticfiles","anchor":"staticfiles","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/4.2/ref/"}],"prev":{"docname":"ref/applications","title":"Applications","url":"/fr/4.2/ref/applications/"},"next":{"docname":"ref/class-based-views/index","title":"API des vues intégrées fondées sur les classes","url":"/fr/4.2/ref/class-based-views/"},"formats":{"html":"/fr/4.2/ref/checks/","markdown":"/fr/4.2/ref/checks.md","json":"/fr/4.2/ref/checks.json"},"source":"https://github.com/django/django/blob/stable/4.2.x/docs/ref/checks.txt","official":"https://docs.djangoproject.com/fr/4.2/ref/checks/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}