--- title: "Notes de publication de Django 1.7" version: 3.1 locale: fr source: https://docs.djangoproject.com/fr/3.1/releases/1.7/ canonical: https://djangodocs.dev/fr/3.1/releases/1.7/ --- # Notes de publication de Django 1.7 *2 Septembre 2014* Bienvenue dans Django 1.7 ! These release notes cover the [new features](#whats-new-1-7), as well as some [backwards incompatible changes](#backwards-incompatible-1-7) you’ll want to be aware of when upgrading from Django 1.6 or older versions. We’ve [begun the deprecation process for some features](#deprecated-features-1-7), and some features have reached the end of their deprecation process and [have been removed](#removed-features-1-7). ## Compatibilité Python Django 1.7 requires Python 2.7, 3.2, 3.3, or 3.4. We **highly recommend** and only officially support the latest release of each series. The Django 1.6 series is the last to support Python 2.6. Django 1.7 is the first release to support Python 3.4. Ce changement devrait affecter seulement un petit nombre d’utilisateurs de Django, puisque, aujourd’hui, la plupart des fournisseurs de système d’exploitation livrent Python 2.7 ou plus récent comme version par défaut. Cependant, si vous utilisez encore Python 2.6, vous aurez besoin de rester à Django 1.6 jusqu’à ce que vous puissiez mettre à jour votre version de Python. Selon [notre politique de support](/fr/3.1/internals/release-process/), Django 1.6 continuera d’être supporté au niveau sécurité jusqu’à la sortie de Django 1.8. ## Quoi de neuf dans Django 1.7 ### Migrations de schéma Django a maintenant un support intégré des migrations de schéma. Il permet aux modèles d’être mis à jour, modifiés et supprimés par la création de fichiers de migration qui représentent les changements du modèle et qui peuvent être exécutés sur toute base de données de développement, de pré-production ou de production. Les migrations sont couvertes dans [leur propre documentation](/fr/3.1/topics/migrations/), mais quelques-unes des fonctionalités clés sont : - `syncdb` a été dépréciée et remplacée par `migrate`. Ne vous inquiétez pas – les appels à `syncdb` fonctionneront toujours comme avant. - Une nouvelle commande `makemigrations` fournit un moyen facile de détecter automatiquement les modifications de vos modèles et d’effectuer des migrations pour ceux-ci. `django.db.models.signals.pre_syncdb` and `django.db.models.signals.post_syncdb` have been deprecated, to be replaced by [`pre_migrate`](/fr/3.1/ref/signals/#django.db.models.signals.pre_migrate) and [`post_migrate`](/fr/3.1/ref/signals/#django.db.models.signals.post_migrate) respectively. These new signals have slightly different arguments. Check the documentation for details. - La méthode `allow_syncdb` des routeurs de base de données est désormais appelé `allow_migrate`, mais effectue toujours la même fonction. Les routeurs avec des méthodes `allow_syncdb` fonctionneront toujours, mais ce nom de méthode est obsolète et vous devriez en changer dès que possible (rien de plus que le renommage est nécessaire). - `initial_data` fixtures are no longer loaded for apps with migrations; if you want to load initial data for an app, we suggest you create a migration for your application and define a [`RunPython`](/fr/3.1/ref/migration-operations/#django.db.migrations.operations.RunPython) or [`RunSQL`](/fr/3.1/ref/migration-operations/#django.db.migrations.operations.RunSQL) operation in the `operations` section of the migration. - Le comportement de restauration du test est différent pour les applications avec des migrations; en particulier, Django n’émulera plus les restaurations pour les bases de données non transactionnelles ou à l’intérieur de `TransactionTestCase` [sauf demande expresse](/fr/3.1/topics/testing/overview/#test-case-serialized-rollback). - It is not advised to have apps without migrations depend on (have a [`ForeignKey`](/fr/3.1/ref/models/fields/#django.db.models.ForeignKey) or [`ManyToManyField`](/fr/3.1/ref/models/fields/#django.db.models.ManyToManyField) to) apps with migrations. ### Réusinage du chargement des applications Historiquement, les applications Django étaient étroitement liés aux modèles. Un singleton connu comme le « app cache » gérait à la fois les applications et les modèles installés. Le module de modèles était utilisé comme un identificateur pour les applications dans de nombreuses API. Étant donné que le concept d”[applications Django](/fr/3.1/ref/applications/) mûrit, ce code a montré certaines lacunes. Il a été remanié en un « app registry » où les modules de modèles n’ont plus un rôle central et où il est possible de joindre des données de configuration aux applications. Les améliorations comprennent à ce jour : - Les applications peuvent exécuter du code au démarrage, avant que Django ne fasse quoi que ce soit d’autre, avec la méthode [`ready()`](/fr/3.1/ref/applications/#django.apps.AppConfig.ready) de leur configuration. - Les étiquettes d’application sont correctement affectées à des modèles, même quand ils sont définis en dehors de `models.py`. Vous n’avez plus besoin de régler explicitement [`app_label`](/fr/3.1/ref/models/options/#django.db.models.Options.app_label). - Il est possible d’omettre `models.py` entièrement si une application ne possède pas de modèles. - Les applications peuvent être rebaptisées avec l’attribut [`label`](/fr/3.1/ref/applications/#django.apps.AppConfig.label) des configurations d’application, afin de contourner des conflits de nommage d’étiquettes. - Le nom des applications peut être personnalisé dans l’interface d’administration avec l’attribut [`verbose_name`](/fr/3.1/ref/applications/#django.apps.AppConfig.verbose_name) des configurations d’application. - L’interface d’administration appelle automatiquement [`autodiscover()`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.autodiscover) au lancement de Django. Vous pouvez donc supprimer cette ligne de votre URLconf. - Django importe toutes les configurations d’application et les modèles dès qu’il se lance, au travers d’un processus déterministe et simple. Cela devrait rendre plus facile de diagnostiquer des problèmes d’importation tels que des boucles d’importation. ### Nouvelle méthode sur les sous-classes de Field Pour aider à motoriser à la fois les migrations de schéma et permettre l’ajout plus simple de clés composites dans les futures versions de Django, l’API de [`Field`](/fr/3.1/ref/models/fields/#django.db.models.Field) a maintenant une nouvelle méthode obligatoire : `deconstruct()`. Cette méthode ne prend aucun argument, et retourne un tuple de quatre éléments : - `name`: The field’s attribute name on its parent model, or `None` if it is not part of a model - `path` : Un chemin Python à syntaxe pointée vers la classe de ce champ, y compris le nom de la classe. - `args` : arguments positionnels, en tant que liste - `kwargs` : arguments nommés, en tant que dict Ces quatre valeurs permettent à n’importe quel champ d’être sérialisé dans un fichier, ainsi que d’être copié en toute sécurité, deux parties essentielles de ces nouvelles fonctionnalités. Ce changement ne devrait pas vous affecter à moins que vous n’écriviez des sous-classes personnalisées de Field; si c’est le cas, vous devrez peut-être ré-implémenter la méthode `deconstruct()` si votre sous-classe modifie la signature de la méthode `__init__` d’une manière ou d’une autre. Si votre champ hérite juste d’un champ intégré dans Django et n’étend pas `__init__`, aucune modification n’est nécessaire. Si vous avez besoin d’étendre `deconstruct()`, un bon endroit pour commencer sont les champs intégrés dans Django (`django/db/models/fields/__init__.py`) car plusieurs champs, y compris `DecimalField` et `DateField`, l’étendent et montrent comment appeler la méthode sur la classe mère et simplement ajouter ou supprimer des arguments supplémentaires. Cela signifie également que tous les arguments de champs doivent eux-mêmes être sérialisable; pour voir ce que nous considérons comme sérialisable, et trouver comment rendre vos propres classes sérialisables, consultez la [documentation de sérialisation de la migration](/fr/3.1/topics/migrations/#migration-serializing). ### Appel personnalisé de méthodes `QuerySet` depuis le `Manager` Historiquement, la méthode recommandée pour réaliser des requêtes de modèles réutilisables était de créer des méthodes sur une classe `Manager` personnalisée. Le problème avec cette approche est qu’après le premier appel de méthode, vous obtenez une instance de `QuerySet` et ne pouvez pas appeler de méthodes supplémentaires du gestionnaire personnalisé. Bien que n’étant pas documentée, il était courant de contourner ce problème en créant une `QuerySet` personnalisée afin que les méthodes personnalisées puissent être chaînées; mais la solution avait un certain nombre d’inconvénients : - La `QuerySet` personnalisée et ses méthodes sur mesure étaient perdues après le premier appel à `values()` ou `values_list()`. - La rédaction d’un `Manager` sur mesure était encore nécessaire afin de retourner la classe `QuerySet` personnalisée et toutes les méthodes souhaitées sur le \`\` Manager\`\` devaient être redirigées vers la `QuerySet`. L’ensemble du processus était contraire au principe DRY. La méthode de classe [`QuerySet.as_manager()`](/fr/3.1/ref/models/querysets/#django.db.models.query.QuerySet.as_manager) peut désormais directement [créer un Manager avec des méthodes de QuerySet](/fr/3.1/topics/db/managers/#create-manager-with-queryset-methods) : ``` class FoodQuerySet(models.QuerySet): def pizzas(self): return self.filter(kind='pizza') def vegetarian(self): return self.filter(vegetarian=True) class Food(models.Model): kind = models.CharField(max_length=50) vegetarian = models.BooleanField(default=False) objects = FoodQuerySet.as_manager() Food.objects.pizzas().vegetarian() ``` ### Utilisation d’un gestionnaire personnalisé lors de la traversée des relations inverses Il est maintenant possible de [spécifier un gestionnaire personnalisé](/fr/3.1/topics/db/queries/#using-custom-reverse-manager) lors de la traversée d’une relation inverse : ``` class Blog(models.Model): pass class Entry(models.Model): blog = models.ForeignKey(Blog) objects = models.Manager() # Default Manager entries = EntryManager() # Custom Manager b = Blog.objects.get(id=1) b.entry_set(manager='entries').all() ``` ### Nouvelle infrastructure de vérification système Nous avons ajouté une nouvelle [infrastructure de contrôle du système](/fr/3.1/ref/checks/) pour détecter les problèmes communs (comme les modèles non valides) et de fournir des conseils pour la résolution de ces problèmes. L’infrastructure est extensible de sorte que vous pouvez ajouter vos propres contrôles pour vos propres applications et bibliothèques. To perform system checks, you use the [`check`](/fr/3.1/ref/django-admin/#django-admin-check) management command. This command replaces the older `validate` management command. ### Nouvel objet `Prefetch` pour les opérations `prefetch_related` avancées. Le nouvel objet [`Prefetch`](/fr/3.1/ref/models/querysets/#django.db.models.Prefetch) permet de personnaliser les opérations de préchargement. Vous pouvez spécifier la `QuerySet` utilisée pour traverser une relation donnée ou personnaliser l’emplacement de stockage des résultats préchargés. Cela permet des choses comme le filtrage de relations préchargées, en appelant [`select_related()`](/fr/3.1/ref/models/querysets/#django.db.models.query.QuerySet.select_related) à partir d’une relation préchargée, ou le préchargement de la même relation plusieurs fois avec différentes querysets. Voir [`prefetch_related()`](/fr/3.1/ref/models/querysets/#django.db.models.query.QuerySet.prefetch_related) pour plus de détails. ### Les raccourcis de l’interface d’administration supporte les fuseaux horaires Les raccourcis « today » et « now » à côté des composants de saisie de la date et de l’heure dans l’interface d’administration, opèrent désormais dans le [fuseau horaire courant](/fr/3.1/topics/i18n/timezones/#default-current-time-zone). Auparavant, ils utilisaient le fuseau horaire du navigateur, ce qui pouvait entraîner la saisie de valeurs erronées quand il ne correspondait pas au fuseau horaire courant du serveur. En outre, les composants affichent désormais un message d’aide lorsque le fuseau horaire du navigateur et du serveur diffèrent, afin de préciser comment la valeur insérée dans le champ sera interprétée. ### Utilisation de curseurs de base de données en tant que gestionnaires de contexte Avant Python 2.7, les curseurs de base de données pouvaient être utilisés en tant que gestionnaire de contexte. Le curseur spécifique au moteur défini le comportement du gestionnaire de contexte. Le comportement des recherches de méthode magique a été modifié avec Python 2.7 et les curseurs ne sont plus utilisables en tant que gestionnaire de contexte. Django 1.7 permet qu’un curseur soit utilisé comme gestionnaire de contexte. Autrement dit, ce qui suit peut être utilisé : ``` with connection.cursor() as c: c.execute(...) ``` au lieu de : ``` c = connection.cursor() try: c.execute(...) finally: c.close() ``` ### Expressions de recherche personnalisées It is now possible to write custom lookups and transforms for the ORM. Custom lookups work just like Django’s built-in lookups (e.g. `lte`, `icontains`) while transforms are a new concept. La classe [`django.db.models.Lookup`](/fr/3.1/ref/models/lookups/#django.db.models.Lookup) fournit un moyen d’ajouter des opérateurs de recherches pour les champs du modèle. A titre d’exemple il est possible d’ajouter l’opérateur `day_lte` pour les `DateFields`. La classe [`django.db.models.Transform`](/fr/3.1/ref/models/lookups/#django.db.models.Transform) permet la transformation des valeurs de base de données avant la conversion finale. Par exemple, il est possible d’écrire une transformation `year` qui extrait l’année de la valeur du champ. Les transformations permettent le chaînage. Après que la transformation `year` ait été ajoutée à `DateField` il est possible de filtrer sur la valeur transformée, par exemple `qs.filter(author__birthdate__year__lte=1981)`. Pour plus d’informations sur à la fois les expressions de recherches et les transformations personnalisées reportez-vous à la documentation sur les [recherches personnalisées](/fr/3.1/howto/custom-lookups/). ### Améliorations apportées à la gestion d’erreur dans `Form` #### `Form.add_error()` Auparavant, il y avait deux principaux modèles de gestion des erreurs dans les formulaires : - Lever une [`ValidationError`](/fr/3.1/ref/exceptions/#django.core.exceptions.ValidationError) à partir de certaines fonctions (e.g. `Field.clean()`, `Form.clean_()`, ou `Form.clean()` pour les erreurs n’ayant pas attrait aux champs) - Manipuler `Form._errors` en ciblant un champ spécifique dans `Form.clean()` ou en ajoutant des erreurs via une méthode « clean » externe (e.g.i, directement depuis une vue). L’utilisation de la première pratique était simple et directe puisque le formulaire peut deviner à partir du contexte (i.e. quelle méthode a soulevé l’exception) d’où proviennent les erreurs et les traiter automatiquement. Cela reste la manière canonique d’ajouter des erreurs lorsque possible. Cependant, la dernière était fastidieuse et source d’erreurs, car l’essentiel du traitement des effets de bord incombait à l’utilisateur. La nouvelle méthode [`add_error()`](/fr/3.1/ref/forms/api/#django.forms.Form.add_error) permet d’ajouter des erreurs à des champs de formulaire spécifiques de n’importe où, sans avoir à se soucier des détails; tels que la création d’instances de `django.forms.utils.ErrorList` ou le traitement de `Form.cleaned_data`. Cette nouvelle API remplace la manipulation de `Form._errors` qui devient désormais une API privée. Voir la [Nettoyage et validation de champs qui dépendent l’un de l’autre](/fr/3.1/ref/forms/validation/#validating-fields-with-clean) pour un exemple utilisant `Form.add_error()`. #### Métadonnées d’erreur Le constructeur de [`ValidationError`](/fr/3.1/ref/exceptions/#django.core.exceptions.ValidationError) accepte des métadonnées telles que le `code` d’erreur ou `params` qui sont alors disponibles pour être interpolés dans le message d’erreur (voir [Génération de ValidationError](/fr/3.1/ref/forms/validation/#raising-validation-error) pour plus de détails); toutefois, avant Django 1.7 ces métadonnées étaient rejetées au moment où les erreurs étaient ajoutées à [`Form.errors`](/fr/3.1/ref/forms/api/#django.forms.Form.errors). [`Form.errors`](/fr/3.1/ref/forms/api/#django.forms.Form.errors) et `django.forms.utils.ErrorList` stockent maintenant les instances de `ValidationError`, donc ces métadonnées peuvent être récupérées à tout moment grâce à la nouvelle méthode [`Form.errors.as_data`](/fr/3.1/ref/forms/api/#django.forms.Form.errors.as_data). Les instances de `ValidationError` récupérées peuvent alors être identifiées grâce à leur `code` d’erreur qui permet des choses telle que la réécriture du message d’erreur ou l’écriture d’une logique personnalisée dans une vue lorsqu’une erreur donnée est présente. Elle peut également être utilisée pour sérialiser les erreurs dans un format personnalisé tel que XML. La nouvelle méthode [`Form.errors.as_json()`](/fr/3.1/ref/forms/api/#django.forms.Form.errors.as_json) est une méthode pratique qui renvoie les messages d’erreur ainsi que les codes d’erreur sérialisés en JSON. `as_json()` utilise `as_data()` et donne une idée de la manière dont le nouveau système pourrait être étendu. #### Conteneurs d’erreur et rétro-compatibilité Des changements profonds au niveau des différents conteneurs d’erreur furent nécessaires afin de supporter les caractéristiques ci-dessus, à savoir [`Form.errors`](/fr/3.1/ref/forms/api/#django.forms.Form.errors), `Django.forms.utils.ErrorList`, et les stockages interne de [`ValidationError`](/fr/3.1/ref/exceptions/#django.core.exceptions.ValidationError). Ces conteneurs auparavant utilisés pour stocker des chaînes d’erreur stockent désormais des instances de `ValidationError` et les API publiques ont été adaptées pour rendre cela aussi transparent que possible, mais si vous avez utilisé les API privées, certains des changements ne sont pas rétro-compatibles; voir [ValidationError constructor and internal storage](#validation-error-constructor-and-internal-storage) pour plus de détails. ### Fonctionnalités mineures #### [`django.contrib.admin`](/fr/3.1/ref/contrib/admin/#module-django.contrib.admin) - Vous pouvez maintenant implémenter les attributs [`site_header`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.AdminSite.site_header), [`site_title`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.AdminSite.site_title) et [`index_title`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.AdminSite.index_title) sur un [`AdminSite`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.AdminSite) personnalisé afin de changer facilement le titre et le texte d’en-tête de page du site d’administration. Plus besoin d’étendre les gabarits ! - Les boutons dans [`django.contrib.admin`](/fr/3.1/ref/contrib/admin/#module-django.contrib.admin) utilise maintenant la propriété CSS `border-radius` pour les coins arrondis plutôt que des images de fond GIF. - Certains gabarits de l’interface d’administration ont maintenant les classes `app-` and `model-` dans leur balise `` pour permettre la personnalisation de la CSS par application ou par modèle. - Les cellules de la liste d’objets pour modification de l’interface d’administration ont maintenant une classe `field-` dans le code HTML pour permettre les personnalisations stylistiques. - Les champs de recherche de l’interface d’administration peuvent désormais être personnalisés par requête grâce à la nouvelle méthode [`django.contrib.admin.ModelAdmin.get_search_fields()`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin.get_search_fields). - La méthode [`ModelAdmin.get_fields()`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin.get_fields) peut être étendue pour personnaliser la valeur de [`ModelAdmin.fields`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin.fields). - En plus de la syntaxe `admin.site.register` existante, vous pouvez utiliser le nouveau décorateur [`register()`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.register) pour enregistrer un [`ModelAdmin`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin). - Vous pouvez spécifier [`ModelAdmin.list_display_links`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin.list_display_links) `= None` pour désactiver les liens sur la grille de la page de liste des objets pour modification. - Vous pouvez maintenant spécifier [`ModelAdmin.view_on_site`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin.view_on_site) pour contrôler l’affichage ou non du lien « Voir sur le site ». - Vous pouvez spécifier un ordre décroissant pour une valeur de [`ModelAdmin.list_display`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin.list_display) en faisant précéder la valeur de `admin_order_field` avec un tiret. - La méthode [`ModelAdmin.get_changeform_initial_data()`](/fr/3.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin.get_changeform_initial_data) peut être étendue pour définir un comportement personnalisé afin de configurer les données initiales du formulaire de modification. #### [`django.contrib.auth`](/fr/3.1/topics/auth/#module-django.contrib.auth) - Tous `**kwargs` passés à [`email_user()`](/fr/3.1/ref/contrib/auth/#django.contrib.auth.models.User.email_user) sont transmis lors de l’appel sous-jacent à [`send_mail()`](/fr/3.1/topics/email/#django.core.mail.send_mail). - Le décorateur [`permission_required()`](/fr/3.1/topics/auth/default/#django.contrib.auth.decorators.permission_required) peut tout aussi bien prendre une liste d’autorisations qu’une seule autorisation. - Vous pouvez étendre la nouvelle méthode [`AuthenticationForm.confirm_login_allowed()`](/fr/3.1/topics/auth/default/#django.contrib.auth.forms.AuthenticationForm.confirm_login_allowed) afin de personnaliser plus facilement la politique d’ouverture de session. - `django.contrib.auth.views.password_reset()` takes an optional `html_email_template_name` parameter used to send a multipart HTML email for password resets. - The [`AbstractBaseUser.get_session_auth_hash()`](/fr/3.1/topics/auth/customizing/#django.contrib.auth.models.AbstractBaseUser.get_session_auth_hash) method was added and if your [`AUTH_USER_MODEL`](/fr/3.1/ref/settings/#std-setting-AUTH_USER_MODEL) inherits from [`AbstractBaseUser`](/fr/3.1/topics/auth/customizing/#django.contrib.auth.models.AbstractBaseUser), changing a user’s password now invalidates old sessions if the `django.contrib.auth.middleware.SessionAuthenticationMiddleware` is enabled. See [Invalidation de session lors du changement de mot de passe](/fr/3.1/topics/auth/default/#session-invalidation-on-password-change) for more details. #### `django.contrib.formtools` - Calls to `WizardView.done()` now include a `form_dict` to allow easier access to forms by their step name. #### [`django.contrib.gis`](/fr/3.1/ref/contrib/gis/#module-django.contrib.gis) - La version de la bibliothèque OpenLayers par défaut inclus dans les composants a été mise à jour, passant de la 2.11 à 2.13. - Les géométries préparées supportent maintenant les prédicats `crosses`, `disjoint`, `overlaps`, `touches` et `within`, si GEOS 3.3 ou ultérieur est installé. #### [`django.contrib.messages`](/fr/3.1/ref/contrib/messages/#module-django.contrib.messages) - Les moteurs de [`django.contrib.messages`](/fr/3.1/ref/contrib/messages/#module-django.contrib.messages) qui utilisent des cookies respectent maintenant les réglages [`SESSION_COOKIE_SECURE`](/fr/3.1/ref/settings/#std-setting-SESSION_COOKIE_SECURE) et [`SESSION_COOKIE_HTTPONLY`](/fr/3.1/ref/settings/#std-setting-SESSION_COOKIE_HTTPONLY). - Le [processeur de contexte des messages](/fr/3.1/ref/contrib/messages/#message-displaying) ajoute maintenant un dictionnaire des niveaux par défaut sous le nom de `DEFAULT_MESSAGE_LEVELS`. - Les objets [`Message`](/fr/3.1/ref/contrib/messages/#django.contrib.messages.storage.base.Message) ont maintenant un attribut `level_tag` qui contient la représentation textuelle du niveau de message. #### [`django.contrib.redirects`](/fr/3.1/ref/contrib/redirects/#module-django.contrib.redirects) - [`RedirectFallbackMiddleware`](/fr/3.1/ref/contrib/redirects/#django.contrib.redirects.middleware.RedirectFallbackMiddleware) a deux nouveaux attributs ([`response_gone_class`](/fr/3.1/ref/contrib/redirects/#django.contrib.redirects.middleware.RedirectFallbackMiddleware.response_gone_class) et [`response_redirect_class`](/fr/3.1/ref/contrib/redirects/#django.contrib.redirects.middleware.RedirectFallbackMiddleware.response_redirect_class)) qui spécifient les types d’instances [`HttpResponse`](/fr/3.1/ref/request-response/#django.http.HttpResponse) retournées par le middleware. #### [`django.contrib.sessions`](/fr/3.1/topics/http/sessions/#module-django.contrib.sessions) - The `"django.contrib.sessions.backends.cached_db"` session backend now respects [`SESSION_CACHE_ALIAS`](/fr/3.1/ref/settings/#std-setting-SESSION_CACHE_ALIAS). In previous versions, it always used the `default` cache. #### [`django.contrib.sitemaps`](/fr/3.1/ref/contrib/sitemaps/#module-django.contrib.sitemaps) - L”[`infrastructure de plan du site`](/fr/3.1/ref/contrib/sitemaps/#module-django.contrib.sitemaps) utilise maintenant [`lastmod`](/fr/3.1/ref/contrib/sitemaps/#django.contrib.sitemaps.Sitemap.lastmod) pour définir un en-tête `Last-Modified` dans la réponse. Cela permet au [`ConditionalGetMiddleware`](/fr/3.1/ref/middleware/#django.middleware.http.ConditionalGetMiddleware) de gérer des requêtes `GET` conditionnelles pour les plans de site qui définissent `lastmod`. #### [`django.contrib.sites`](/fr/3.1/ref/contrib/sites/#module-django.contrib.sites) - Le nouveau [`django.contrib.sites.middleware.CurrentSiteMiddleware`](/fr/3.1/ref/middleware/#django.contrib.sites.middleware.CurrentSiteMiddleware) permet de définir le site courant pour chaque requête. #### [`django.contrib.staticfiles`](/fr/3.1/ref/contrib/staticfiles/#module-django.contrib.staticfiles) - Les [classes de stockage de fichiers statiques](/fr/3.1/ref/contrib/staticfiles/#staticfiles-storages) peuvent être sous-classées pour remplacer les autorisations que les fichiers statiques et répertoires collectés reçoivent en réglant les paramètres [`file_permissions_mode`](/fr/3.1/ref/files/storage/#django.core.files.storage.FileSystemStorage.file_permissions_mode) et [`directory_permissions_mode`](/fr/3.1/ref/files/storage/#django.core.files.storage.FileSystemStorage.directory_permissions_mode) . Voir [`collectstatic`](/fr/3.1/ref/contrib/staticfiles/#django-admin-collectstatic) pour un exemple d’utilisation. - The `CachedStaticFilesStorage` backend gets a sibling class called [`ManifestStaticFilesStorage`](/fr/3.1/ref/contrib/staticfiles/#django.contrib.staticfiles.storage.ManifestStaticFilesStorage) that doesn’t use the cache system at all but instead a JSON file called `staticfiles.json` for storing the mapping between the original file name (e.g. `css/styles.css`) and the hashed file name (e.g. `css/styles.55e7cbb9ba48.css`). The `staticfiles.json` file is created when running the [`collectstatic`](/fr/3.1/ref/contrib/staticfiles/#django-admin-collectstatic) management command and should be a less expensive alternative for remote storages such as Amazon S3. Voir la documentation de [`ManifestStaticFilesStorage`](/fr/3.1/ref/contrib/staticfiles/#django.contrib.staticfiles.storage.ManifestStaticFilesStorage) pour plus d’informations. - [`findstatic`](/fr/3.1/ref/contrib/staticfiles/#django-admin-findstatic) accepte maintenant une verbosité de niveau 2, ce qui signifie qu’elle affichera les chemins relatifs des répertoires qu’elle a recherché. Voir [`findstatic`](/fr/3.1/ref/contrib/staticfiles/#django-admin-findstatic) par un exemple de sortie. #### [`django.contrib.syndication`](/fr/3.1/ref/contrib/syndication/#module-django.contrib.syndication) - L’élément `updated` du flux de syndication [`Atom1Feed`](/fr/3.1/ref/utils/#django.utils.feedgenerator.Atom1Feed) utilise maintenant `updateddate` au lieu de `pubdate`, permettant à l’élément `published` d’être inclut dans le flux (qui repose sur `pubdate`). #### Cache - Access to caches configured in [`CACHES`](/fr/3.1/ref/settings/#std-setting-CACHES) is now available via [`django.core.cache.caches`](/fr/3.1/topics/cache/#django.core.cache.caches). This dict-like object provides a different instance per thread. It supersedes `django.core.cache.get_cache()` which is now deprecated. - Si vous instanciez un moteur de cache directement, soyez conscients qu’ils ne sont plus thread-safe, puisque [`django.core.cache.caches`](/fr/3.1/topics/cache/#django.core.cache.caches) génère maintenant différentes instances par thread. - Définir l’argument [`TIMEOUT`](/fr/3.1/ref/settings/#std-setting-CACHES-TIMEOUT) du réglage [`CACHES`](/fr/3.1/ref/settings/#std-setting-CACHES) à `None` définiera les clés du cache comme « n’expirant pas » par défaut. Auparavant, il était seulement possible de passer `timeout = None` à la méthode `set()` des moteurs de cache. #### Cross Site Request Forgery - Le réglage [`CSRF_COOKIE_AGE`](/fr/3.1/ref/settings/#std-setting-CSRF_COOKIE_AGE) facilite l’utilisation des cookies de session CSRF. #### Email - [`send_mail()`](/fr/3.1/topics/email/#django.core.mail.send_mail) now accepts an `html_message` parameter for sending a multipart `text/plain` and `text/html` email. - The SMTP [`EmailBackend`](/fr/3.1/topics/email/#django.core.mail.backends.smtp.EmailBackend) now accepts a `timeout` parameter. #### Stockage de fichier - Le verrouillage de fichier sur Windows dépendait précédemment du paquet PyWin32; s’il n’était pas été installé, le verrouillage de fichier échouait en silence. Cette dépendance a été supprimée, et le verrouillage de fichier est désormais implémenté nativement à la fois sur Windows et Unix. #### Téléversement de fichiers - Le nouvel attribut [`UploadedFile.content_type_extra`](/fr/3.1/ref/files/uploads/#django.core.files.uploadedfile.UploadedFile.content_type_extra) contient les paramètres supplémentaires passés à l’en-tête `content-type` lors d’un téléversement de fichier. - Le nouveau réglage [`FILE_UPLOAD_DIRECTORY_PERMISSIONS`](/fr/3.1/ref/settings/#std-setting-FILE_UPLOAD_DIRECTORY_PERMISSIONS) contrôle les autorisations du système de fichiers pour les répertoires créés lors de téléversements de fichiers, tout comme [`FILE_UPLOAD_PERMISSIONS`](/fr/3.1/ref/settings/#std-setting-FILE_UPLOAD_PERMISSIONS) le fait pour les fichiers. - L’attribut [`FileField.upload_to`](/fr/3.1/ref/models/fields/#django.db.models.FileField.upload_to) est maintenant facultatif. S’il est omis ou définie à `None` ou une chaîne vide, un sous-répertoire ne sera pas utilisé pour stocker les fichiers téléversés. - Les fichiers téléversés sont désormais explicitement fermés avant que la réponse soit livrée au client. Les fichiers partiellement téléversés sont également fermés tant qu’ils sont nommés `file` dans le gestionnaire de téléversement. - [`Storage.get_available_name()`](/fr/3.1/ref/files/storage/#django.core.files.storage.Storage.get_available_name) ajoute maintenant un trait de soulignement en plus d’une chaîne alphanumérique de 7 caractères aléatoire (e.g. `"_x3a1gho"`), plutôt que d’itérer sur un trait de soulignement suivi d’un nombre (e.g. `"_1"`, `"_2"`, etc.) pour éviter une attaque par déni de service. Ce changement a également été effectué dans les versions de sécurité 1.6.6, 1.5.9 et 1.4.14. #### Formulaires - Les balises `