Zend_Cache_Core
ist ein spezielles Frontend, da es der Kern dieses Moduls ist.
Es ist ein generelles Cache Frontend und durch andere Klassen erweiterbar.
Anmerkung | |
---|---|
Alle Frontends sind von |
Diese Optionen werden der Factory Methode übergeben wie im nachfolgenden Beispiel demonstriert.
Tabelle 4.1. Mögliche Optionen
Option | Daten Typ | Standardwert | Beschreibung |
---|---|---|---|
caching |
boolean |
true |
Ein- / Ausschalten vom Caching (kann sehr nützlich für das Debuggen von gecachten Skripten sein) |
lifetime |
int |
3600 |
Cache Lebensdauer (in Sekunden), wenn auf null gesetzt, ist
der Cache für immer gültig.
|
logging |
boolean |
false |
Wenn auf true gesetzt, wird das Logging durch Zend_Log aktiviert
(aber das System wird langsamer)
|
write_control |
boolean |
true |
Ein- / Ausschalten der Schreibkontrolle (der Cache wird gleich gelesen, nachdem er geschrieben wurde, um fehlerhafte Einträge zu finden); das Einschalten der Schreibkontrolle wird das Schreiben des Caches etwas verlangsamen, aber nicht das Lesen des Caches (es können defekte Cache Dateien entdeckt werden, aber es ist keine perfekte Kontrolle) |
automatic_serialization |
boolean |
false |
Ein- / Ausschalten der automatischen Serialisierung, kann dafür benutzt werden, um Daten direkt zu speichern, welche keine Strings sind (aber es ist langsamer) |
automatic_cleaning_factor |
int |
10 |
Ausschalten / Abgleichen des automatischen Löschprozesses (Garbage Collector): 0 heißt keine automatische Löschung des Caches, 1 heißt Systematische Cache Löschung und x > 1 heißt automatisches zufälliges Löschen 1 mal nach x Schreiboperationen. |
Ein Beispiel wird ganz am Anfang des Handbuches gegeben.
Wenn nur Strings in den Cache gespeichert werden (denn mit der "automatic_serialization" Option wäre es möglich Booleans zu speichern), kann ein kompakterer Weg wie folgt gewählt werden:
<?php // Es wird angenommen das $cache existiert $id = 'myBigLoop'; // Die Cache ID von dem "das gecached werden soll" if (!($data = $cache->load($id))) { // Cache miss $data = ''; for ($i = 0; $i < 10000; $i++) { $data = $data . $i; } $cache->save($data); } // [...] Irgendwas mit $data machen (ausgeben, verarbeiten, usw.) ?>
Wenn mehrere Blöcke von Daten oder Daten Instanzen gecached werden sollen, ist die Idee dahinter die gleiche:
<?php // Sicherstellen, dass eindeutige Identifizierer verwendet werden: $id1 = 'foo'; $id2 = 'bar'; // Block 1 if (!($data = $cache->load($id1))) { // Cache miss $data = ''; for ($i=0;$i<10000;$i++) { $data = $data . $i; } $cache->save($data); } echo($data); // Hier wird NIE gecached echo('NIE GECACHED! '); // Block 2 if (!($data = $cache->load($id2))) { // Cache miss $data = ''; for ($i=0;$i<10000;$i++) { $data = $data . '!'; } $cache->save($data); } echo($data); ?>
Zend_Cache_Frontend_Output
ist ein Ausgabe-Empfangendes Frontend. Es verwendet den
Ausgabe Puffer in PHP, um alles zwischen der start()
und der end()
Methode
zu fangen.
Dieses Frontend hat keine bestimmten Optionen zusätzlich zu denen von
Zend_Cache_Core
.
Ein Beispiel wird ganz am Anfang des Handbuches gegeben. Hier ist es mit kleinen Änderungen:
<?php // Wenn es ein Cache Miss ist, wird das puffern der Ausgabe ausgelöst if( ! ($cache->start('mypage'))) { // Alle wie gewohnt ausgeben echo 'Hallo Welt! '; echo 'Das wird gecached ('.time().') '; $cache->end(); // Ausgabepufferung beenden } echo 'Hier wird nie gecached ('.time().').'; ?>
Die Verwendung dieser Form ist ziemlich einfach, um Ausgabe caching in einem bereits bestehenden Projekt, mit nur wenig oder gar keinen Codeänderungen, zu erhalten.
Zend_Cache_Frontend_Function
cached das Ergebnis von Funktionsaufrufen. Es hat
eine einzelne Hauptmethode genannt call()
, welche den Funktionsnamen und Parameter
für den Aufruf in einem Array entgegennimmt.
Tabelle 4.2. Mögliche Optionen
Option | Daten Typ | Standardwert | Beschreibung |
---|---|---|---|
cacheByDefault |
boolean |
true |
Wenn true, wird der Funktionsaufruf standardmäßig gecached |
cachedFunctions |
array |
Funktionsnamen, die immer gecached werden sollen | |
nonCachedFunctions |
array |
Funktionsnamen, die nie gecached werden sollen |
Die Verwendung der call()
Funktion ist die gleiche, wie die von
call_user_func_array()
in PHP:
<?php $cache->call('veryExpensiveFunc', $params); # $params ist ein Array # Zum Beispiel fürs Aufrufen (mit cachen) von veryExpensiveFunc(1, 'foo', 'bar'), wird # $cache->call('veryExpensiveFunc', array(1, 'foo', 'bar')) benutzt ?>
Zend_Cache_Frontend_Function
ist elegant genug, um beides zu cachen, den
Rückgabewert der Funktion und deren interne Ausgabe.
Anmerkung | |
---|---|
Man kann jede eingebaute oder benutzerdefinierte Funktion übergeben, mit ausnahme von
|
Zend_Cache_Frontend_Class
ist unterschiedlich zu Zend_Cache_Frontend_Function
,
weil es das Cachen von Objekten und statischen Methodenaufrufen erlaubt.
Tabelle 4.3. Mögliche Optionen
Option | Datentyp | Standardwert | Beschreibung |
---|---|---|---|
cachedEntity (Notwendig) |
mixed |
Wenn auf einen Klassennamen gesetzt, wird eine abstrakte Klasse gecached und es werden statische Aufrufe verwendet; wenn auf ein Objekt gesetzt, wird deren Objektmethoden gecached | |
cacheByDefault |
boolean |
true |
Wenn true, wird der Aufruf standardmäßig gecached |
cachedMethods |
array |
Methodennamen, die immer gecached werden sollen | |
nonCachedMethods |
array |
Methodennamen, die nie gecached werden sollen |
zum Beispiel, um einen statischen Aufruf zu cachen:
<?php class test { # Statische Methode public static function foobar($param1, $param2) { echo "foobar_output($param1, $param2)"; return "foobar_return($param1, $param2)"; } } // [...] $frontendOptions = array( 'cachedEntity' => 'test' // Der Name der Klasse ); // [...] # Der gecachte Aufruf $res = $cache->foobar('1', '2'); ?>
Um klassische Methodenaufrufe zu cachen :
<?php class test { private $_string = 'Hallo !'; public function foobar2($param1, $param2) { echo($this->_string); echo "foobar2_output($param1, $param2)"; return "foobar2_return($param1, $param2)"; } } // [...] $frontendOptions = array( 'cachedEntity' => new test() // Eine Instanz der Klasse ); // [...] # Der gecachte Aufruf $res = $cache->foobar2('1', '2'); ?>
Zend_Cache_Frontend_File
ist ein Frontend angetrieben durch den
Änderungszeitpunkt einer "Masterdatei". Es ist wirklich interessant für Beispiele
in Konfigurations- oder Templateanwendungen.
Zum Beispiel eine XML Konfigurationsdatei, welche von einer Funktion geparsed wird
und die ein "Config Objekt" zurückgibt (wie durch Zend_Config
). Mit
Zend_Cache_Frontend_File
kann das "Config Objekt" im Cache gespeichert
werden (um zu Verhindern, das die XML Konfiguration jedes mal geparsed wird), aber mit
einer strengen Abhängigkeit zur "Masterdatei". Wenn also die XML Konfigurationsdatei
geändert wird, wird der Cache sofort ungültig.
Zend_Cache_Frontend_Page
ist wie Zend_Cache_Frontend_Output
aber entwickelt für eine komplette Seite. Es ist unmöglich Zend_Cache_Frontend_Page
nur für das Cachen eines einzelnen Blockes zu verwenden.
Andererseits wird die "Cache ID" automatisch berechnet mit $_SERVER['REQUEST_URI']
und
(abhängig von den Optionen) mit
$_GET
, $_POST
, $_SESSION
, $_COOKIE
, $_FILES
.
Trotzdem muß nur eine Methode aufgerufen werden (start()
), weil der Aufruf von
end()
immer vollautomatisch ist, wenn die Seite endet.
Zur Zeit ist es nicht eingebaut, aber es ist ein HTTP abhängiges System geplant, um Bandbreiten zu sparen (das System wird ein "HTTP 304 nicht geändert" schicken, wenn der Cache gefunden wurde und wenn der Browser bereits eine gültige Version hat).
Tabelle 4.5. Mögliche Optionen
Option | Daten Typ | Standardwert | Beschreibung |
---|---|---|---|
http_conditional |
boolean |
false |
Verwendung des http_conditional Systems (zur Zeit nicht implementiert) |
debug_header |
boolean |
false |
Wenn true, wird eine Debugging Text for jeder gecacheten Seite hinzugefügt |
default_options |
array |
array(...siehe unten...) |
Ein assoziatives Array mit Default Optionen:
|
regexps |
array |
array() |
Ein assoziatives Array, um Optionen nur für einige REQUEST_URI zu setzen. Die Schlüssel sind reguläre Ausdrücke (PCRE), die Werte sind ein assoziatives Array mit spezifischen Optionen, die gesetzt werden sollen, wenn der reguläre Ausdruck auf $_SERVER['REQUEST_URI'] passt (siehe die default_options für eine Liste der verfügbaren Optionen); wenn verschiedene reguläre Ausdrücke auf $_SERVER['REQUEST_URI'] passen, wird nur der letzte verwendet. |
Die Verwendung von Zend_Cache_Frontend_Page ist wirklich trivial :
<?php // [...] // Benötigt, Konfiguration und Factory $cache->start(); // Wenn der Cache gefunden wurde, wird das Ergebnis zum Browser geschickt, und das Skript stoppt hier // Rest der Seite ... ?>
Ein etwas komplexeres Beispiel, welches einen Weg zeigt, um ein zentralisiertes Cache Management in einer Bootstrap Datei zu erhalten (um es z.B. mit Zend_Controller´ zu verwenden)
<?php // [...] du solltest es vermeiden, zu viele Zeilen vor dem Cache Bereich zu setzen // [...] zum Beispiel sollten für optimale Performanz "require_once" oder "Zend_Loader::loadClass" // [...] nach dem Cache Bereich stehen require_once 'Zend/Cache.php'; $frontendOptions = array( 'lifetime' => 7200, 'debug_header' => true, // für das Debugging 'regexps' => array( '^/$' => array('cache' => true), // cache den gesamten IndexController '^/index/' => array('cache' => true), // cache den gesamten IndexController '^/article/' => array('cache' => false), // wir cachen nicht den ArticleController... '^/article/view/' => array( // ...aber wir cachen die "View" Aktion von 'cache' => true, // diesem ArticleController 'cache_with_post_variables' => true, // und wir cachen sogar wenn es einige Variablen in $_POST gibt 'make_id_with_post_variables' => true, // (aber die Cache Id wird vom $_POST Array abhängig sein) ) ) ); $backendOptions = array( 'cache_dir' => '/tmp/' ); // erhalte ein Zend_Cache_Frontend_Page Objekt $cache = Zend_Cache::factory('Page', 'File', $frontendOptions, $backendOptions); $cache->start(); // Wenn der Cache gefunden wurde, wird das Ergebnis zum Browser geschickt, und das Skript stoppt hier // [...] das Ende der Bootstrap Datei (diese Zeilen werden nicht ausgeführt, wenn der Cache ausgegeben wurde) ?>