# Vider le cache de Kapsule CDN

Source: https://support.kapsulehost.com/fr-fr/cdn-cache-purge

Vider le cache supprime la copie de votre contenu conservée à l'edge, afin que le visiteur suivant reçoive une version fraîchement récupérée depuis votre origine. C'est ce que vous faites lorsque vous avez publié une modification et que l'ancienne version s'affiche encore.

Le cache est ce qui rend le CDN rapide, et c'est aussi la raison pour laquelle une modification que vous venez de faire peut ne pas apparaître tout de suite. Plutôt que de ramener vos durées de cache à zéro, gardez-les longues et videz le cache à la demande. Ce guide couvre les deux, ainsi que la manière de distinguer un cache edge d'un cache de navigateur avant de chercher au mauvais endroit.

## Quand vider le cache

Videz le cache après avoir modifié quelque chose que les visiteurs récupèrent par URL :

- Vous avez remplacé un fichier CSS ou JavaScript et l'ancien est toujours servi.
- Vous avez téléversé une nouvelle version d'une image par-dessus un nom de fichier existant.
- Vous avez corrigé un bogue sur une page et voulez que la version défectueuse disparaisse partout, tout de suite.
- Vous avez modifié le contenu d'une page et ne pouvez pas attendre l'expiration du TTL edge.

Vous n'avez pas besoin de vider le cache lorsque vous avez ajouté une toute nouvelle page ou un nouveau nom de fichier. Rien n'est en cache pour une URL qui n'a jamais été demandée.

> **Tip:** Si vous versionnez les noms de fichiers de vos ressources (`style.a1b2c3.css` plutôt que `style.css`), vous n'aurez presque jamais besoin de vider le cache. Un nouveau nom de fichier est une nouvelle URL : il est donc récupéré à neuf depuis votre origine et mis en cache sous sa propre clé.

## Où se trouve la commande de vidage

1. Connectez-vous à [KPanel](https://kpanel.kapsulehost.com).
2. Cliquez sur **Sites web** dans la barre latérale gauche, puis sur votre site.
3. Dans le menu du site, ouvrez **Performances**, puis **Kapsule CDN**.
4. Faites défiler jusqu'à la carte **Vider le cache**.

L'adresse directe est `/websites/<site-id>/cdn`.

![La carte Vider le cache sur la page Kapsule CDN](https://support.kapsulehost.com/help/screenshots/cdn-cache-purge.881b7fa3.webp)

> **Note:** La commande de vidage n'apparaît qu'une fois le CDN activé pour le site. Si la page affiche la bannière **CDN désactivé pour ce site**, ou vous demande de connecter un domaine personnalisé, il n'y a encore rien à vider à l'edge. [Activer Kapsule CDN sur votre site](https://support.kapsulehost.com/fr-fr/cdn-enabling) indique précisément quelles offres l'incluent.

## Vider une seule URL

1. Dans la carte **Vider le cache**, saisissez l'URL publique complète dans le champ **URL à vider (laissez vide pour tout le site)**. L'exemple affiché dans le champ montre la forme attendue : `https://your-domain.tld/path`.
2. Cliquez sur **Vider**.
3. Une confirmation apparaît, indiquant que l'URL saisie a été vidée.

Utilisez l'URL exacte qu'un visiteur demanderait, y compris le schéma (`https://`), l'hôte et le chemin. Le vidage est associé à l'URL, donc `https://example.com/about` et `https://example.com/about/` sont deux entrées de cache différentes, tout comme la même page avec une chaîne de requête ajoutée.

Vider une seule URL est le bon premier réflexe lorsque vous savez exactement ce qui a changé. C'est instantané et le reste de votre cache reste intact, si bien que le reste du site reste rapide.

## Vider tout le site

1. Laissez le champ **URL à vider** entièrement vide.
2. Cliquez sur **Vider**.
3. La confirmation indique « Cache complètement vidé. »

> **Warning:** Un vidage complet supprime tous les objets en cache du site sur chaque emplacement edge. Tant que chaque URL n'a pas été redemandée, chaque visiteur est servi depuis votre origine : l'origine encaisse donc un pic de trafic, et le premier visiteur de chaque page attend un aller-retour complet. Sur un site très fréquenté, videz de préférence les URL précises que vous avez modifiées.

Chaque vidage que vous lancez est enregistré dans le journal d'activité du compte avec l'URL ou un marqueur de zone complète, pour que vous puissiez voir qui a vidé quoi et quand.

## Durées de cache et interactions

La carte **TTL du cache**, sur la même page, détermine combien de temps le contenu subsiste sans vidage :

| Réglage | Ce qu'il contrôle | Valeur par défaut |
|---|---|---|
| **TTL du réseau (secondes)** | Combien de temps l'edge conserve une copie avant de la récupérer à nouveau depuis votre origine | 3600 (1 heure) |
| **TTL du navigateur (secondes)** | Combien de temps le navigateur d'un visiteur conserve sa propre copie locale | 3600 (1 heure) |

Les deux sont indépendants, et c'est de loin la source de confusion la plus fréquente. Un vidage efface l'**edge**. Il ne peut pas atteindre le navigateur d'un visiteur. Si vous videz le cache et voyez encore vous-même l'ancienne version, vous regardez presque certainement le cache de votre propre navigateur.

Pour l'écarter, chargez la page dans une fenêtre privée ou de navigation privée, ou forcez le rechargement. Si la fenêtre privée affiche la nouvelle version, le vidage a fonctionné et vous n'attendez plus que votre propre navigateur et ceux des autres visiteurs, qui se mettront à jour à l'expiration de leur TTL de navigateur.

> **Tip:** Si vous publiez souvent et ne pouvez pas versionner les noms de fichiers, réduisez le **TTL du navigateur** à une valeur courte (quelques minutes) et laissez le **TTL du réseau** long. Vous conservez l'essentiel du bénéfice de l'edge tout en réduisant fortement la période pendant laquelle les visiteurs peuvent rester bloqués sur une ancienne copie.

## Optimisation des images et vidage

Si l'**Optimisation d'images à la volée** est activée (une fonctionnalité de Kapsule CDN+), l'edge stocke la version optimisée de chaque image à côté de l'original. Vider l'URL de l'image efface aussi la version optimisée, si bien qu'une image remplacée est optimisée à nouveau à sa prochaine demande. Il n'existe pas de vidage séparé pour les images optimisées.

Il en va de même pour **Servir WebP aux navigateurs compatibles** : la variante WebP se trouve sous la même URL et est effacée par le même vidage.

## Dépannage

**« CDN non provisionné pour ce site. »** Le site n'a pas encore de zone edge. Activez d'abord le CDN et attendez que le certificat ait fini d'être provisionné.

**« Échec de la purge. »** La demande de vidage n'a pas atteint l'edge. Patientez un instant et réessayez. Si l'échec persiste, la zone edge est peut-être en cours de provisionnement : vérifiez que la page affiche la bannière **CDN activé**.

**J'ai vidé le cache et la page est toujours ancienne.** Vérifiez d'abord dans une fenêtre privée. Si une fenêtre privée affiche aussi l'ancienne version, confirmez que vous avez vidé l'URL exacte, y compris une éventuelle barre oblique finale et chaîne de requête, puis essayez un vidage complet.

**Seuls certains visiteurs voient la mise à jour.** Leurs navigateurs sont encore dans la durée du TTL du navigateur. Rien n'est anormal : ils obtiendront la nouvelle version à son expiration, ou immédiatement en forçant le rechargement.

**L'origine s'est effondrée après un vidage complet.** C'est le pic de trafic non mis en cache décrit plus haut. Augmentez le TTL edge et, la prochaine fois, ne videz que les URL qui ont changé. [Améliorer la vitesse de votre site web](https://support.kapsulehost.com/fr-fr/website-speed) explique comment rendre l'origine elle-même plus résistante.

Si un vidage réussit mais que l'edge continue de servir l'ancien contenu pendant plus de quelques minutes, écrivez à [support@kapsulehost.com](mailto:support@kapsulehost.com) en indiquant l'URL exacte et l'heure du vidage.