Cache de contenu statique

Pour améliorer les performances, Commerce définit la variable Expires en-têtes pour les ressources statiques, telles que les images, JavaScript et les fichiers CSS.
La définition de la variable Expires sur une ressource statique, l’en-tête indique au navigateur de mettre la ressource en cache à cette URL et de diffuser la version mise en cache jusqu’à son expiration.
Ceci est courant bonne pratique pour la mise en cache de ressources statiques.

Lorsque le navigateur met en cache une ressource statique et que cette ressource change sur le serveur, vous devez effacer le cache du navigateur afin qu’il puisse télécharger la nouvelle version.
L’effacement manuel du cache du navigateur fonctionne si vous êtes administrateur d’un site web, mais il ne s’agit pas d’une requête appropriée à l’attention de vos utilisateurs lorsque vous souhaitez qu’ils téléchargent de nouvelles versions d’une ressource statique.

Signature de contenu statique

La signature de contenu statique est une fonction Commerce qui vous permet d’invalider le cache du navigateur pour les ressources statiques.
Pour ce faire, Commerce ajoute une version de déploiement à l’URL des fichiers statiques.

Voici un exemple d’URL signée avec une version :

http://magento2.com/pub/static/version1475604434/frontend/Magento/luma/en_US/images/logo.svg

Lorsque vous exécutez la commande setup:static-content:deploy pour déployer du contenu statique, Commerce modifie automatiquement la version de déploiement.
Cela modifie l’URL des fichiers statiques et force le navigateur à charger la nouvelle version des fichiers.

Commerce active cette fonctionnalité par défaut et Adobe recommande de la conserver afin d’éviter les problèmes liés aux navigateurs qui diffusent d’anciennes ressources statiques.

La configuration de la signature de contenu statique se trouve dans Stores> Paramètres > Configuration >Advanced>Developer>Static Files Settings.

  • Sur site uniquement: cette configuration est disponible si votre site est not in Mode de production.
  • Cloud: cette configuration est masquée car le mode Production est strictement appliqué. Vous devez donc utiliser la ligne de commande comme illustré ci-dessous.

Paramètres des fichiers statiques

Déterminez l’état :

bin/magento config:show dev/static/sign

Activer ou désactiver la signature de contenu statique :

bin/magento config:set dev/static/sign <value>

<value> est 1 (activé) ou 0 (désactivé).

Signatures de version

Commerce ajoute la signature de version en tant que composant de chemin juste après l’URL de base des fichiers d’affichage statique afin de préserver l’intégrité des URL relatives sur les ressources statiques.
Cela oblige également le navigateur à résoudre une URL relative à la source signée correcte, tout en conservant son contenu indépendamment de la présence/absence de la valeur de signature.

Lorsqu’un navigateur demande une source signée au serveur, le serveur utilise les réécritures d’URL pour supprimer le composant de signature de l’URL.

Utilisation pendant les déploiements

Après la mise à niveau ou la modification de ressources statiques, vous devez exécuter la variable setup:static-content:deploy pour déployer la version et mettre à jour le contenu statique, ce qui force le navigateur à charger les ressources mises à jour.

Si vous déployez du code sur un serveur distinct et le déplacez en production à l’aide d’un référentiel de code afin de réduire les temps d’arrêt, vous devez également ajouter le fichier . pub/static/deployed_version.txt au référentiel.
Ce fichier contient la nouvelle version du contenu statique déployé.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c