---
title: "Notes de publication de Django 1.10"
version: 4.2
locale: fr
source: https://docs.djangoproject.com/fr/4.2/releases/1.10/
canonical: https://djangodocs.dev/fr/4.2/releases/1.10/
---
# Notes de publication de Django 1.10
*1er août 2016*
Bienvenue dans Django 1.10 !
Ces notes de publications couvrent les [nouvelles fonctionnalités](#whats-new-1-10), ainsi que certaines [modifications non rétro-compatibles](#backwards-incompatible-1-10) dont il faut être au courant lors la mise à jour depuis Django 1.9 ou des versions plus anciennes. Nous avons [abandonné certaines fonctionnalités](#removed-features-1-10) qui ont atteint la fin de leur cycle d’obsolescence et nous avons commencé [le processus d’obsolescence de certaines fonctionnalités](#deprecated-features-1-10).
Voir le guide [Mise à jour de Django à une version plus récente](/fr/4.2/howto/upgrade-version/) si vous mettez à jour un projet existant.
## Compatibilité Python
Comme pour Django 1.9, Django 1.10 requiert Python 2.7, 3.4 ou 3.5. Nous **recommandons vivement** et nous ne prenons officiellement en charge que la dernière publication de chaque série.
## Quoi de neuf dans Django 1.10
### Recherche plein texte avec PostgreSQL
`django.contrib.postgres` inclut dorénavant une [série de fonctions de base de données](/fr/4.2/ref/contrib/postgres/search/) permettant d’exploiter le moteur de recherche plein texte. IL est possible de rechercher dans plusieurs champs de la base de données relationnelle, de combiner les recherches avec d’autres expressions de requête, d’utiliser différentes configurations de langue et de pondération, ainsi que de classer les résultats par pertinence.
Elle inclut aussi la prise en charge des trigrammes, en utilisant la requête [`trigram_similar`](/fr/4.2/ref/contrib/postgres/lookups/#std-fieldlookup-trigram_similar) et les expressions [`TrigramSimilarity`](/fr/4.2/ref/contrib/postgres/search/#django.contrib.postgres.search.TrigramSimilarity) et [`TrigramDistance`](/fr/4.2/ref/contrib/postgres/search/#django.contrib.postgres.search.TrigramDistance).
### Intergiciels nouveau style
[A new style of middleware is introduced](/fr/4.2/topics/http/middleware/) to
solve the lack of strict request/response layering of the old-style of
middleware described in [DEP 0005](https://github.com/django/deps/blob/main/final/0005-improved-middleware.rst).
You’ll need to [adapt old, custom middleware](/fr/4.2/topics/http/middleware/#upgrading-middleware) and
switch from the `MIDDLEWARE_CLASSES` setting to the new [`MIDDLEWARE`](/fr/4.2/ref/settings/#std-setting-MIDDLEWARE)
setting to take advantage of the improvements.
### Prise en charge officielle des noms d’utilisateurs Unicode
The [`User`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.models.User) model in `django.contrib.auth`
originally only accepted ASCII letters and numbers in usernames. Although it
wasn’t a deliberate choice, Unicode characters have always been accepted when
using Python 3.
The username validator now explicitly accepts Unicode characters by
default on Python 3 only.
Custom user models may use the new
[`ASCIIUsernameValidator`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.validators.ASCIIUsernameValidator) or
[`UnicodeUsernameValidator`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.validators.UnicodeUsernameValidator).
### Fonctionnalités mineures
#### [`django.contrib.admin`](/fr/4.2/ref/contrib/admin/#module-django.contrib.admin)
- Pour les sites fonctionnant dans un sous-chemin, [`l'URL par défaut du lien « Voir sur le site »`](/fr/4.2/ref/contrib/admin/#django.contrib.admin.AdminSite.site_url) au sommet de chaque page du site d’administration prend désormais en compte `request.META['SCRIPT_NAME']` s’il est défini au lieu de `/`.
- Le message de succès apparaissant après l’ajout ou l’édition d’un objet contient maintenant un lien vers le formulaire de modification de l’objet concerné.
- Tout le code JavaScript en ligne a été enlevé afin de pouvoir activer l’en-tête HTTP `Content-Security-Policy` si souhaité.
- Le nouvel attribut [`InlineModelAdmin.classes`](/fr/4.2/ref/contrib/admin/#django.contrib.admin.InlineModelAdmin.classes) permet d’indiquer des classes pour les sous-formulaires en ligne. Ces derniers, s’ils possèdent une classe `collapse`, sont initialement repliés et leur en-tête contient un petit lien « Afficher ».
- If a user doesn’t have the add permission, the `object-tools` block on a
model’s changelist will now be rendered (without the add button). This makes
it easier to add custom tools in this case.
- Le modèle [`LogEntry`](/fr/4.2/ref/contrib/admin/#django.contrib.admin.models.LogEntry) stocke dorénavant ses messages de modification dans une structure JSON afin que les messages puissent être dynamiquement traduits dans la langue active. Une nouvelle méthode `LogEntry.get_change_message()` constitue maintenant la manière privilégiée d’obtenir les messages de modification.
- Les objets sélectionnés pour les champs dans `ModelAdmin.raw_id_fields` ont maintenant un lien vers le formulaire de modification des objets.
- Les choix « Aucune date » et « Possède une date » on été ajoutés pour le filtre `DateFieldListFilter` dans le cas où le champ peut contenir la valeur nulle.
- La bibliothèque jQuery incluse dans l’administration a été mise à jour de 2.1.4 vers 2.2.3.
#### [`django.contrib.auth`](/fr/4.2/topics/auth/#module-django.contrib.auth)
- La prise en charge du [hachage de mot de passe Argon2](/fr/4.2/topics/auth/passwords/#argon2-usage) a été ajoutée. Il devrait être préféré à PBKDF2, mais il n’est cependant pas par défaut car il nécessite une bibliothèque tierce.
- Le nombre d’itérations par défaut du hachage des mots de passe PBKDF2 a été augmenté de 25%. Cette modification rétrocompatible n’affecte pas ceux qui ont créé une sous-classe de `django.contrib.auth.hashers.PBKDF2PasswordHasher` pour modifier la valeur par défaut.
- The `django.contrib.auth.views.logout()` view sends « no-cache » headers
to prevent an issue where Safari caches redirects and prevents a user from
being able to log out.
- Added the optional `backend` argument to [`django.contrib.auth.login()`](/fr/4.2/topics/auth/default/#django.contrib.auth.login)
to allow using it without credentials.
- The new [`LOGOUT_REDIRECT_URL`](/fr/4.2/ref/settings/#std-setting-LOGOUT_REDIRECT_URL) setting controls the redirect of the
`django.contrib.auth.views.logout()` view, if the view doesn’t get a
`next_page` argument.
- The new `redirect_authenticated_user` parameter for the
`django.contrib.auth.views.login()` view allows redirecting
authenticated users visiting the login page.
- Les nouveaux moteurs d’authentification [`AllowAllUsersModelBackend`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.backends.AllowAllUsersModelBackend) et [`AllowAllUsersRemoteUserBackend`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.backends.AllowAllUsersRemoteUserBackend) ignorent la valeur de `User.is_active`, alors que [`ModelBackend`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.backends.ModelBackend) et [`RemoteUserBackend`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.backends.RemoteUserBackend) rejettent dorénavant les utilisateurs inactifs.
#### [`django.contrib.gis`](/fr/4.2/ref/contrib/gis/#module-django.contrib.gis)
- [Les requêtes de distance](/fr/4.2/ref/contrib/gis/geoquerysets/#distance-lookups) acceptent maintenant des expressions comme paramètre de valeur de distance.
- La nouvelle propriété [`GEOSGeometry.unary_union`](/fr/4.2/ref/contrib/gis/geos/#django.contrib.gis.geos.GEOSGeometry.unary_union) calcule l’union de tous les éléments d’un objet géométrique.
- Le prédicat binaire [`GEOSGeometry.covers()`](/fr/4.2/ref/contrib/gis/geos/#django.contrib.gis.geos.GEOSGeometry.covers) a été ajouté.
- La méthode [`GDALBand.statistics()`](/fr/4.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.GDALBand.statistics) ainsi que les attributs [`mean`](/fr/4.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.GDALBand.mean) et [`std`](/fr/4.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.GDALBand.std) ont été ajoutés.
- L’agrégat [`MakeLine`](/fr/4.2/ref/contrib/gis/geoquerysets/#django.contrib.gis.db.models.MakeLine) et la fonction [`GeoHash`](/fr/4.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.GeoHash) ont été ajoutés pour Spatialite.
- Les fonctions [`Difference`](/fr/4.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.Difference), [`Intersection`](/fr/4.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.Intersection) et [`SymDifference`](/fr/4.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.SymDifference) ont été ajoutées pour MySQL.
- La possibilité d’instancier des géométries GEOS vides a été ajoutée.
- Les nouvelles propriétés [`trim`](/fr/4.2/ref/contrib/gis/geos/#django.contrib.gis.geos.WKTWriter.trim) et [`precision`](/fr/4.2/ref/contrib/gis/geos/#django.contrib.gis.geos.WKTWriter.precision) de [`WKTWriter`](/fr/4.2/ref/contrib/gis/geos/#django.contrib.gis.geos.WKTWriter) permettent de contrôler la précision de la partie fractionnelle des coordonnées produites au format WKT.
- Les propriétés [`LineString.closed`](/fr/4.2/ref/contrib/gis/geos/#django.contrib.gis.geos.LineString.closed) et [`MultiLineString.closed`](/fr/4.2/ref/contrib/gis/geos/#django.contrib.gis.geos.MultiLineString.closed) ont été ajoutées.
- Le [sérialiseur GeoJSON](/fr/4.2/ref/contrib/gis/serializers/) produit dorénavant la clé primaire des objets dans le dictionnaire `properties` si aucun champ spécifique n’est indiqué.
- La possibilité de dupliquer des données d’entrées de la méthode [`GDALBand.data()`](/fr/4.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.GDALBand.data) a été ajoutée. Les données de bande peuvent maintenant être mises à jour efficacement avec des valeurs répétées.
- Les fonctions de base de données [`IsValid`](/fr/4.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.IsValid) et [`MakeValid`](/fr/4.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.MakeValid) ont été ajoutées, de même que la requête [`isvalid`](/fr/4.2/ref/contrib/gis/geoquerysets/#std-fieldlookup-isvalid), le tout pour PostGIS. Cela permet de filtrer et de réparer des objets géométriques non valides du côté de la base de données.
- La prise en charge des objets matriciels (raster) a été ajoutée pour toutes les [requêtes spatiales](/fr/4.2/ref/contrib/gis/geoquerysets/).
#### [`django.contrib.postgres`](/fr/4.2/ref/contrib/postgres/#module-django.contrib.postgres)
- Par commodité, [`HStoreField`](/fr/4.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.HStoreField) force dorénavant ses clés et valeurs en texte.
#### [`django.contrib.sessions`](/fr/4.2/topics/http/sessions/#module-django.contrib.sessions)
- La commande d’administration [`clearsessions`](/fr/4.2/ref/django-admin/#django-admin-clearsessions) supprime dorénavant les sessions basées sur des fichiers.
#### [`django.contrib.sites`](/fr/4.2/ref/contrib/sites/#module-django.contrib.sites)
- Le modèle [`Site`](/fr/4.2/ref/contrib/sites/#django.contrib.sites.models.Site) prend dorénavant en charge les [clés naturelles](/fr/4.2/topics/serialization/#topics-serialization-natural-keys).
#### [`django.contrib.staticfiles`](/fr/4.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles)
- La balise de gabarit [`static`](/fr/4.2/ref/templates/builtins/#std-templatetag-static) utilise maintenant `django.contrib.staticfiles` si cette application est installée. C’est particulièrement utile pour les applications tierces qui peuvent dorénavant toujours utiliser `{% load static %}` (au lieu de `{% load staticfiles %}` ou `{% load static from staticfiles %}`) et ne plus se soucier de savoir si l’application `staticfiles` est installée ou non.
- You can [more easily customize](/fr/4.2/ref/contrib/staticfiles/#customize-staticfiles-ignore-patterns)
the `collectstatic --ignore` option with a custom `AppConfig`.
#### Cache
- Le moteur de cache basé sur des fichiers utilise dorénavant le protocole de « pickling » le plus élevé.
#### CSRF
- La vue par défaut [`CSRF_FAILURE_VIEW`](/fr/4.2/ref/settings/#std-setting-CSRF_FAILURE_VIEW), `views.csrf.csrf_failure()`, accepte dorénavant un paramètre facultatif `template_name`, valant `'403_csrf.html'` par défaut, pour contrôler le gabarit utilisé pour produire la page.
- Afin de protéger contre les attaques [BREACH](https://www.breachattack.com/), le mécanisme de protection CSRF modifie dorénavant la valeur du jeton de formulaire lors de chaque requête (tout en conservant une valeur secrète stable pouvant être utilisée pour valider les différents jetons).
#### Moteurs de base de données
- La soustraction de données temporelles a été unifiée pour tous les moteurs.
- Si la base de données le gère, les moteurs peuvent définir `DatabaseFeatures.can_return_ids_from_bulk_insert=True` et implémenter `DatabaseOperations.fetch_returned_insert_ids()` pour définir les clés primaires des objets créés par `QuerySet.bulk_create()`.
- Des paramètres nommés ont été ajoutés aux méthodes `as_sql()` de diverses expressions (`Func`, `When`, `Case` et `OrderBy`) pour permettre aux moteurs de base de données de les personnaliser sans devoir toucher à `self`, ce qui est peu sûr lors de l’emploi de plusieurs moteurs de base de données. Voir les paramètres `arg_joiner` et `**extra_context` de [`Func.as_sql()`](/fr/4.2/ref/models/expressions/#django.db.models.Func.as_sql) pour un exemple.
#### Stockage de fichier
- Les moteurs de stockage présentent dorénavant une API consciente du fuseau horaire avec de nouvelles méthodes [`get_accessed_time()`](/fr/4.2/ref/files/storage/#django.core.files.storage.Storage.get_accessed_time), [`get_created_time()`](/fr/4.2/ref/files/storage/#django.core.files.storage.Storage.get_created_time) et [`get_modified_time()`](/fr/4.2/ref/files/storage/#django.core.files.storage.Storage.get_modified_time). Elles renvoient un objet `datetime` conscient du fuseau horaire si [`USE_TZ`](/fr/4.2/ref/settings/#std-setting-USE_TZ) vaut `True` et un objet `datetime` « naïf » dans le fuseau horaire local dans le cas contraire.
- La nouvelle méthode [`Storage.generate_filename()`](/fr/4.2/ref/files/storage/#django.core.files.storage.Storage.generate_filename) facilite l’implémentation de stockages personnalisés qui n’utilisent pas les appels `os.path` qui se trouvaient précédemment dans [`FileField`](/fr/4.2/ref/models/fields/#django.db.models.FileField).
#### Formulaires
- Les contenus de la classe `Media` des formulaires et composants sont dorénavant servis par [`django.contrib.staticfiles`](/fr/4.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles) quand cette application est installée.
- La balise `` rendue par [`CharField`](/fr/4.2/ref/forms/fields/#django.forms.CharField) inclut maintenant un attribut `minlength` si le champ possède un attribut `min_length`.
- Les champs de formulaire obligatoires possèdent dorénavant l’attribut HTML `required`. Il est possible de désactiver cela en définissant l’attribut [`Form.use_required_attribute`](/fr/4.2/ref/forms/api/#django.forms.Form.use_required_attribute) à `False`. L’attribut `required` n’est pas ajouté aux formulaires groupés car la validation des navigateurs n’est pas toujours correcte quand on ajoute ou qu’on supprime de tels formulaires.
#### Vues génériques
- La classe [`View`](/fr/4.2/ref/class-based-views/base/#django.views.generic.base.View) peut dorénavant être importée depuis `django.views`.
#### Internationalisation
- La fonction utilitaire [`i18n_patterns()`](/fr/4.2/topics/i18n/translation/#django.conf.urls.i18n.i18n_patterns) peut dorénavant être utilisée dans une configuration d’URL racine désignée par [`request.urlconf`](/fr/4.2/ref/request-response/#django.http.HttpRequest.urlconf).
- En définissant le nouveau paramètre `prefix_default_language` de [`i18n_patterns()`](/fr/4.2/topics/i18n/translation/#django.conf.urls.i18n.i18n_patterns) à `False`, vous pouvez autoriser l’accès à la langue par défaut sans préfixe d’URL.
- [`set_language()`](/fr/4.2/topics/i18n/translation/#django.views.i18n.set_language) renvoie désormais un code de statut 204 (Pas de contenu) pour les requêtes AJAX lorsque `POST` ou `GET` ne contiennent pas de paramètre `next`.
- Les vues fondées sur des classes [`JavaScriptCatalog`](/fr/4.2/topics/i18n/translation/#django.views.i18n.JavaScriptCatalog) et [`JSONCatalog`](/fr/4.2/topics/i18n/translation/#django.views.i18n.JSONCatalog) remplacent les vues fondées sur des fonctions `javascript_catalog()` et `json_catalog()`. Les nouvelles vues sont presque équivalentes aux anciennes sauf que par défaut les nouvelles vues collectent toutes les chaînes JavaScript de toutes les applications installées dans le domaine de traduction `djangojs` au lieu de seulement récolter les chaînes JavaScript provenant des chemins [`LOCALE_PATHS`](/fr/4.2/ref/settings/#std-setting-LOCALE_PATHS).
#### Commandes d’administration
- [`call_command()`](/fr/4.2/ref/django-admin/#django.core.management.call_command) renvoie dorénavant la valeur reçue de la méthode `command.handle()`.
- La nouvelle option [`check --fail-level`](/fr/4.2/ref/django-admin/#cmdoption-check-fail-level) permet de définir le niveau de message qui produira la sortie de la commande avec un code d’état différent de zéro.
- La nouvelle option [`makemigrations --check`](/fr/4.2/ref/django-admin/#cmdoption-makemigrations-check) fait quitter la commande avec un statut différent de 0 lorsque des modifications de modèles sans migration correspondante sont détectés.
- [`makemigrations`](/fr/4.2/ref/django-admin/#django-admin-makemigrations) affiche dorénavant le chemin vers les fichiers de migration qu’elle génère.
- L’option [`shell --interface`](/fr/4.2/ref/django-admin/#cmdoption-shell-interface) accepte dorénavant `python` pour forcer l’utilisation de l’interpréteur Python « pur ».
- La nouvelle option [`shell --command`](/fr/4.2/ref/django-admin/#cmdoption-shell-command) permet d’exécuter une commande depuis Django et quitter, au lieu d’ouvrir le shell interactif.
- [`dumpdata`](/fr/4.2/ref/django-admin/#django-admin-dumpdata) émet un avertissement si un modèle mandataire est spécifié (qui ne produit aucun résultat) sans son parent concret.
- Le nouvel attribut [`BaseCommand.requires_migrations_checks`](/fr/4.2/howto/custom-management-commands/#django.core.management.BaseCommand.requires_migrations_checks) peut être défini à `True` si vous souhaitez que la commande affiche un avertissement, comme le fait [`runserver`](/fr/4.2/ref/django-admin/#django-admin-runserver), quand le jeu de migrations sur disque ne correspond pas aux migrations dans la base de données.
- Pour aider dans les tests, [`call_command()`](/fr/4.2/ref/django-admin/#django.core.management.call_command) accepte dorénavant un objet commande comme premier paramètre.
- The [`shell`](/fr/4.2/ref/django-admin/#django-admin-shell) command supports tab completion on systems using
`libedit`, e.g. macOS.
- La commande [`inspectdb`](/fr/4.2/ref/django-admin/#django-admin-inspectdb) permet de choisir les tables à inspecter en indiquant leur nom en paramètre.
#### Migrations
- La prise en charge de la sérialisation d’objets `enum.Enum` a été ajoutée.
- Le paramètre `elidable` a été ajouté aux opérations [`RunSQL`](/fr/4.2/ref/migration-operations/#django.db.migrations.operations.RunSQL) et [`RunPython`](/fr/4.2/ref/migration-operations/#django.db.migrations.operations.RunPython) pour indiquer qu’elles doivent être supprimées lors de la fusion des migrations.
- La prise en charge des [migrations non atomiques](/fr/4.2/howto/writing-migrations/#non-atomic-migrations) a été ajoutée en définissant l’attribut `atomic` d’une classe `Migration`.
- The `migrate` and `makemigrations` commands now [check for a
consistent migration history](/fr/4.2/topics/migrations/#migration-history-consistency). If they find
some unapplied dependencies of an applied migration,
`InconsistentMigrationHistory` is raised.
- Les signaux [`pre_migrate()`](/fr/4.2/ref/signals/#django.db.models.signals.pre_migrate) et [`post_migrate()`](/fr/4.2/ref/signals/#django.db.models.signals.post_migrate) propagent dorénavant le `plan` et les `apps` de la migration.
#### Modèles
- Les clés étrangères inverses de modèles mandataires sont dorénavant propagées vers leur classe concrète. La relation inverse liée par une clé [`ForeignKey`](/fr/4.2/ref/models/fields/#django.db.models.ForeignKey) pointant vers un modèle mandataire est dorénavant accessible sous forme de descripteur sur la classe de modèle mandatée et peut être référencée dans des filtres de requête.
- La nouvelle méthode [`Field.rel_db_type()`](/fr/4.2/ref/models/fields/#django.db.models.Field.rel_db_type) renvoie le type de donnée de la colonne de la base de données, tel que `ForeignKey` et `OneToOneField` qui pointent vers un autre champ.
- L’attribut de classe [`arity`](/fr/4.2/ref/models/expressions/#django.db.models.Func.arity) a été ajouté à [`Func`](/fr/4.2/ref/models/expressions/#django.db.models.Func). Cet attribut est utilisé pour définir le nombre de paramètres acceptés par la fonction.
- Le nouveau champ [`BigAutoField`](/fr/4.2/ref/models/fields/#django.db.models.BigAutoField) est très similaire à [`AutoField`](/fr/4.2/ref/models/fields/#django.db.models.AutoField) sauf qu’il garantit la couverture des nombres de `1` à `9223372036854775807`.
- [`QuerySet.in_bulk()`](/fr/4.2/ref/models/querysets/#django.db.models.query.QuerySet.in_bulk) peut être appelée sans paramètre pour renvoyer tous les objets du jeu de requête.
- [`related_query_name`](/fr/4.2/ref/models/fields/#django.db.models.ForeignKey.related_query_name) prend désormais en charge l’extrapolation de l’étiquette d’application et de la classe en utilisant les chaînes `'%(app_label)s'` et `'%(class)s'`.
- Il est dorénavant autorisé de surcharger des champs de modèles hérités de classes de base abstraites.
- La fonction [`prefetch_related_objects()`](/fr/4.2/ref/models/querysets/#django.db.models.prefetch_related_objects) est maintenant une API publique.
- [`QuerySet.bulk_create()`](/fr/4.2/ref/models/querysets/#django.db.models.query.QuerySet.bulk_create) définit la clé primaire des objets quand on l’utilise avec PostgreSQL.
- La fonction de base de données [`Cast`](/fr/4.2/ref/models/database-functions/#django.db.models.functions.Cast) a été ajoutée.
- Un modèle mandataire peut dorénavant hériter de plusieurs modèles mandataires partageant une classe parente commune non abstraite.
- Added [`Extract`](/fr/4.2/ref/models/database-functions/#django.db.models.functions.Extract) functions to extract
datetime components as integers, such as year and hour.
- Added [`Trunc`](/fr/4.2/ref/models/database-functions/#django.db.models.functions.Trunc) functions to truncate a date
or datetime to a significant component. They enable queries like
sales-per-day or sales-per-hour.
- `Model.__init__()` définit dorénavant les valeurs de champs virtuels à partir de ses paramètres nommés.
- Les nouvelles options [`Meta.base_manager_name`](/fr/4.2/ref/models/options/#django.db.models.Options.base_manager_name) et [`Meta.default_manager_name`](/fr/4.2/ref/models/options/#django.db.models.Options.default_manager_name) permettent de contrôler respectivement les attributs [`_base_manager`](/fr/4.2/topics/db/managers/#django.db.models.Model._base_manager) et [`_default_manager`](/fr/4.2/topics/db/managers/#django.db.models.Model._default_manager).
#### Requêtes et réponses
- `request.user` a été ajoutée à la vue de débogage.
- Les méthodes [`readable()`](/fr/4.2/ref/request-response/#django.http.HttpResponse.readable) et [`seekable()`](/fr/4.2/ref/request-response/#django.http.HttpResponse.seekable) ont été ajoutées à [`HttpResponse`](/fr/4.2/ref/request-response/#django.http.HttpResponse) pour en faire une instance d’objet de type flux et permettre de l’adapter dans une classe [`io.TextIOWrapper`](https://docs.python.org/3/library/io.html#io.TextIOWrapper).
- Added the [`HttpRequest.content_type`](/fr/4.2/ref/request-response/#django.http.HttpRequest.content_type) and
[`content_params`](/fr/4.2/ref/request-response/#django.http.HttpRequest.content_params) attributes which are
parsed from the `CONTENT_TYPE` header.
- L’analyseur de `request.COOKIES` a été simplifié pour mieux correspondre au comportement des navigateurs. `request.COOKIES` peut dorénavant contenir des cookies non valides selon la [**RFC 6265**](https://datatracker.ietf.org/doc/html/rfc6265.html) mais qui peuvent quand même être définis via `document.cookie`.
#### Sérialisation
- `django.core.serializers.json.DjangoJSONEncoder` sait dorénavant sérialiser des chaînes différées, typiquement utilisées pour du contenu traduisible.
#### Gabarits
- L’option `autoescape` a été ajoutée au moteur [`DjangoTemplates`](/fr/4.2/topics/templates/#django.template.backends.django.DjangoTemplates) et à la classe [`Engine`](/fr/4.2/ref/templates/api/#django.template.Engine).
- Les opérateurs de comparaison `is` et `is not` ont été ajoutée à la balise [`if`](/fr/4.2/ref/templates/builtins/#std-templatetag-if).
- [`dictsort`](/fr/4.2/ref/templates/builtins/#std-templatefilter-dictsort) peut maintenant trier une liste de listes par un élément d’un indice donné.
- Le processeur de contexte [`debug()`](/fr/4.2/ref/templates/api/#django.template.context_processors.debug) contient les requêtes de tous les alias de base de données, et non plus seulement celles de l’alias par défaut.
- Les balises de gabarit [`extends`](/fr/4.2/ref/templates/builtins/#std-templatetag-extends) et [`include`](/fr/4.2/ref/templates/builtins/#std-templatetag-include) prennent dorénavant en charge des chemins relatifs pour leurs paramètres sous forme de chaîne.
#### Tests
- Pour mieux éviter les bugs, [`TestCase`](/fr/4.2/topics/testing/tools/#django.test.TestCase) contrôle dorénavant les contraintes de base de données différables à la fin de chaque test.
- Les tests et les cas de test peuvent être [marqués par des étiquettes](/fr/4.2/topics/testing/tools/#topics-tagging-tests) et exécutés de manière sélective grâce aux nouvelles options [`test --tag`](/fr/4.2/ref/django-admin/#cmdoption-test-tag) et [`test --exclude-tag`](/fr/4.2/ref/django-admin/#cmdoption-test-exclude-tag).
- Il est maintenant possible de se connecter et d’utiliser des sessions avec le client de test même si [`django.contrib.sessions`](/fr/4.2/topics/http/sessions/#module-django.contrib.sessions) ne se trouve pas dans [`INSTALLED_APPS`](/fr/4.2/ref/settings/#std-setting-INSTALLED_APPS).
#### URL
- Un ajout à [`django.setup()`](/fr/4.2/ref/applications/#django.setup) permet à la résolution d’URL qui intervient en dehors du cycle requête/réponse (par ex. dans les commandes d’administration et les scripts autonomes) de prendre en compte [`FORCE_SCRIPT_NAME`](/fr/4.2/ref/settings/#std-setting-FORCE_SCRIPT_NAME) lorsque celui-ci est défini.
#### Validateurs
- [`URLValidator`](/fr/4.2/ref/validators/#django.core.validators.URLValidator) limite dorénavant la longueur des parties de noms de domaine à 63 caractères et la longueur totale des noms de domaines à 253 caractères, en accord avec la [**RFC 1034**](https://datatracker.ietf.org/doc/html/rfc1034.html).
- [`int_list_validator()`](/fr/4.2/ref/validators/#django.core.validators.int_list_validator) accepte dorénavant un paramètre booléen facultatif `allow_negative`, valant `False` par défaut, pour autoriser les entiers négatifs.
## Changements incompatibles avec les anciennes versions dans Django 1.10
> **Warning**
>
> En plus des modifications détaillées dans cette section, prenez soin de parcourir les [Fonctionnalités supprimées dans 1.10](#removed-features-1-10) énumérant les fonctionnalités ayant terminé leur cycle d’obsolescence et qui ont donc été supprimées. Si vous n’avez pas mis à jour votre code dans le temps imparti par la période d’obsolescence d’une certaine fonctionnalité, sa suppression pourrait apparaître comme un changement incompatible avec les anciennes versions.
### API de moteur de base de données
- Le champ GIS `AreaField` utilise un type numérique non spécifié qui pourrait être en pratique tout type numérique Python. Les valeurs `decimal.Decimal` provenant de la base de données sont dorénavant converties en `float` pour faciliter leur combinaison avec des valeurs utilisées par les bibliothèques GIS.
- In order to enable temporal subtraction you must set the
`supports_temporal_subtraction` database feature flag to `True` and
implement the `DatabaseOperations.subtract_temporals()` method. This
method should return the SQL and parameters required to compute the
difference in microseconds between the `lhs` and `rhs` arguments in the
datatype used to store [`DurationField`](/fr/4.2/ref/models/fields/#django.db.models.DurationField).
### `select_related()` prohibits non-relational fields for nested relations
Django 1.8 added validation for non-relational fields in `select_related()`:
```pycon
>>> Book.objects.select_related("title")
Traceback (most recent call last):
...
FieldError: Non-relational field given in select_related: 'title'
```
But it didn’t prohibit nested non-relation fields as it does now:
```pycon
>>> Book.objects.select_related("author__name")
Traceback (most recent call last):
...
FieldError: Non-relational field given in select_related: 'name'
```
### `_meta.get_fields()` returns consistent reverse fields for proxy models
Before Django 1.10, the [`get_fields()`](/fr/4.2/ref/models/meta/#django.db.models.options.Options.get_fields)
method returned different reverse fields when called on a proxy model compared
to its proxied concrete class. This inconsistency was fixed by returning the
full set of fields pointing to a concrete class or one of its proxies in both
cases.
### [`AbstractUser.username`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.models.User.username) `max_length` increased to 150
A migration for [`django.contrib.auth.models.User.username`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.models.User.username) is included.
If you have a custom user model inheriting from `AbstractUser`, you’ll need
to generate and apply a database migration for your user model.
We considered an increase to 254 characters to more easily allow the use of
email addresses (which are limited to 254 characters) as usernames but rejected
it due to a MySQL limitation. When using the `utf8mb4` encoding (recommended
for proper Unicode support), MySQL can only create unique indexes with 191
characters by default. Therefore, if you need a longer length, please use a
custom user model.
If you want to preserve the 30 character limit for usernames, use a custom form
when creating a user or changing usernames:
```
from django.contrib.auth.forms import UserCreationForm
class MyUserCreationForm(UserCreationForm):
username = forms.CharField(
max_length=30,
help_text="Required. 30 characters or fewer. Letters, digits and @/./+/-/_ only.",
)
```
If you wish to keep this restriction in the admin, set `UserAdmin.add_form`
to use this form:
```
from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
from django.contrib.auth.models import User
class UserAdmin(BaseUserAdmin):
add_form = MyUserCreationForm
admin.site.unregister(User)
admin.site.register(User, UserAdmin)
```
### Abandon de la prise en charge de PostgreSQL 9.1
La prise en charge de PostgreSQL 9.1 par le projet amont se termine en septembre 2016. Par conséquent, Django 1.10 a défini la version 9.2 comme la version minimum de PostgreSQL officiellement prise en charge.
### La sortie de `runserver` passe par l’infrastructure de journalisation
Request and response handling of the `runserver` command is sent to the
[django.server](/fr/4.2/ref/logging/#django-server-logger) logger instead of to `sys.stderr`. If you
disable Django’s logging configuration or override it with your own, you’ll
need to add the appropriate logging configuration if you want to see that
output:
```
LOGGING = {
# ...
"formatters": {
"django.server": {
"()": "django.utils.log.ServerFormatter",
"format": "[%(server_time)s] %(message)s",
}
},
"handlers": {
"django.server": {
"level": "INFO",
"class": "logging.StreamHandler",
"formatter": "django.server",
},
},
"loggers": {
"django.server": {
"handlers": ["django.server"],
"level": "INFO",
"propagate": False,
}
},
}
```
### `auth.CustomUser` and `auth.ExtensionUser` test models were removed
Since the introduction of migrations for the contrib apps in Django 1.8, the
tables of these custom user test models were not created anymore making them
unusable in a testing context.
### Apps registry is no longer auto-populated when unpickling models outside of Django
The apps registry is no longer auto-populated when unpickling models. This was
added in Django 1.7.2 as an attempt to allow unpickling models outside of
Django, such as in an RQ worker, without calling `django.setup()`, but it
creates the possibility of a deadlock. To adapt your code in the case of RQ,
you can [provide your own worker script](https://python-rq.org/docs/workers/)
that calls `django.setup()`.
### Removed null assignment check for non-null foreign key fields
In older versions, assigning `None` to a non-nullable `ForeignKey` or
`OneToOneField` raised `ValueError('Cannot assign None: "model.field" does
not allow null values.')`. For consistency with other model fields which don’t
have a similar check, this check is removed.
### Removed weak password hashers from the default `PASSWORD_HASHERS` setting
Django 0.90 stored passwords as unsalted MD5. Django 0.91 added support for
salted SHA1 with automatic upgrade of passwords when a user logs in. Django 1.4
added PBKDF2 as the default password hasher.
If you have an old Django project with MD5 or SHA1 (even salted) encoded
passwords, be aware that these can be cracked fairly easily with today’s
hardware. To make Django users acknowledge continued use of weak hashers, the
following hashers are removed from the default [`PASSWORD_HASHERS`](/fr/4.2/ref/settings/#std-setting-PASSWORD_HASHERS)
setting:
```
"django.contrib.auth.hashers.SHA1PasswordHasher"
"django.contrib.auth.hashers.MD5PasswordHasher"
"django.contrib.auth.hashers.UnsaltedSHA1PasswordHasher"
"django.contrib.auth.hashers.UnsaltedMD5PasswordHasher"
"django.contrib.auth.hashers.CryptPasswordHasher"
```
Consider using a [wrapped password hasher](/fr/4.2/topics/auth/passwords/#wrapping-password-hashers) to
strengthen the hashes in your database. If that’s not feasible, add the
[`PASSWORD_HASHERS`](/fr/4.2/ref/settings/#std-setting-PASSWORD_HASHERS) setting to your project and add back any hashers
that you need.
You can check if your database has any of the removed hashers like this:
```
from django.contrib.auth import get_user_model
User = get_user_model()
# Unsalted MD5/SHA1:
User.objects.filter(password__startswith="md5$$")
User.objects.filter(password__startswith="sha1$$")
# Salted MD5/SHA1:
User.objects.filter(password__startswith="md5$").exclude(password__startswith="md5$$")
User.objects.filter(password__startswith="sha1$").exclude(password__startswith="sha1$$")
# Crypt hasher:
User.objects.filter(password__startswith="crypt$$")
from django.db.models import CharField
from django.db.models.functions import Length
CharField.register_lookup(Length)
# Unsalted MD5 passwords might not have an 'md5$$' prefix:
User.objects.filter(password__length=32)
```
### `Field.get_prep_lookup()` and `Field.get_db_prep_lookup()` methods are removed
If you have a custom field that implements either of these methods, register a
custom lookup for it. For example:
```
from django.db.models import Field
from django.db.models.lookups import Exact
class MyField(Field):
...
class MyFieldExact(Exact):
def get_prep_lookup(self):
# do_custom_stuff_for_myfield
...
MyField.register_lookup(MyFieldExact)
```
### [`django.contrib.gis`](/fr/4.2/ref/contrib/gis/#module-django.contrib.gis)
- Support for SpatiaLite \< 3.0 and GEOS \< 3.3 is dropped.
- The `add_postgis_srs()` backwards compatibility alias for
`django.contrib.gis.utils.add_srs_entry()` is removed.
- On Oracle/GIS, the [`Area`](/fr/4.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.Area)
aggregate function now returns a `float` instead of `decimal.Decimal`.
(It’s still wrapped in a measure of square meters.)
- The default [`GEOSGeometry`](/fr/4.2/ref/contrib/gis/geos/#django.contrib.gis.geos.GEOSGeometry) representation (WKT
output) is trimmed by default. That is, instead of
`POINT (23.0000000000000000 5.5000000000000000)`, you’ll get
`POINT (23 5.5)`.
### Maximum size of a request body and the number of GET/POST parameters is limited
Two new settings help mitigate denial-of-service attacks via large requests:
- [`DATA_UPLOAD_MAX_MEMORY_SIZE`](/fr/4.2/ref/settings/#std-setting-DATA_UPLOAD_MAX_MEMORY_SIZE) limits the size that a request body
may be. File uploads don’t count toward this limit.
- [`DATA_UPLOAD_MAX_NUMBER_FIELDS`](/fr/4.2/ref/settings/#std-setting-DATA_UPLOAD_MAX_NUMBER_FIELDS) limits the number of GET/POST
parameters that are parsed.
Applications that receive unusually large form posts may need to tune these
settings.
### Divers
- The `repr()` of a `QuerySet` is wrapped in `` to
disambiguate it from a plain list when debugging.
- `utils.version.get_version()` returns [**PEP 440**](https://peps.python.org/pep-0440/) compliant release
candidate versions (e.g. “1.10rc1” instead of “1.10c1”).
- CSRF token values are now required to be strings of 64 alphanumerics; values
of 32 alphanumerics, as set by older versions of Django by default, are
automatically replaced by strings of 64 characters. Other values are
considered invalid. This should only affect developers or users who replace
these tokens.
- The `LOGOUT_URL` setting is removed as Django hasn’t made use of it
since pre-1.0. If you use it in your project, you can add it to your
project’s settings. The default value was `'/accounts/logout/'`.
- Objects with a `close()` method such as files and generators passed to
[`HttpResponse`](/fr/4.2/ref/request-response/#django.http.HttpResponse) are now closed immediately instead of when
the WSGI server calls `close()` on the response.
- A redundant `transaction.atomic()` call in `QuerySet.update_or_create()`
is removed. This may affect query counts tested by
`TransactionTestCase.assertNumQueries()`.
- Support for `skip_validation` in `BaseCommand.execute(**options)` is
removed. Use `skip_checks` (added in Django 1.7) instead.
- [`loaddata`](/fr/4.2/ref/django-admin/#django-admin-loaddata) now raises a `CommandError` instead of showing a
warning when the specified fixture file is not found.
- Instead of directly accessing the `LogEntry.change_message` attribute, it’s
now better to call the `LogEntry.get_change_message()` method which will
provide the message in the current language.
- The default error views now raise `TemplateDoesNotExist` if a nonexistent
`template_name` is specified.
- The unused `choices` keyword argument of the `Select` and
`SelectMultiple` widgets” `render()` method is removed. The `choices`
argument of the `render_options()` method is also removed, making
`selected_choices` the first argument.
- Tests that violate deferrable database constraints will now error when run on
a database that supports deferrable constraints.
- Built-in management commands now use indexing of keys in `options`, e.g.
`options['verbosity']`, instead of `options.get()` and no longer perform
any type coercion. This could be a problem if you’re calling commands using
`Command.execute()` (which bypasses the argument parser that sets a default
value) instead of [`call_command()`](/fr/4.2/ref/django-admin/#django.core.management.call_command). Instead of
calling `Command.execute()`, pass the command object as the first argument
to `call_command()`.
- [`ModelBackend`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.backends.ModelBackend) and
[`RemoteUserBackend`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.backends.RemoteUserBackend) now reject inactive
users. This means that inactive users can’t login and will be logged
out if they are switched from `is_active=True` to `False`. If you need
the previous behavior, use the new
[`AllowAllUsersModelBackend`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.backends.AllowAllUsersModelBackend) or
[`AllowAllUsersRemoteUserBackend`](/fr/4.2/ref/contrib/auth/#django.contrib.auth.backends.AllowAllUsersRemoteUserBackend)
in [`AUTHENTICATION_BACKENDS`](/fr/4.2/ref/settings/#std-setting-AUTHENTICATION_BACKENDS) instead.
- In light of the previous change, the test client’s
[`login()`](/fr/4.2/topics/testing/tools/#django.test.Client.login) method no longer always rejects inactive
users but instead delegates this decision to the authentication backend.
[`force_login()`](/fr/4.2/topics/testing/tools/#django.test.Client.force_login) also delegates the decision to the
authentication backend, so if you’re using the default backends, you need to
use an active user.
- [`django.views.i18n.set_language()`](/fr/4.2/topics/i18n/translation/#django.views.i18n.set_language) may now return a 204 status code for
AJAX requests.
- The `base_field` attribute of
[`RangeField`](/fr/4.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.RangeField) is now a type of field,
not an instance of a field. If you have created a custom subclass of
[`RangeField`](/fr/4.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.RangeField), you should change the
`base_field` attribute.
- Middleware classes are now initialized when the server starts rather than
during the first request.
- If you override `is_authenticated()` or `is_anonymous()` in a custom user
model, you must convert them to attributes or properties as described in
[the deprecation note](#user-is-auth-anon-deprecation).
- When using [`ModelAdmin.save_as=True`](/fr/4.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin.save_as), the « Save as new » button now
redirects to the change view for the new object instead of to the model’s
changelist. If you need the previous behavior, set the new
[`ModelAdmin.save_as_continue`](/fr/4.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin.save_as_continue) attribute to `False`.
- Required form fields now have the `required` HTML attribute. Set the
[`Form.use_required_attribute`](/fr/4.2/ref/forms/api/#django.forms.Form.use_required_attribute)
attribute to `False` to disable it. You could also add the `novalidate`
attribute to `