🔄
Mettre à jour une image et gérer le cache
En bref
Une URL cloudphoto désigne un contenu stable et peut rester en cache pendant un mois. Lorsque l’image source change, versionnez son adresse pour obtenir immédiatement une nouvelle URL et éviter les anciennes copies.
🧠Comprendre la mise en cache
Lors de la première demande, cloudphoto télécharge l’image source, produit la variante et la met en cache. Les demandes suivantes réutilisent cette variante, ce qui accélère l’affichage et évite de refaire la transformation.
Le cache du réseau de diffusion et celui du navigateur peuvent conserver l’image pendant un mois. Remplacer le fichier source sans changer son adresse ne suffit donc pas : l’ancienne variante peut continuer à être servie.
🏷️Versionner l’adresse source
La méthode recommandée consiste à changer l’adresse de l’image source à chaque nouvelle version :
- donnez un nouveau nom au fichier ; ou
- ajoutez un paramètre de version à son adresse, par exemple
photo.jpg?v=2.
Cette adresse source se trouve après le dernier
url= de l’appel cloudphoto. Comme elle change, l’URL cloudphoto signée change elle aussi et désigne une nouvelle variante, sans attendre l’expiration des caches précédents.
La version doit changer à chaque remplacement. Utilisez un numéro, une date de modification ou une empreinte générée par votre application, puis signez la nouvelle chaîne exacte.
🧰Forcer une régénération pendant un diagnostic
Le paramètre
force=1 oblige cloudphoto à retélécharger l’image source et à produire de nouveau la variante. Réservez-le aux vérifications ponctuelles : il sollicite de nouveau la source et ne vide pas les copies déjà présentes dans le réseau de diffusion ou dans les navigateurs.force=1 ne remplace pas le versionnement. Si vos visiteurs doivent voir immédiatement la nouvelle image, modifiez son adresse source. Aucun service ne peut retirer une copie déjà enregistrée dans leur navigateur.Mise à jour le 3 septembre 2026