Manuel Pear

Niveau superieur
Sommaire

Introduction

Introduction -- Introduction à Cache_Lite

Description

PEAR::Cache_Lite est un petit système de cache. ll est optimisé pour les sites web à fort trafic, il est donc vraiment très rapide et sécurisé (car il utilise les verrous de fichiers et/ou des tests anti-corruptions).

Note : une documentation indépendante de Cache_Lite est disponible en chinois sur cette page.

Buts et détails techniques

Vitesse

Avant tout, PEAR::Cache_Lite est destiné à être très rapide. Ce qui rend l'utilisation de PEAR possible sur les sites à fort trafic sans tomber dans des solutions matérielles de hautes technicités.

Vous pouvez trouver plus de détails sur les choix techniques de Cache_lite sur ce document mais l'idée principale est d'inclure le fichier PEAR.php uniquement lorsqu'une erreur survient (extrèmement rare).

Simplicité

Parce que le système de cache est souvent inclus dans la couche applicative, le moteur PEAR::Cache_Lite doit être petit et flexible avec la licence LGPL. Les fonctions avancées peuvent être trouvées dans les fichiers qui étendent le moteur.

Sécurité

Sur les sites web à fort trafic, le système de cache doit être vraiment protégé contre les corruptions de fichiers (à cause des accès concurents en mode lecture/écriture). Vraiment très peu de systèmes de cache offrent une protection contre ce problème.

Un verrou de fichier n'est pas une solution parfaite, car il est inutile avec NFS ou avec des serveurs multitâches. Donc, en plus des verrous de fichiers, PEAR::Cache_Lite offre deux mécanismes totalement transparents (basés sur des clés de hashage) our garantir la sécurité des données en toutes circonstances. Consultez le lien donné dans le paragraphe précédent pour plus de détails.

Utilisation

Utilisation générale

Tous les modules de Cache_Lite suivent la même philosophie.

Les paramètres (autres que ceux par défaut) sont passés au constructeur en utilisant un tableau associatif.

Un fichier en cache est identifié par un identifiant de cache (et éventuellement un groupe). Pour des raisons évidentes de flexibilité, le choix de la logique concernant ces identifiants est laissé à la discrétion du développeur.

Dans ce qui suit, nous utiliserons le terme de "group" pour les fichiers en cache et le terme de "block" pour les pages HTML.

Partie principale

Commençons avec un exemple simple : la page est construite et récupérée avec une variable unique (chaîne de caractères) :

  1. <?php
  2.  
  3. // Inclusion du paquet
  4. require_once('Cache/Lite.php');  
  5.  
  6. // Définition d'un identifiant pour ce cache
  7. $id = '123';  
  8.  
  9. // Définition de quelques options
  10. $options = array( 
  11.    'cacheDir' => '/tmp/', 
  12.    'lifeTime' => 3600  
  13. );  
  14.  
  15. // Création de l'objet Cache_Lite
  16. $Cache_Lite = new Cache_Lite($options);  
  17.  
  18. // Test si il y a un cache valide pour cette identifiant
  19. if ($data = $Cache_Lite->get($id)) { 
  20.  
  21.    // Cache disponible !
  22.    // Le contenu est dans la variable $data
  23.    // (...)
  24.  
  25. } else { // Aucun cache valide trouvé (vous devez faire la page)
  26.  
  27.    // Cache non disponible !
  28.    // Mettez dans la variable $data les données à mettre dans le cache
  29.    // (...)
  30.    $Cache_Lite->save($data);  
  31.  
  32. }  
  33.  
  34.  
  35. ?> 

Si vous voulez utiliser un cache par bloc et non un cache global, examinez l'exemple suivant :

  1. <?php
  2. require_once('Cache/Lite.php');  
  3.  
  4. $options = array( 
  5.    'cacheDir' => '/tmp/', 
  6.    'lifeTime' => 3600  
  7. );  
  8.  
  9. // Création de l'objet Cache_Lite
  10. $Cache_Lite = new Cache_Lite($options);  
  11.  
  12. if ($data = $Cache_Lite->get('block1')) { 
  13.    echo($data);  
  14. } else { 
  15.    $data = 'Données du block 1'; 
  16.    $Cache_Lite->save($data);  
  17. }  
  18.  
  19. echo '<br /><br />Ligne non mise en cache !<br /><br />';  
  20.  
  21. if ($data = $Cache_Lite->get('block2')) { 
  22.    echo($data);  
  23. } else { 
  24.    $data = 'Données du block 2'; 
  25.    $Cache_Lite->save($data);  
  26. }  
  27.  
  28.  
  29. ?> 

Partie principale

Cependant, il n'est pas toujours possible de récupérer tout le contenu d'une page dans une seule variable. Dans ce cas, Cache_Lite_Output vient à votre secours :

  1. <?php
  2.  
  3. require_once('Cache/Lite/Output.php');  
  4.  
  5. $options = array( 
  6.    'cacheDir' => '/tmp/', 
  7.    'lifeTime' => 10  
  8. );  
  9.  
  10. $cache = new Cache_Lite_Output($options);  
  11.  
  12. if (!($cache->start('123'))) { 
  13.    // Cache manquant...
  14.    for($i=0;$i<1000;$i++) { // fabrication de la page...
  15.       echo '0123456789'; 
  16.    } 
  17.    $cache->end();  
  18. }  
  19.  
  20.  
  21. ?> 

L'idée est la même que pour l'utilisation des blocs :

  1. <?php
  2.  
  3. require_once('Cache/Lite/Output.php');  
  4.  
  5. $options = array( 
  6.    'cacheDir' => '/tmp/', 
  7.    'lifeTime' => 10  
  8. );  
  9.  
  10. $cache = new Cache_Lite_Output($options);  
  11.  
  12. if (!($cache->start('block1'))) { 
  13.    // Cache manquant...
  14.    echo 'Données du block 1 !'; 
  15.    $cache->end();  
  16. }  
  17.  
  18. echo 'Ligne non mise en cache !';  
  19.  
  20. if (!($cache->start('block2'))) { 
  21.    // Cache manquant...
  22.    echo 'Données du block 2 !'; 
  23.    $cache->end();  
  24. }  
  25.  
  26.  
  27. ?> 

NOTE IMPORTANTE

Pour une efficacité maximale avec Cache_Lite, n'incluez pas systématiquement tout autre paquet nécessaire à votre page. Chargez UNIQUEMENT les modules dont vous avez besoin lorsque la page n'est pas dans le cache (et doit donc être re-parsée) en utilisant une inclusion conditionnelle.

Le mauvais chemin est :

  1. <?php
  2. require_once("Cache/Lite.php");  
  3. require_once("...")  
  4. require_once("...")  
  5. // (...)
  6. $cache = new Cache_Lite();  
  7. if ($data = $Cache_Lite->get($id)) { // cache trouvé !
  8.    echo($data);  
  9. } else { // la page doit être (re)construite dans $data
  10.    // (...)
  11.    $Cache_Lite->save($data);  
  12. }  
  13.  
  14. ?> 

Voici la meilleure façon (souvent, plus de deux fois plus rapide) :

  1. <?php
  2. require_once("Cache/Lite.php");  
  3. // (...)
  4. $cache = new Cache_Lite();  
  5. if ($data = $Cache_Lite->get($id)) { // cache trouvé !
  6.    echo($data);  
  7. } else { // la page doit être (re)construite dans $data
  8.    require_once("...") 
  9.    require_once("...") 
  10.    // (...)
  11.    $Cache_Lite->save($data);  
  12. }  
  13.  
  14. ?> 

Conclusion

Pour aller plus loin avec Cache_Lite, regardez les exemples et les détails techniques fournis avec ce paquet.

Niveau superieur
Sommaire

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique