--- title: "Notes de publication de Django 5.1" version: 6.1 locale: fr source: https://docs.djangoproject.com/fr/6.1/releases/5.1/ canonical: https://djangodocs.dev/fr/6.1/releases/5.1/ --- # Notes de publication de Django 5.1 *7 août 2024* Bienvenue dans Django 5.1 ! Ces notes de publications couvrent les [nouvelles fonctionnalités](#whats-new-5-1), ainsi que certaines [modifications non rétrocompatibles](#backwards-incompatible-5-1) dont il faut être au courant lors de la mise à jour depuis Django 5.0 ou des versions plus anciennes. Nous avons commencé [le processus d’obsolescence de certaines fonctionnalités](#deprecated-features-5-1). Voir le guide [Mise à jour de Django à une version plus récente](/fr/6.1/howto/upgrade-version/) si vous mettez à jour un projet existant. ## Compatibilité Python Django 5.1 supports Python 3.10, 3.11, 3.12, and 3.13 (as of 5.1.3). We **highly recommend** and only officially support the latest release of each series. ## Quoi de neuf dans Django 5.1 ### Balise de gabarit `{% querystring %}` Django 5.1 introduit la balise de gabarit [`{% querystring %}`](/fr/6.1/ref/templates/builtins/#std-templatetag-querystring) pour simplifier la modification des paramètres de requête dans les URL, ce qui rend plus facile la génération de liens en conservant les paramètres de requête existants tout en en ajoutant ou en en modifiant certains. Par exemple, la navigation dans la pagination et les paramètres de requête dans les gabarits peut se révéler compliquée. Imaginez ce fragment de gabarit qui génère dynamiquement une URL pour naviguer vers la page suivante dans le cadre d’une vue paginée : ```html+django {# Linebreaks added for readability, this should be one, long line. #} Next page ``` En utilisant la nouvelle balise de gabarit, le contenu ci-dessus devient magiquement : ```html+django Next page ``` ### Réserves de connexions PostgreSQL Django 5.1 introduit aussi la prise en charge des [réserves de connexion (pool)](/fr/6.1/ref/databases/#postgresql-pool) pour PostgreSQL. Comme le temps d’établissement d’une connexion peut être relativement lent, conserver des connexions ouvertes peut réduire la latence. Pour utiliser une réserve de connexions avec [psycopg](https://www.psycopg.org/), vous pouvez définir l’option `"pool"` dans [`OPTIONS`](/fr/6.1/ref/settings/#std-setting-OPTIONS), soit sous forme de dictionnaire à passer à [`ConnectionPool`](https://www.psycopg.org/psycopg3/docs/api/pool.html#psycopg_pool.ConnectionPool), soit avec la valeur `True` pour utiliser les valeurs par défaut de `ConnectionPool`: ``` DATABASES = { "default": { "ENGINE": "django.db.backends.postgresql", # ... "OPTIONS": { "pool": { "min_size": 2, "max_size": 4, "timeout": 10, } }, }, } ``` ### Intergiciel pour exiger l’authentification par défaut Le nouvel intergiciel [`LoginRequiredMiddleware`](/fr/6.1/ref/middleware/#django.contrib.auth.middleware.LoginRequiredMiddleware) redirige toutes les requêtes non authentifiées ver une page de connexion. Les vues peuvent autoriser des requêtes non authentifiées en utilisant le nouveau décorateur [`login_not_required()`](/fr/6.1/topics/auth/default/#django.contrib.auth.decorators.login_not_required). `LoginRequiredMiddleware` respecte les valeurs `login_url` et `redirect_field_name` définies via le décorateur [`login_required()`](/fr/6.1/topics/auth/default/#django.contrib.auth.decorators.login_required), mais ne prend pas en charge la définition de `login_url` ou `redirect_field_name` via la classe [`LoginRequiredMixin`](/fr/6.1/topics/auth/default/#django.contrib.auth.mixins.LoginRequiredMixin). Pour activer cette nouvelle fonctionnalité, ajoutez `"django.contrib.auth.middleware.LoginRequiredMiddleware"` à votre réglage [`MIDDLEWARE`](/fr/6.1/ref/settings/#std-setting-MIDDLEWARE). ### Fonctionnalités mineures #### [`django.contrib.admin`](/fr/6.1/ref/contrib/admin/#module-django.contrib.admin) - [`ModelAdmin.list_display`](/fr/6.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin.list_display) accepte désormais les accès avec `__` pour lister des champs de modèles liés. #### [`django.contrib.auth`](/fr/6.1/topics/auth/#module-django.contrib.auth) - Le nombre d’itération par défaut du hacheur de mot de passe PBKDF2 a été augmenté de 720’000 à 870’000. - Le paramètre `parallelism` par défaut de `ScryptPasswordHasher` a été augmenté de 1 à 5, pour suivre les recommandations OWASP. - Le nouveau formulaire [`AdminUserCreationForm`](/fr/6.1/topics/auth/default/#django.contrib.auth.forms.AdminUserCreationForm) et le formulaire existant [`AdminPasswordChangeForm`](/fr/6.1/topics/auth/default/#django.contrib.auth.forms.AdminPasswordChangeForm) permettent dorénavant de désactiver l’authentification par mot de passe en définissant un mot de passe inutilisable lors de l’enregistrement du formulaire. Cette fonctionnalité est accessible sur le site d’administration sur les pages de création d’utilisateur et de modification de mot de passe. - Les décorateurs [`login_required()`](/fr/6.1/topics/auth/default/#django.contrib.auth.decorators.login_required), [`permission_required()`](/fr/6.1/topics/auth/default/#django.contrib.auth.decorators.permission_required) et [`user_passes_test()`](/fr/6.1/topics/auth/default/#django.contrib.auth.decorators.user_passes_test) prennent maintenant en charge l’enveloppement de fonctions de vue asynchrones. - `ReadOnlyPasswordHashWidget` inclut dorénavant un bouton pour réinitialiser le mot de passe de l’utilisateur, qui remplace le lien précédemment imbriqué dans le texte d’aide de `ReadOnlyPasswordHashField`, ce qui améliore l’accessibilité générale du formulaire [`UserChangeForm`](/fr/6.1/topics/auth/default/#django.contrib.auth.forms.UserChangeForm). #### [`django.contrib.gis`](/fr/6.1/ref/contrib/gis/#module-django.contrib.gis) - [`BoundingCircle`](/fr/6.1/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.BoundingCircle) est dorénavant pris en charge avec SpatiaLite 5.1+. - [`Collect`](/fr/6.1/ref/contrib/gis/geoquerysets/#django.contrib.gis.db.models.Collect) est dorénavant prise en charge avec MySQL 8.0.24+. - [`GeoIP2`](/fr/6.1/ref/contrib/gis/geoip2/#django.contrib.gis.geoip2.GeoIP2) permet maintenant de faire des requêtes avec des objets [`ipaddress.IPv4Address`](https://docs.python.org/3/library/ipaddress.html#ipaddress.IPv4Address) ou [`ipaddress.IPv6Address`](https://docs.python.org/3/library/ipaddress.html#ipaddress.IPv6Address). - [`GeoIP2.country()`](/fr/6.1/ref/contrib/gis/geoip2/#django.contrib.gis.geoip2.GeoIP2.country) expose désormais les valeurs `continent_code`, `continent_name` et `is_in_european_union`. - [`GeoIP2.city()`](/fr/6.1/ref/contrib/gis/geoip2/#django.contrib.gis.geoip2.GeoIP2.city) expose désormais les valeurs `accuracy_radius` et `region_name`. De plus, les valeurs `dma_code` et `region` sont désormais exposées sous `metro_code` et `region_code`, mais les noms précédents sont aussi conservés par rétrocompatibilité. - [`Area`](/fr/6.1/ref/contrib/gis/measure/#django.contrib.gis.measure.Area) prend désormais en charge l’unité `ha` (hectares). - Le nouvel attribut [`OGRGeometry.is_3d`](/fr/6.1/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.is_3d) permet de contrôler si une géométrie possède une coordonnée de dimension `Z`. - La nouvelle méthode [`OGRGeometry.set_3d()`](/fr/6.1/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.set_3d) permet l’ajout et la suppression de la coordonnée de dimension `Z`. - [`OGRGeometry`](/fr/6.1/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry), [`Point`](/fr/6.1/ref/contrib/gis/gdal/#django.contrib.gis.gdal.Point), [`LineString`](/fr/6.1/ref/contrib/gis/gdal/#django.contrib.gis.gdal.LineString), [`Polygon`](/fr/6.1/ref/contrib/gis/gdal/#django.contrib.gis.gdal.Polygon) et [`GeometryCollection`](/fr/6.1/ref/contrib/gis/gdal/#django.contrib.gis.gdal.GeometryCollection) et leurs sous-classes prennent dorénavant en charge les géométries avec mesures via les nouvelles propriétés [`OGRGeometry.is_measured`](/fr/6.1/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.is_measured) et `m`, ainsi que la méthode [`OGRGeometry.set_measured()`](/fr/6.1/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.set_measured). - [`OGRGeometry.centroid`](/fr/6.1/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.centroid) est maintenant disponible pour tous les types d’objets géométriques pris en charge. - Les fonctions [`FromWKB()`](/fr/6.1/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.FromWKB) et [`FromWKT()`](/fr/6.1/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.FromWKT) prennent désormais en charge l’argument facultatif `srid` (sauf pour Oracle où cet argument est ignoré). #### [`django.contrib.postgres`](/fr/6.1/ref/contrib/postgres/#module-django.contrib.postgres) - [`BTreeIndex`](/fr/6.1/ref/contrib/postgres/indexes/#django.contrib.postgres.indexes.BTreeIndex) prend désormais en charge le paramètre `deduplicate_items`. #### [`django.contrib.sessions`](/fr/6.1/topics/http/sessions/#module-django.contrib.sessions) - [`django.contrib.sessions.backends.cached_db.SessionStore`](/fr/6.1/topics/http/sessions/#django.contrib.sessions.backends.cached_db.SessionStore) gère dorénavant les exceptions lors du stockage des informations de session dans le cache, journalisant les messages d’erreur appropriés avec leur trace d’erreur dans le [journaliseur de sessions](/fr/6.1/ref/logging/#django-contrib-sessions-logger) nouvellement ajouté. - [`django.contrib.sessions.backends.base.SessionBase`](/fr/6.1/topics/http/sessions/#django.contrib.sessions.backends.base.SessionBase) et tous les moteurs de sessions intégrés fournissent une API asynchrones. Les nouvelles méthodes asynchrones ont toutes un préfixe `a`, par ex. `aget()`, `akeys()` ou `acycle_key()`. #### Moteurs de base de données - L’option `"init_command"` est dorénavant prise en charge dans les [`OPTIONS`](/fr/6.1/ref/settings/#std-setting-OPTIONS) de SQLite pour permettre d’indiquer des [options pragma](/fr/6.1/ref/databases/#sqlite-init-command) à définir à l’établissement des connexions. - L’option `"transaction_mode"` est dorénavant prise en charge dans les [`OPTIONS`](/fr/6.1/ref/settings/#std-setting-OPTIONS) de SQLite pour permettre d’indiquer le [Comportement des transactions](/fr/6.1/ref/databases/#sqlite-transaction-behavior). - L’option `"pool"` est dorénavant prise en charge dans les [`OPTIONS`](/fr/6.1/ref/settings/#std-setting-OPTIONS) de PostgreSQL pour permettre d’utiliser les [réserves de connexions](/fr/6.1/ref/databases/#postgresql-pool). #### Signalement d’erreurs - Afin d’améliorer l’accessibilité, les pages d’erreur 404 et 500 utilisent dorénavant les éléments de positionnement HTML pour l’en-tête, le pied de page et les principales zones de contenus. #### Stockage de fichier - Le paramètre [`allow_overwrite`](/fr/6.1/ref/files/storage/#django.core.files.storage.FileSystemStorage.allow_overwrite) de [`FileSystemStorage`](/fr/6.1/ref/files/storage/#django.core.files.storage.FileSystemStorage) permet maintenant d’enregistrer des nouveaux fichiers en écrasant les anciens de même nom. #### Formulaires - Dans l’optique d’améliorer l’accessibilité et de permettre aux lecteurs d’écran d’associer les groupes de champs avec leur texte d’aide, les groupes de champs de formulaires incluent dorénavant l’attribut HTML `aria-describedby`. #### Commandes d’administration - La commande [`makemigrations`](/fr/6.1/ref/django-admin/#django-admin-makemigrations) affiche dorénavant des symboles significatifs pour chaque opération afin de mettre en évidence les [`catégories d'opérations`](/fr/6.1/ref/migration-operations/#django.db.migrations.operations.base.OperationCategory). #### Migrations - Le nouvel attribut `Operation.category` permet d’indiquer une [`catégorie d'opération`](/fr/6.1/ref/migration-operations/#django.db.migrations.operations.base.OperationCategory) utilisée par la commande [`makemigrations`](/fr/6.1/ref/django-admin/#django-admin-makemigrations) pour afficher un symbole significatif de l’opération. #### Modèles - [`QuerySet.explain()`](/fr/6.1/ref/models/querysets/#django.db.models.query.QuerySet.explain) prend en charge dorénavant l’option `generic_plan` de PostgreSQL 16+. - [`RowRange`](/fr/6.1/ref/models/expressions/#django.db.models.expressions.RowRange) accepte dorénavant des entiers positifs pour l’argument `start` et des entiers négatifs pour l’argument `end`. - Le nouvel argument `exclusion` de [`RowRange`](/fr/6.1/ref/models/expressions/#django.db.models.expressions.RowRange) et [`ValueRange`](/fr/6.1/ref/models/expressions/#django.db.models.expressions.ValueRange) permet d’exclure des lignes, des groupes et des « ties » des cadres de fenêtres. - [`QuerySet.order_by()`](/fr/6.1/ref/models/querysets/#django.db.models.query.QuerySet.order_by) prend dorénavant en charge le tri par annotations de transformation telles que des clés `JSONObject` et des indices `ArrayAgg`. - Les expressions [`F()`](/fr/6.1/ref/models/expressions/#django.db.models.F) et [`OuterRef()`](/fr/6.1/ref/models/expressions/#django.db.models.OuterRef) qui résultent en champs [`CharField`](/fr/6.1/ref/models/fields/#django.db.models.CharField), [`EmailField`](/fr/6.1/ref/models/fields/#django.db.models.EmailField), [`SlugField`](/fr/6.1/ref/models/fields/#django.db.models.SlugField), [`URLField`](/fr/6.1/ref/models/fields/#django.db.models.URLField), [`TextField`](/fr/6.1/ref/models/fields/#django.db.models.TextField) ou [`ArrayField`](/fr/6.1/ref/contrib/postgres/fields/#django.contrib.postgres.fields.ArrayField) peuvent dorénavant être [segmentées](/fr/6.1/ref/models/expressions/#slicing-using-f). - Le nouvel argument `from_queryset` de [`Model.refresh_from_db()`](/fr/6.1/ref/models/instances/#django.db.models.Model.refresh_from_db) et [`Model.arefresh_from_db()`](/fr/6.1/ref/models/instances/#django.db.models.Model.arefresh_from_db)  permet de personnaliser le jeu de requête utilisé pour recharger les valeurs d’un modèle. Cela peut être utilisé pour verrouiller une ligne avant le rechargement ou pour précharger des objets liés. - Le nouvel attribut [`Expression.constraint_validation_compatible`](/fr/6.1/ref/models/expressions/#django.db.models.Expression.constraint_validation_compatible) permet d’indiquer que l’expression doit être ignorée lors de la validation de contrainte. #### Gabarits - Des balises personnalisées peuvent maintenant définir des données supplémentaires sur l’objet `Parser` qui seront ensuite disponibles sur l’instance `Template`. De telles données peuvent par exemple être utilisées par le chargeur de gabarits, ou d’autres clients des gabarits. - Les [moteurs de gabarits](/fr/6.1/topics/checks/#field-checking) implémentent dorénavant une méthode `check()` qui est déjà inscrite dans l’infrastructure des contrôles. #### Tests - Les assertions [`assertContains()`](/fr/6.1/topics/testing/tools/#django.test.SimpleTestCase.assertContains), [`assertNotContains()`](/fr/6.1/topics/testing/tools/#django.test.SimpleTestCase.assertNotContains) et [`assertInHTML()`](/fr/6.1/topics/testing/tools/#django.test.SimpleTestCase.assertInHTML) ajoutent maintenant les contenus recherchés aux messages d’erreur des assertions. - Les classes [`RequestFactory`](/fr/6.1/topics/testing/advanced/#django.test.RequestFactory), [`AsyncRequestFactory`](/fr/6.1/topics/testing/advanced/#django.test.AsyncRequestFactory), [`Client`](/fr/6.1/topics/testing/tools/#django.test.Client) et [`AsyncClient`](/fr/6.1/topics/testing/tools/#django.test.AsyncClient) prennent désormais en charge le paramètre `query_params` qui accepte un dictionnaire de clés/valeurs de chaînes de requête. Cela permet de définir plus facilement des chaînes de requête pour toute méthode HTTP. ```python self.client.post("/items/1", query_params={"action": "delete"}) await self.async_client.post("/items/1", query_params={"action": "delete"}) ``` - La nouvelle assertion [`SimpleTestCase.assertNotInHTML()`](/fr/6.1/topics/testing/tools/#django.test.SimpleTestCase.assertNotInHTML) permet de tester qu’un fragment HTML n’est pas contenu dans le contenu de recherche HTML donné. - Dans le but de renforcer l’isolation des tests, les connexions de base de données à l’intérieur des fils d’exécution ne sont plus autorisées dans [`SimpleTestCase`](/fr/6.1/topics/testing/tools/#django.test.SimpleTestCase). #### Validateurs - Le nouveau validateur [`DomainNameValidator`](/fr/6.1/ref/validators/#django.core.validators.DomainNameValidator) valide les noms de domaine, y compris les noms de domaine internationalisés. La nouvelle fonction [`validate_domain_name()`](/fr/6.1/ref/validators/#django.core.validators.validate_domain_name) renvoie une instance de [`DomainNameValidator`](/fr/6.1/ref/validators/#django.core.validators.DomainNameValidator). ## Changements incompatibles avec les anciennes versions dans Django 5.1 ### [`django.contrib.gis`](/fr/6.1/ref/contrib/gis/#module-django.contrib.gis) - La prise en charge de PostGIS 2.5 a été supprimée. - La prise en charge de PROJ \< 6 a été supprimée. - La prise en charge de GDAL 2.4 a été supprimée. - [`GeoIP2`](/fr/6.1/ref/contrib/gis/geoip2/#django.contrib.gis.geoip2.GeoIP2) n’ouvre plus à la fois les bases de données `city` et `country` lorsque un chemin vers un répertoire est indiqué, préférant la base de données `city` quand elle est disponible. La base de données des pays est un sous-ensemble de la base de données des villes et il n’y a souvent pas besoin des deux. Si vous avez vraiment besoin de la base de données des pays se trouvant dans le même répertoire de celle des villes, passez explicitement le chemin vers la base de données des pays dans le constructeur. ### Abandon de la prise en charge de MariaDB 10.4 La prise en charge amont de MariaDB 10.4 se termine en juin 2024. Django 5.1 prend en charge MariaDB 10.5 et plus récent. ### Abandon de la prise en charge de PostgreSQL 12 La prise en charge amont de PostgreSQL 12 se termine en novembre 2024. Django 5.1 prend en charge PostgreSQL 13 et plus récent. ### Divers - Afin d’améliorer l’accessibilité, le filtre de la liste pour modification du site d’administration est produit dans une balise `