# Gyorsítótárak

> A tartós gyorsítótár működése a kapcsolódó rendeléseknél és a vásárlói előfizetéseknél, a kezelőeszközök és a kikapcsolás.

Az Előfizetések tartós (perzisztens) gyorsítótárat használ, hogy elkerülje a lassú adatbázis-lekérdezéseket. Ez gyorsítja a megújítási fizetések feldolgozását, a **Fiókom → Előfizetések** oldal betöltését, és bizonyos esetekben a vásárlóknak megjelenő termék- és bolti oldalakét is.

A gyorsítótár két adatot tárol:

- egy előfizetés kapcsolódó rendeléseit;
- egy vásárló összes előfizetését.

## Kapcsolódó rendelések

Egy előfizetésnek többféle kapcsolódó rendelése lehet: megújítási, újrafeliratkozási és váltási rendelés. Az adatbázisban a kapcsolatot a rendelés (egyéni bejegyzéstípus) meta táblájában egy meta kulcs rögzíti, amelynek értéke az előfizetés azonosítója. Például a 456-os rendelés a 123-as előfizetés megújítása így:

- `post_id`: `456`
- `meta_key`: `_subscription_renewal`
- `meta_value`: `123`

A kapcsolódó rendelések gyorsítótára szintén a post meta táblában van, de az összes kapcsolódó rendelés azonosítója egyetlen sorban az előfizetésen. Például a 123-as előfizetés 456-os és 789-es megújítási rendelésénél:

- `post_id`: `123`
- `meta_key`: `_subscription_renewal_order_ids_cache`
- `meta_value`: `a:2:{i:0;i:456;i:0;i:789;}`

Így az előfizetés összes megújítási rendelésének kikereséséhez egy `get_post_meta()` hívás elég. A gyorsítótár meta kulcsai:

- váltási rendelések: `_subscription_switch_order_ids_cache`
- megújítási rendelések: `_subscription_renewal_order_ids_cache`
- újrafeliratkozási rendelések: `_subscription_resubscribe_order_ids_cache`

## Vásárlói előfizetések

Az előfizetés az adatai szempontjából a rendelés kiterjesztése, ezért a vásárlóhoz kapcsolása is ugyanúgy történik, mint a rendeléseké. A 456-os előfizetés a 123-as felhasználóhoz így kötődik:

- `post_id`: `456`
- `meta_key`: `_customer_user`
- `meta_value`: `123`

A vásárlói előfizetések gyorsítótára nem a post meta, hanem a user meta táblában van, az összes előfizetés azonosítója egy sorban a felhasználón:

- `user_id`: `123`
- `meta_key`: `_wcs_subscription_ids_cache`
- `meta_value`: `a:2:{i:0;i:456;i:0;i:789;}`

Egy felhasználó előfizetéseihez így egy `get_user_meta()` hívás elég.

## Kezelőeszközök

A gyorsítótárak létrehozására és törlésére külön eszközök vannak.

1. Nyisd meg a **WooCommerce → Állapot** oldalt.
2. Kattints az **Eszközök** fülre.
3. Görgess a gyorsítótár-kezelő eszközökhöz.
4. Kattints a futtatni kívánt eszköz gombjára.

![A WooCommerce Állapot oldal Eszközök fülén a négy előfizetési gyorsítótár-kezelő eszköz.](./kepek/fejlesztoknek-gyorsitotar-eszkozok.webp)

*A WooCommerce Állapot oldal Eszközök fülén a négy előfizetési gyorsítótár-kezelő eszköz.* (https://minta-bolt.hu/wp-admin/admin.php?page=wc-status&tab=tools)

A képen a négy eszköz látszik: **Kapcsolódó rendelések gyorsítótárának létrehozása**, **Kapcsolódó rendelések gyorsítótárának törlése**, **Vásárlói előfizetési gyorsítótár létrehozása** és **Vásárlói előfizetési gyorsítótár törlése**.

A gyorsítótár általában „éppen időben” jön létre: amikor az adatra először van szükség, a rendszer a forrásból olvassa ki és eltárolja. Az eszközök ugyanezt előre is elvégzik, de a háttérben, kis adagokban, hogy ne lassítsák az oldalt. Ezért sok időt vehet igénybe: nagy áruházban, százezres előfizetés-számnál akár egy hétnél is tovább.

## Hogyan működik a kód oldaláról

A gyorsítótár adattároló osztályokban valósul meg, hogy könnyen cserélhető, bővíthető vagy kikapcsolható legyen:

- `WCS_Related_Order_Store_Cached_CPT`: a kapcsolódó rendelések gyorsítótára. A `WCS_Related_Order_Store_CPT` osztályt bővíti, és ha nincs tárolt érték, közvetlen lekérdezéshez tér vissza.
- `WCS_Customer_Store_Cached_CPT`: a vásárló előfizetéseinek gyorsítótára. A `WCS_Customer_Store_CPT` osztályt bővíti, és ugyanígy visszalép közvetlen lekérdezésre.

A `wcs_related_order_store_class` szűrő a kapcsolódó rendelések tárát cseréli, a `wcs_customer_store_class` a vásárlói előfizetésekét. A visszaadott osztálynév példányosul a `WCS_Related_Order_Store::instance()`, illetve a `WCS_Customer_Store::instance()` hívásokkor.

Így kapcsolható ki a gyorsítótár:

```php
add_filter( 'wcs_related_order_store_class', 'wcs_bypass_related_order_cache_layer' );

function wcs_bypass_related_order_cache_layer( $class ) {
    return 'WCS_Related_Order_Store_CPT';
}

add_filter( 'wcs_customer_store_class', 'wcs_bypass_customer_subscriptions_cache_layer' );

function wcs_bypass_customer_subscriptions_cache_layer( $class ) {
    return 'WCS_Customer_Store_CPT';
}
```

## Miért van rá szükség

A bővítmény WordPress egyéni bejegyzéstípusokra épül, ezért az adatai olyan táblákban vannak, amelyekben a többi tartalom is: bejegyzések, oldalak, WooCommerce-rendelések, más bővítmények adatai. A meta táblák gyakran több százezer vagy millió soros méretűek, és a meta-lekérdezések (például a `get_posts()` által generált `JOIN`) lassúak. A megújítási rendelés az előfizetéssel például meta-adaton át kapcsolódik, így a megkereséséhez ilyen lekérdezés kellene.

A tartós gyorsítótár az első futtatáskor eltárolja a lekérdezés eredményét, és később abból dolgozik. Frissül, amikor valami érvényteleníti, például létrejön vagy törlődik egy releváns adat: új megújítási rendelés létrehozásakor az azonosítója bekerül a gyorsítótárba, törléskor kikerül belőle. Így a lassú lekérdezések csak egyszer futnak.

A WordPress tranziensekkel ellentétben a gyorsítótár **nem jár le**. Csak kézi törléskor ürül, például az eszközökkel, máskor frissen tartja magát minden érvénytelenítő esemény után.

A szülő rendelés a `post_parent` oszlopon át kapcsolódik az előfizetéshez, ami gyors lekérdezést ad (az adott szülő rendelés összes előfizetése és az előfizetés szülő rendelése), ezért a szülő rendelést nem kell gyorsítótárazni.
