Il y a trois concepts clés dans Zend_Cache
. Le premier est
l'identifiant unique (une chaîne) qui est utilisé pour identifier les enregistrements de
cache. Le second est la directive "lifeTime" vue dans les
exemples ; elle définit combien de temps la ressource de cache est considérée comme à
jour. Le troisième est l'exécution conditionnelle, ainsi chaque partie de votre code peut
être évitée entièrement, pour améliorer les performances. La fonction principale du
frontend (Zend_Cache_Core::get()
) est toujours faite pour retourner
FALSE
en cas de cache manquant, si cela donne du sens à la nature d'un
frontend. Cela permet aux utilisateurs d'entourer des parties de code qu'ils veulent mettre
en cache (et éviter) dans une instruction
if()
{ ... } où la condition est une
méthode Zend_Cache
. A la fin de ces blocs, vous devez sauvegarder ce
que vous avez généré (par exemple Zend_Cache_Core::save()
).
Note
Le design de l'exécution conditionnelle de votre code généré n'est pas forcément dans des frontends (Function, par exemple) quand toute la logique est implémentée à l'intérieur du frontend.
Note
Le "Cache hit" est un terme pour une condition quand l'enregistrement de cache est trouvé, valide, et à jour (en d'autres mots, qu'il n'a pas encore expiré). Le "Cache miss" est tout le reste. Lorsque un "Cache miss" survient, vous devez générer vos données (comme vous le feriez normalement) et les mettre en cache. Lorsque vous avez un "Cache hit", le backend récupère pour vous et de façon transparente, les enregistrements.
Une bonne manière de construire une instance utilisable d'un frontend
Zend_Cache
est donnée dans l'exemple suivant :
// Nous choisissons un backend (par exemple 'File' ou 'Sqlite') $backendName = '[...]'; // Nous choisissons un frontend (par exemple: 'Core', 'Output', // 'Page'...) $frontendName = '[...]'; // Nous définissons un tableau d'options pour le frontend choisit $frontendOptions = array([...]); // Nous définissons un tableau d'options pour le banckend choisit $backendOptions = array([...]); // Nous créons la bonne instance // Bien sur, les deux derniers arguments sont optionnels $cache = Zend_Cache::factory($frontendName, $backendName, $frontendOptions, $backendOptions);
Dans les exemples suivants, nous nous assurerons que la variable
$cache
utilise une instance de frontend valide, et que vous
comprenez comment passer des paramètres à vos backends.
Note
Utilisez toujours Zend_Cache::factory()
pour obtenir des
instances de frontend. Instancier des frontends et des backends par vous-même ne
fonctionnera pas comme prévu.
Les balises sont un moyen de catégoriser les enregistrements de cache. Quand vous
sauvegardez un cache avec la méthode save()
vous pouvez
définir un tableau de balises qui s'appliqueront à cet enregistrement. Ensuite vous
serez en mesure de nettoyer tous les enregistrements de cache identifiés par
une balise (ou plusieurs) donnée :
$cache->save($grande_donnees, 'monIDUnique', array('tagA', 'tagB', 'tagC'));
Note
Notez que la méthode save()
accepte un quatrième paramètre
optionnel : $specificLifetime
(si différent de
FALSE
, il affecte un "lifeTime" spécifique pour
cet enregistrement de cache particulier).
Pour supprimer / invalider un identifiant de cache particulier, vous pouvez
utiliser la méthode remove()
:
$cache->remove('idAEffacer');
Pour effacer / invalider plusieurs identifiants de caches en une seule
opération, vous pouvez utiliser la méthode clean()
. Par
exemple, pour supprimer tous les caches :
// nettoie tous les enregistrements $cache->clean(Zend_Cache::CLEANING_MODE_ALL); // nettoie uniquement les caches obsolètes $cache->clean(Zend_Cache::CLEANING_MODE_OLD);
Si vous voulez effacer les caches correspondant aux balises "tagA" et "tagC" :
$cache->clean(Zend_Cache::CLEANING_MODE_MATCHING_TAG, array('tagA', 'tagC'));
Si vous voulez effacer les caches ne correspondant pas aux balises "tagA" et "tagC" :
$cache->clean(Zend_Cache::CLEANING_MODE_NOT_MATCHING_TAG, array('tagA', 'tagC'));
Si vous voulez effacer les caches correspondant aux balises "tagA" ou "tagC" :
$cache->clean(Zend_Cache::CLEANING_MODE_MATCHING_ANY_TAG, array('tagA', 'tagC'));
Les modes disponibles de nettoyage sont CLEANING_MODE_ALL
,
CLEANING_MODE_OLD
, CLEANING_MODE_MATCHING_TAG
,
CLEANING_MODE_NOT_MATCHING_TAG
et
CLEANING_MODE_MATCHING_ANY_TAG
. Les derniers, comme leur nom
l'indique, sont à combiner avec un tableau de balises pour réaliser les opérations de
nettoyage.