Das Zend Framework 2 (ZF2) steht in den Startlöchern und es gibt einiges neues.
In diesem Artikel nehme ich mir die von Grund auf neu geschriebene Zend\Cache Komponente vor. Als erster Einstieg sei einem erstmal die offizielle Dokumentation sowie die API ans Herz gelegt, aber das nur am Rande.
Die Komponente Zend\Cache ist in 2 unterschiedliche Teile aufgesplittet: Zend\Cache\Storage
und Zend\Cache\Pattern
.
In diesem ersten Artikel gehe ich näher auf Zend\Cache\Storage
ein und mit dem nachfolgenden Artikel auf Zend\Cache\Pattern
.
Zend\Cache\Storage
Unter diesem Namensraum befindet sich eine Vielzahl von Interfaces, welche bestimmte Speichermethoden definieren.
Das Basis-Interface Zend\Cache\Storage\StorageInterface
definiert die Mindestanforderungen (alle unterstützte
Speichersysteme implementieren dieses Interface).
Es definiert die folgenden Lese- und Schreiboperationen eines “Key-Values-Storage”:
getItem(string $key, boolean & $success = null, mixed & $casToken = null)
getItems(array $keys)
hasItem(string $key)
hasItems(array $keys)
getMetadata(string $key)
getMetadatas(array $keys)
setItem(string $key, mixed $value)
setItems(array $keyValuePairs)
addItem(string $key, mixed $value)
addItems(array $keyValuePairs)
replaceItem(string $key, mixed $value)
replaceItems(array $keyValuePairs)
checkAndSetItem(mixed $token, string $key, mixed $value)
removeItem(string $key)
removeItems(array $keys)
touchItem(string $key)
touchItems(array $keys)
incrementItem(string $key)
incrementItems(array $keyValueParis)
decrementItem(string $key)
decrementItems(array $keyValueParis)
All diese Methoden können von einem “Key-Value-Storage” unterstützt werden bzw. lassen sich auf einfache Weise emulieren.
So kann beispielweise die Methode incrementItem()
emuliert werden, indem das jeweilige Item gelesen wird,
der Wert hochgezählt wird und das Item mit dem neu generierten Wert wieder in den Speicher geschrieben wird.
Wer schon des öfteren mit Cache-Systemen in PHP gearbeitet hat, dem müsste aufgefallen sein, das nirgends ein Argument für eine TTL (time-to-live) definiert ist. Das liegt daran, das eine TTL angibt, wann das jeweilige Item abläuft und nicht mehr gültig ist und somit bereits eine Verdrängungsstrategie darstellt. Verdrängungsstrategien für Cache-Speicher gibt es viele und wird von der Komponente nicht vorgeschrieben. Bei Cache-Speichern, welche diese Art der Verdrängung unterstützen wird die TTL vorher mittels einer Option für die ganze Instanz gesetzt.
Die folgenden weiteren Interfaces definieren zusätzliche Operationen, welche von bestimmten Cache-Speichern unterstützt werden und nur dort implementiert sind:
AvailableSpaceCapableInterface
getAvailableSpace()
TotalSpaceCapableInterface
getTotalSpace()
ClearByNamespaceInterface
clearByNamespace($namespace)
ClearByPrefixInterface
clearByPrefix($prefix)
ClearExpiredInterface
clearExpired()
FlushableInterface
flush()
IterableInterface
getIterator()
OptimizableInterface
optimize()
TaggableInterface
setTags(string $key, array $tags)
getTags(string $key)
clearByTags(array $tags, boolean $disjunction = false)
Doch halt! Was ist mit der Methode getCapabilites()
und der Klasse Zend\Cache\Storage\Capabilities
?
Die Capabilities (zu deutsch Fähigkeiten) geben an, was der Cache-Speicher unterstützt bzw. wie er intern arbeitet.
Im Gegensatz zu den oben definierten Interfaces werden für unterschiedliche Capabilities keine zusätzlichen oder geänderten Methoden benötigt.
Zudem können sich diese Capabilites teilweise durch setzten bestimmter Optionen ändern.
Zur Verfügung stehen folgende Capabilites:
getMetadata()
und getMetadatas()
abrufbar sindZend\Cache\Storage\Plugin
Als Storage Plugin bezeichnen wir Implementierungen, welche zur Laufzeit einem Cache-Storage hinzugefügt und wieder entfernt werden können.
Dazu wird das Plugin instanziiert und dem Speicher mittels addPlugin()
bekannt gemacht.
Intern wird dazu Zend\EventManager
benutzt. Der speicher benutzt den Zend\EventManager
und ruft vor und nach jeder Operation
ein “.pre” bzw. “.port” Event auf. Das Plugin lauscht auf diesen Events und kann dabei die Argumente und das Ergebnis abändern oder
auch einfach nur ein Lgging durchfüren.
Das Zend Framework 2 hat bereits einige Storage-Plugins Vorimplementiert. Die wohl wichtigsten sind das Serializer-Plugin und das ExceptionHandler-Plugin.
Mit Hilfe des Zend\Cache\Storage\Plugin\Serializer
-Plugins werden alle Werte mittel eines Zend\Serializer
’s serialisiert, so dass ansonsten nicht
unterstützte Datentypen im Cache-Speicher abgelegt werden können.
Das Plugin Zend\Cache\Storage\Plugin\ExceptionHandler
fängt alle von dem Cache-Speicher geworfenen Exceptions ab und ruft eine definierbare
Funktion mit dieser Exception als Argument auf, um ein Logging zu implementieren.
Desweiteren kann definiert werden, ob die abgefangene Exception weitergereicht wird (re-throw),
oder ob die Operation einen einfachen Fehler als Return-Value zurück gibt (z.B. NULL bei getItem), um try-catch-Blöcke zu umgehen.
ACHTUNG: Das Plugin-System ist nicht im Interface definiert und es ist daher nicht sicher, das ein Cache-Speicher dieses Unterstützt.
Mittels des Interfaces Zend\EventManager\EventsCapableInterface
kann zwar festgestellt werden, ob der Cache-Speicher Events handhabt,
aber welche das sind ist nicht definiert.
Nun wollen wir die Komponente aber endlich in Aktion sehen! Dazu sollten wir sie instanziieren:
use Zend\Cache\StorageFactory as CacheStorageFactory;
$cache = CacheStorageFactory::factory(array(
'adapter' => array(
'name' => 'filesystem',
'options' => array(
// ...
),
),
'plugins' => array(
'serializer' => array(
'serializer' => 'igbinary'
),
'exception_handler' => array(
'throw_exceptions' => false,
'exception_callback' => function (Exception $e) {
$message = date('r') . ' ' . $e . PHP_EOL;
file_put_contents(__DIR__ . '/cache_error.log', $message, FILE_APPEND);
},
),
),
));
Mit dem obigen Code erstellt man eine Instanz von Zend\Cache\Storage\Adapter\Filesystem
.
Nebenbei wird das Serializer Plugin hinzugefügt, damit auch andere Datentypen wie Arrays gespeichert werden können
und das Plugin ExceptionHandler wodurch Fehler nach “cache_error.log” geloggt werden
und die Anwendung sich nicht um Exceptions aus dem Cache kümmern muss.
Nun wollen wir ein RSS-Feed abrufen und dieses cachen:
$feedUrl = 'http://mabe.berlin/rss.xml';
$cacheKey = 'feed_' . md5($feedUrl);
$result = $cache->get($cacheKey);
if (!$result instanceof SimpleXmlElement) {
$result = simplexml_load_file($feedUrl);
if (!$result) {
die("Can't load '{$feedUrl}'");
}
$cache->set($cacheKey, $result);
}
Mit dem noch folgenden Artikel werde ich einen Einblick in den Namensraum von Zend\Cache\Pattern
geben.
Bis hierher erstmal happy coding :)