Są trzy kluczowe składniki w Zend_Cache. Pierwszym jest unikalny
identyfikator (łańcuch znakow) który jest używany do identyfikowania
rekordów bufora. Drugim jest dyrektywa 'lifetime' jaką
pokazano w przykładach; definiuje ona jak długo buforowany zasób jest
uznawany za 'świeży'. Trzecim kluczowym składnikiem jest warunkowe
wykonanie więc część twojego kodu może być ominięta, co powoduje wzrost
wydajności. Główna funkcja frontendu (np.
Zend_Cache_Core::get()) jest zawsze zaprojektowana tak, aby
zwracała wartość false gdy bufor jest nieaktualny, jeśli jest to
sensowne dla danego frontendu. To pozwala użytkownikom na ominięcie bloków
kodu, które chcą buforować, zawierając je w wyrażenie if(){ ... }
gdzie warunkiem jest metoda Zend_Cache. Na końcu
takich bloków musisz zapisać to co wygenerowałeś (np. za pomocą metody
Zend_Cache_Core::save()).
Uwaga
Warunkowe uruchamianie twojego kodu nie jest konieczne w niektórych frontendach (na przykład Function), gdzie cała logika jest zaimplementowana we frontendzie.
Uwaga
'bufor istnieje' jest wyrażeniem określającym sytuację, w której rekord bufora został znaleziony, jest poprawny i jest 'świeży' 'fresh' (innymi słowy jeszcze nie wygasł). 'Bufor nie istnieje' jest wszystkim innym. Kiedy zdarzy się, że bufor nie istnieje musisz wygenerować swoje dane (tak jak robisz to normalnie) i zapisać je w buforze. Z drugiej strony, gdy bufor istnieje, backend automatycznie pobierze rekord z bufora.
Dobrym sposobem utworzenia użytecznej instancji frontendu
Zend_Cache jest ten pokazany w poniższym przykładzie:
// Wybieramy backend (na przykład 'File' lub 'Sqlite'...)
$backendName = '[...]';
// Wybieramy frontend (na przykład 'Core', 'Output', 'Page'...)
$frontendName = '[...]';
// Ustawiamy tablicę opcji dla wybranego frontendu
$frontendOptions = array([...]);
// Ustawiamy tablicę opcji dla wybranego backendu
$backendOptions = array([...]);
// Tworzymy instancję klasy Zend_Cache
// (oczywiście dwa ostatnie argumenty są opcjonalne)
$cache = Zend_Cache::factory($frontendName,
$backendName,
$frontendOptions,
$backendOptions);
W poniższych przykładach założymy że zmienna $cache zawiera
poprawną instancję frontendu i to, że rozumiesz jak przekazać
parametry do wybranego backendu.
Uwaga
Zawsze używaj metody Zend_Cache::factory() aby pobrać
instancje frontendu. Tworzenie instancji frontendu czy backendu
nie będzie przynosiło oczekiwanych rezultatów.
Etykiety są sposobem kategoryzowania rekordów bufora. Kiedy zapisujesz bufor
za pomocą metody save(), możesz ustawić tablicę etykiet, które
mają być przypisane danemu rekordowi. Wtedy będziesz miał możliwość
usuwania wszystkich rekordów bufora oznaczonych daną etykietą (lub etykietami):
$cache->save($huge_data, 'myUniqueID', array('tagA', 'tagB', 'tagC'));
Uwaga
Zauważ, że metoda save() akceptuje opcjonalny czwarty
argument: $specificLifetime (jeśli jego wartość jest
inna od false, ustawiany jest określony czas ważności dla
konkretnego rekordu bufora.
Aby usunąć/unieważnić rekord bufora o określonym id, możesz użyć
metody remove():
$cache->remove('idToRemove');
Aby usunąć/unieważnić wiele rekordów bufora za jednym razem, możesz
użyć metody clean(). Na przykład aby usunąć wszystkie
rekordy bufora:
// czyszczenie wszystkich rekordów $cache->clean(Zend_Cache::CLEANING_MODE_ALL); // czyszczenie jedynie nieaktualnych rekordów $cache->clean(Zend_Cache::CLEANING_MODE_OLD);
Jeśli chcesz usunąć rekordy bufora oznaczone etykietami 'tagA' oraz 'tagC':
$cache->clean(
Zend_Cache::CLEANING_MODE_MATCHING_TAG,
array('tagA', 'tagC')
);
Jeśli chcesz usunąć rekordy bufora nieoznaczone etykietami 'tagA' oraz 'tagC':
$cache->clean(
Zend_Cache::CLEANING_MODE_NOT_MATCHING_TAG,
array('tagA', 'tagC')
);
Jeśli chcesz usunąć rekordy bufora oznaczone etykietami 'tagA' lub 'tagC':
$cache->clean(
Zend_Cache::CLEANING_MODE_MATCHING_ANY_TAG,
array('tagA', 'tagC')
);
Dostępne tryby czyszczenia bufora to: CLEANING_MODE_ALL,
CLEANING_MODE_OLD, CLEANING_MODE_MATCHING_TAG,
CLEANING_MODE_NOT_MATCHING_TAG oraz
CLEANING_MODE_MATCHING_ANY_TAG. Trzy ostatnie, jak
nazwa wskazuje, mogą w operacji czyszczenia być użyte wraz z tablicą
etykiet.