> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.faaaster.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Comment exclure une page du cache sur Faaaster ?

Pour qu'une page ne soit jamais servie depuis le cache serveur, ajoutez son adresse dans le fichier `conf/cache.user.conf` de votre site, puis cliquez sur **Redémarrer PHP / Nginx** dans le menu **Actions**. Le même dossier `conf` permet aussi d'exclure du cache selon un cookie, de faire ignorer des paramètres d'URL et de régler la durée du cache.

> **Prérequis** — l'**Éditeur de fichiers** (onglet **Accès**) ou un accès SFTP. Le dossier `conf` se trouve à la racine, à côté du dossier `www`. Il reste modifiable quand le mode lecture seule est actif.

## Exclure une page ou une section du cache

1. Ouvrez le site, onglet **Accès**, section **Éditeur de fichiers**, puis le dossier `conf`.
2. Créez le fichier `cache.user.conf` s'il n'existe pas.
3. Ajoutez une ligne par règle :

```
~^/panier/ 1;
~^/mon-compte/ 1;
/contact/ 1;
```

4. Dans le menu **Actions**, cliquez sur **Redémarrer PHP / Nginx**.

`~^/panier/` exclut toutes les adresses qui commencent par `/panier/`. Sans `~`, `/contact/` n'exclut que cette adresse exacte. Chaque ligne se termine par ` 1;`.

> ⚠️ **N'écrivez que des règles terminées par `1`.** Une règle trop large comme `~/ 1;` désactive le cache de tout le site.

## Exclure du cache selon un cookie

Le fichier `conf/cookiescachebypass.user.conf` contient déjà les cookies de connexion WordPress et de panier des principales extensions e-commerce. Pour exclure du cache les visiteurs qui portent votre propre cookie, ajoutez une ligne sans supprimer les lignes existantes :

```
~mon_cookie 1;
```

Cliquez ensuite sur **Redémarrer PHP / Nginx** dans le menu **Actions**.

## Les paramètres d'URL

Une adresse qui contient des paramètres (`?…`) n'est pas mise en cache, sauf si tous ses paramètres figurent dans `conf/cache-query-params.user.conf` : ceux-là sont ignorés. Par défaut : `utm_*`, `fb_*`, `ref` et `t`.

- Ajoutez un nom de paramètre par ligne ; un `*` final couvre tous les noms qui commencent ainsi.
- N'y mettez jamais un paramètre qui change le contenu de la page ou qui identifie un visiteur.
- Ce fichier est pris en compte en quelques secondes, sans redémarrage.

## La durée du cache

Le fichier `conf/cache-ttl.user.conf` fixe combien de temps une page reste en cache : `fastcgi_cache_valid 200 302 10h;` par défaut, soit 10 heures. Après une modification, cliquez sur **Redémarrer PHP / Nginx**, puis sur **Effacer le cache** : ce changement ne purge pas les pages déjà en cache.

## Si le redémarrage est refusé

**Redémarrer PHP / Nginx** teste d'abord toute la configuration. En cas d'erreur, le redémarrage est annulé et votre site continue de fonctionner avec l'ancienne configuration. L'interface affiche alors « Configuration nginx invalide — redémarrage annulé. Corrigez la configuration : », suivi du détail de l'erreur renvoyé par nginx. Le message reste affiché jusqu'à ce que vous le fermiez : corrigez le fichier en cause, en commençant par le dernier que vous avez modifié.

> ⚠️ **Corrigez ou supprimez le fichier sans attendre.** Laissé en place, il empêcherait le site de répondre après un **Redémarrer le serveur**.

## Bon à savoir

- Les pages de l'administration WordPress, la connexion et l'API REST ne sont jamais mises en cache : inutile de les ajouter.
- Copiez le contenu d'un fichier avant de le modifier, pour pouvoir revenir en arrière.
- L'assistant IA peut vous indiquer la règle exacte à écrire pour votre cas.

👉 [Comment vider le cache ?](https://help.faaaster.io/fr/article/vider-le-cache-1sda4yi/) · [Comment redémarrer mon site ?](https://help.faaaster.io/fr/article/redemarrer-son-site-gipk7r/) · [Comment ajouter une redirection ?](https://help.faaaster.io/fr/article/ajouter-une-redirection-nginx-1emjsrb/)