Nette Caching 4 opravuje ochranu před souběžným výpočtem stejné položky
Nette Caching 4.0.0 po čekání na souborový zámek znovu ověřuje, zda už jiný požadavek nepřipravil hotová data. Nové vydání přidává také úložiště Redis, ale při přechodu mění podmínky mazání cache a vyžaduje PHP 8.4.

Vývojáři Nette vydali 6. listopadu Nette Caching 4.0.0. Knihovna ukládá výsledky práce aplikace, například hotové HTML nebo výsledek databázového dotazu, aby je další požadavek nemusel počítat znovu. Nová hlavní verze opravuje souběh při čtení souborové cache, přidává úložiště Redis a zpřísňuje kontrolu podmínek, podle kterých data přestávají platit.
Po získání zámku se data přečtou ještě jednou
Představme si dva požadavky na stejnou stránku ve chvíli, kdy její uložená kopie právě vypršela. Oba zjistí, že chybí. První získá zámek, tedy výhradní právo připravit novou kopii, zatímco druhý čeká. Když první práci dokončí, druhý už má dostat jeho výsledek. Spouštět stejný výpočet znovu by bylo zbytečné.
Právě tady se mění FileStorage, úložiště v souborech. Po získání zámku nyní položku znovu přečte. Čekající proces tak najde hodnotu, kterou mezitím připravil jiný požadavek. Ochrana před návalem souběžných výpočtů se označuje jako cache stampede protection; verze 4 její chování v souborovém úložišti opravuje, nezavádí samotný princip cache.
Na straně aplikace zůstává vstupem metoda load(). Dostane klíč položky a funkci, která ji umí vytvořit, pokud uložená hodnota chybí. Pro vlastní úložiště ale přechod něco znamená: původní metoda Storage::lock() zmizela. Kdo chce stejnou ochranu poskytovat, implementuje rozhraní LockingReader s metodou readOrGenerate(), jak popisuje návod k přechodu.
Redis spojí cache několika serverů
Nové RedisStorage míří i na aplikace běžící na několika serverech. Místo oddělených souborů mají společná data v Redisu. Úložiště si samo vede tagy, tedy označení pro hromadné smazání souvisejících položek, i jejich priority. Nepotřebuje k nim samostatný index označovaný jako journal. Vyžaduje ovšem rozšíření PHP redis.
Podle dokumentace úložišť čekají ostatní procesy na tvůrce položky ve výchozím nastavení nejvýše 30 sekund. Dobu určuje parametr lockTimeout. Pokud výpočet trvá déle, může stejnou hodnotu začít připravovat i další proces. Ochrana tedy není příslib, že se libovolně dlouhá práce provede vždy právě jednou.
| Úložiště | Kde leží data | Ochrana souběžného výpočtu | Tagy a priority |
|---|---|---|---|
| FileStorage | Soubory na disku | Ano, souborový zámek | Přes samostatný journal |
| RedisStorage | Server Redis | Ano, s časovým limitem zámku | Spravuje samo |
| Psr16Storage | Existující cache s rozhraním PSR-16 | Ne | Přes samostatný journal |
Druhým přírůstkem je Psr16Storage, který dovoluje využít cache poskytovanou jinou knihovnou přes standard PSR-16. Opačný směr už obstarává PsrCacheAdapter: z úložiště Nette dělá cache pro kód očekávající PSR-16. Směry se liší i při práci s klíči. Nové úložiště je převádí na hash; adaptér nyní odmítá zakázané znaky, například dvojtečku v klíči user:1. Omezení plyne přímo ze standardu.
Mazání se řídí jmenným prostorem
Změnu chování přináší clean(all: true). Pokud objekt cache patří do jmenného prostoru, například articles, odstraní jen tento prostor a prostory z něj odvozené. Dříve mazal celé úložiště. Celkové vyprázdnění zůstává možné přes cache bez jmenného prostoru.
Záleží přitom na zvoleném úložišti. Psr16Storage mazání podle jmenných prostorů nepodporuje. Při vyprázdnění celé cache volá clear() podkladové PSR-16 cache, takže smaže i data jiného kódu, který ji sdílí, bez ohledu na předponu klíčů. Předpona sama tuto operaci neoddělí.
Platnost položky lze nově popsat objektem Dependencies, například dobou do vypršení a seznamem tagů. Dosavadní pole s konstantami Cache::* funguje dál. Překlep v názvu podmínky nebo hodnota špatného typu už ale vyvolá výjimku. Stejně skončí clean() bez podmínek; pro odstranění prošlých položek slouží clean([]) přímo na úložišti.
Přechod vyžaduje PHP 8.4
Čtvrtá řada vyžaduje PHP 8.4 a Nette Utils 4.1. Značka {cache} v šablonách potřebuje Latte 3.1. Migrační návod uvádí také odstranění starých rozhraní s předponou I a původních názvů služeb. Aktualizace proto vyžaduje kontrolu vlastních úložišť i konfigurace.
Podporu už začleňuje také jiný projekt: správce Nextras DBAL sloučil 8. listopadu změnu, která mezi povolené vývojové závislosti přidává Nette Caching 4 vedle řady 3. Jde o změnu v hlavní větvi repozitáře, nikoli o doklad, že každá vydaná verze DBAL tuto kombinaci podporuje.