4.2. Teoria buforowania
Poprzedni | Rozdział 4. Zend_Cache | Następny

## 4.2. Teoria buforowania

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()`).

| Notatka
Warunkowe uruchamianie twojego kodu nie jest konieczne w niektórych frontendach (na przykład `Function`), gdzie cała logika jest zaimplementowana we frontendzie.

| Notatka
'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.

### 4.2.1. Metoda fabryki `Zend_Cache`

Dobrym sposobem utworzenia użytecznej instancji frontendu `Zend_Cache` jest ten pokazany w poniższym przykładzie:

    <?php

    # Ładujemy fabrykę Zend_Cache
    require 'Zend/Cache.php';

    # 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([...]);

    # We make the good instance
    # (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.

| Notatka
Zawsze używaj metody `Zend_Cache::factory()` aby pobrać instancje frontendu. Tworzenie instancji frontendu czy backendu nie będzie przynosiło oczekiwanych rezultatów.

### 4.2.2. Nadawanie etykiet rekordom

Etykeity 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):

    <?php

    $cache->save($huge_data, 'myUniqueID', array('tagA', 'tagB', 'tagC'));

    ?>

| Notatka
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.

### 4.2.3. Czyszczenie bufora

Aby usunąć/unieważnić rekord bufora o określonym id, możesz użyć metody `remove()`:

    <?php

    $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:

    <?php

    // 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':

    <?php

    $cache->clean(Zend_Cache::CLEANING_MODE_MATCHING_TAG, array('tagA', 'tagC'));

    ?>

Dostępne tryby czyszczenia bufora to: `CLEANING_MODE_ALL`, `CLEANING_MODE_OLD`, `CLEANING_MODE_MATCHING_TAG` oraz `CLEANING_MODE_NOT_MATCHING_TAG`. Dwa ostatnia, jak nazwa wskazuje, mogą w operacji czyszczenia być użyte wraz z tablicą etykiet.

Poprzedni | Początek rozdziału | Następny
Rozdział 4. Zend_Cache | Spis treści | 4.3. Frontendy Zend_Cache