# Cache Factory

La fabrique de fichiers cache pour les plugins SPIP : une API générique pour configurer, écrire,
lire, lister et supprimer des caches, complétée d'une interface minimale d'administration dans
l'espace privé.

- **Préfixe** : `ezcache`
- **Licence** : GPL 3
- **Auteur** : Eric Lupinacci

Le numéro de version et la compatibilité SPIP font foi dans [`paquet.xml`](paquet.xml), et les
modifications de chaque version sont consignées dans le [journal des modifications](CHANGELOG.md).

## Utiliser le plugin

Un plugin utilisateur déclare la configuration de ses caches dans un fichier
`ezcache/<prefixe>.php`, puis appelle les fonctions de l'API. Il peut personnaliser chaque étape du
traitement en fournissant ses propres services.

La présentation générale et les     exemples de mise en œuvre sont publiés sur SPIP-Contrib :
<https://contrib.spip.net/Cache-Factory>

## Comprendre la conception

Le document de conception décrit les concepts, l'architecture API / services, la structure de la
configuration et les points d'extension offerts aux plugins utilisateur :
[docs/guide-conception-ezcache.md](docs/guide-conception-ezcache.md)

## Documentation des fonctions

La documentation technique produite depuis la PHPDoc du code est consultable sur
<https://code.spip.net/ezcache/>

## Contribuer

- Tests de non-régression : `php tests/executer.php`, sans installation de SPIP requise. Voir
  [tests/README.md](tests/README.md)
- Dépôt : <https://git.spip.net/spip-contrib-extensions/cache> (le dépôt porte le nom `cache`,
  antérieur au préfixe actuel)
- Fiche du plugin : <https://plugins.spip.net/ezcache>
- Traductions : <https://trad.spip.net> — les fichiers de langue autres que le français en sont
  issus et ne doivent pas être modifiés directement