Treci la conținut

Memorare în cache

Blockstudio include memorii cache persistente, bazate pe fișiere. Acestea sunt activate implicit prin setarea cache.enabled și sunt scrise în:

Cod
wp-content/blockstudio/cache/

Această rădăcină configurată găzduiește datele de compilare pentru mediul de execuție, datele precompilate pentru înregistrarea blocurilor, resursele editorului, Tailwind CSS, documentele randate, fragmentele de insulă, HTML statice, indexurile grafului, cozile de încălzire și diagnosticele memoriei cache. Astfel se evită repetarea operațiilor de descoperire, analizare, compilare și randare, păstrând în același timp toată starea generată a mediului de execuție într-o singură limită gestionabilă de gazdă.

În mod intenționat, valoarea implicită se află în afara uploads, unde gazdele securizate pot bloca datele din memoria cache PHP. Schimbați locația cu cache.path; căile relative sunt rezolvate pornind de la WP_CONTENT_DIR, iar căile absolute permit utilizarea unor volume de cache dedicate, pe care se poate scrie:

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

Pentru configurarea specifică mediului, folosiți fie filtrul setării, fie filtrul directorului rezolvat:

PHP
add_filter('blockstudio/settings/cache/path', function () {
    return '/srv/wordpress-cache/blockstudio';
});

add_filter('blockstudio/cache/dir', function (string $directory): string {
    return WP_CONTENT_DIR . '/cache/blockstudio';
});

Schimbarea căii pornește cu o memorie cache rece. Fișierele vechi din wp-content/uploads/blockstudio/cache nu mai sunt citite și pot fi șterse.

Identitate și invalidare

Fiecare domeniu este imbricat sub identitatea rețelei/blogului și o identitate completă a mediului de execuție. Intrările din memoria cache se schimbă odată cu intrările lor, inclusiv fișierele de blocuri monitorizate, fișierele de câmpuri, dependențele de resurse, setările, tema activă, modulele active, inventarele logice de descoperire și versiunile WordPress, PHP și Blockstudio. Hashurile dependențelor specifice fiecărui element izolează compilările care includ doar elementele modificate de obiectele fără legătură.

Sursele logice de descoperire contribuie și ele cu ID-ul sursei, amprenta conținutului și intrările monitorizate. Selecțiile alternative ale mediului de execuție pot adăuga o valoare blockstudio/cache/context pentru a izola toate domeniile memoriei cache. Gazdele a căror limită pentru chiriași diferă de ID-urile de rețea/blog WordPress pot filtra blockstudio/cache/site_key; rezultatul este igienizat înainte de a deveni un segment de cale.

La o cerere frontend cu memoria cache activă, Blockstudio încarcă registrul mediului de execuție înainte de a construi sursele de descoperire. Prin urmare, o intrare validă în memoria cache evită descoperirea recursivă a surselor, construirea blocurilor, analizarea câmpurilor și parcurgerile repetate ale arborelui pentru cheia memoriei cache.

Datele de execuție stochează și căile rezolvate către resursele blocurilor, dimensiunile, marcajele temporale și listele de foi de stil ale modulelor. Solicitările ulterioare reutilizează aceste metadate, în loc să repete căutările rezultatelor resurselor și scanările directoarelor modulelor pentru fiecare bloc randat. Filtrele URL pentru resurse și dezactivare se execută în continuare pentru solicitarea curentă, iar assets.inlineLimit își păstrează bugetul la nivelul întregii pagini și ordinea în cascadă. Nu se colectează metadate despre rezultatele resurselor când assets.enqueue sau memoria cache persistentă este dezactivată. O versiune învechită a ultimei compilări valide rezolvă din nou resursele de pe disc.

Setările rezolvate care nu s-au schimbat își reutilizează și amprenta digitală în cadrul cererii. Reîncărcarea sau modificarea setărilor o invalidează; valorile mutabile de tip obiect sau referință sunt re-hash-uite, în loc să se reutilizeze o amprentă potențial învechită.

În production și staging, un instantaneu validat al monitorizării este considerat de încredere timp de 20 de secunde înainte ca Blockstudio să verifice din nou statisticile fișierelor și directoarelor. Mediile local și development au implicit valoarea zero, astfel încât modificările sursei să fie vizibile imediat. Schimbați intervalul astfel:

PHP
add_filter('blockstudio/cache/watch_debounce', function () {
    return 30;
});

Debounce-ul poate întârzia detectarea automată a modificărilor sursei cu cel mult numărul configurat de secunde. Activele compilate necesare, activele brute necompletate din cache și foile de stil ale modulelor sunt verificate în continuare la fiecare accesare a cache-ului. Ștergerea unuia dintre acestea invalidează imediat payload-ul de execuție, în loc să servească metadate învechite despre active până la expirarea intervalului. Setați debounce-ul la 0 atunci când un mediu similar producției este folosit și pentru editarea activă a fișierelor.

Payload-urile din cache sunt protejate prin fișiere PHP. Payload-urile mici folosesc tablouri simple când procesul de scriere are memorie partajată OPcache activă, iar destinația nu este exclusă. Astfel, OPcache poate reutiliza tabloul compilat la includerile ulterioare; modificarea datelor returnate păstrează comportamentul obișnuit copy-on-write al PHP.

Fără OPcache cu memorie partajată, încărcăturile utile rămân date serializate comprimate. Acest lucru se aplică și când OPcache este plin, când API nu este disponibilă sau este restricționată ori când lista neagră sau opcache.max_file_size exclude fișierul. OPcache doar cu cache de fișiere nu selectează formatul de tablou simplu. Consultați configurația OPcachePHP pentru aceste controale la nivel de gazdă.

Formatul implicit cu tablouri simple este limitat la 1 MiB, măsurat atât pentru datele serializate, cât și pentru sursa PHP generată. Payload-urile mai mari rămân comprimate, pentru a evita costurile compilării tablourilor mari când un proces CLI fără OPcache citește un cache încălzit de procese web. Fișierele simple mici tot trebuie analizate de un astfel de cititor, iar fișierele scrise recent pot necesita compilare în timpul opcache.file_update_protection.

Filtrul blockstudio/cache/compress suprascrie formatul pentru fiecare domeniu, de exemplu când WP-CLI încălzește fișierele cache pentru procese web cu OPcache activat. Returnarea valorii false suprascrie și limita de dimensiune: procedați astfel numai dacă fiecare cititor poate gestiona fișierul PHP generat. Dacă zlib nu este disponibil, PHP simplu rămâne opțiunea de rezervă.

Concurență și păstrare

Cheile pentru memoria cache rece folosesc o blocare single-flight. O cerere construiește datele, în timp ce cererile concurente așteaptă rezultatul publicat atomic, în loc să repete aceeași operație de descoperire sau compilare. Publicarea atomică împiedică apariția obiectelor parțiale. Dacă actualizarea eșuează, un obiect valid, învechit, dar funcțional rămâne disponibil, eroarea poate fi observată, iar următoarea cerere poate remedia situația.

În mod implicit, domeniile mediului de execuție păstrează 20 de date publicate. Ajustați limita per domeniu când o integrare creează în mod intenționat mai multe contexte pentru memoria cache:

PHP
add_filter(
    'blockstudio/cache/max_files_per_scope',
    function (int $maximum, string $scope): int {
        return 'runtime' === $scope ? 50 : $maximum;
    },
    10,
    2
);

Păstrarea nu elimină niciodată un fișier la care face referire harta instalată pentru servire timpurie, iar filtrul blockstudio/cache/protected_paths marchează căi suplimentare pe care curățarea trebuie să le lase intacte.

Spațiile de nume neutilizate sunt colectate automat, în loc să se acumuleze la fiecare activare de modul sau actualizare PHP ori WordPress. Un fragment de implementare care parcurgea cu glob vechiul director de cache Tailwind trebuie să apeleze acum Blockstudio\Runtime_Cache::purge('tailwind').

Un spațiu de nume este retras când identitatea mediului de execuție se schimbă, de exemplu după o actualizare a nucleului WordPress. Prima operațiune de curățare care îl identifică drept retras scrie în acesta un marcaj .retired, iar arborele este colectat după ce au trecut cache.namespaceGrace secunde (o zi în mod implicit). Dacă arborele este scris din nou între timp, perioada de grație începe de la capăt; nu este colectat nici spațiul de nume curent al unui domeniu, nici unul din care harta pentru servire timpurie continuă să servească un artefact activat. Perioada de grație pentru cel din urmă începe când următoarea activare mută intrarea hărții în altă parte. Paginile memorate în cache în afara WordPress continuă să conțină legături către foile de stil cu hash de conținut cu care au fost randate, așa că un site care servește pagini tailwind.output: "link" printr-un CDN sau o memorie cache lungă în browser ar trebui să mărească perioada de grație la cea mai lungă durată de viață a unei astfel de copii:

JSON
{
  "cache": {
    "namespaceGrace": 777600
  }
}

Când o instalare actualizată conține directorul plat cache/runtime anterior versiunii 7.6, Blockstudio îl redenumește atomic, scoțându-l din calea activă. Apoi, o sarcină WP-Cron elimină cel mult 500 intrări din sistemul de fișiere la fiecare rundă. Astfel, vechile date și arborii .build.lock nu ocupă spațiu pe disc, fără ca cererea care detectează un director mare să fie nevoită să îl șteargă recursiv. Curățarea se execută numai când cache.enabled este activ; schimbați dimensiunea lotului cu blockstudio/cache/legacy_cleanup_batch_size dacă gazda are nevoie de runde mai mici sau mai mari.

Dezactivați memoriile cache persistente în blockstudio.json:

JSON
{
  "cache": {
    "enabled": false
  }
}

Sau printr-un filtru:

PHP
add_filter('blockstudio/settings/cache/enabled', '__return_false');

Memoria cache de randare în memorie, per cerere, descrisă la Performanță este separată în mod intenționat, însă artefactele sale persistente folosesc aceeași limită a sistemului de fișiere.

Golirea unui șir de blocări vechi

Versiunile anterioare lui 7.6.14 lăsau în urmă câte un fișier .build.lock pentru fiecare modificare de conținut, iar un site aglomerat poate ajunge să aibă sute de mii de astfel de fișiere. După upgrade, WP-Cron le elimină automat în loturi cu dimensiune limitată. Pentru a goli imediat restanțele și a oferi gazdei un număr, rulați CLI:

Shell
wp bs cache status
wp bs cache cleanup

status numără blocările vechi rămase și anunță când rulează următorul lot. cleanup rulează loturi până când nu mai rămâne nimic inactiv, apoi colectează spațiile de nume ale memoriei cache pentru care a expirat perioada de grație. Blocările mai noi de o oră sau deținute încă de o cerere în curs sunt lăsate pentru următoarea rundă. Nu ștergeți niciodată manual fișierele de blocare cât timp site-ul deservește trafic; o blocare deținută determină care cerere va continua, împiedicând cererile concurente să construiască în paralel.

wp bs cache clear golește întreaga memorie cache a mediului de execuție pentru site-ul curent sau un singur domeniu din toate spațiile de nume, cu --scope=runtime. Următoarea cerere reconstruiește totul cu o memorie cache rece, așa că rulați comanda când traficul este redus.

Memoria cache Tailwind

Memoria cache compilată CSS a Tailwind folosește rădăcina comună a mediului de execuție, în spațiul de nume rețea/site/mediu de execuție și domeniul tailwind. În mod implicit, stochează cel mult 1,000 de intrări timp de 30 de zile, suficient pentru a păstra cheile la nivel de pagină pentru un site întreg, fără a le elimina după un număr mic de rute.

Tailwind reutilizează un compilator activ pentru aceeași intrare CSS în procesele de lungă durată și păstrează starea de construire a compilatorului între procese. Seturile reci de candidați pentru pagină sunt compilate separat, dar analizorul cadrului de lucru nu trebuie reconstruit de fiecare dată.

Folosiți aceste filtre pentru a schimba perioada de păstrare:

PHP
add_filter('blockstudio/tailwind/cache_max_files', function () {
    return 1500;
});

add_filter('blockstudio/tailwind/cache_max_age', function () {
    return 14 * DAY_IN_SECONDS;
});

Vechimea minimă este de o oră.

Fișierele din memoria cache au un hash de conținut, iar o pagină memorată în cache conține o legătură către unul prin URL, așa că eliminarea din memoria cache și pagina stocată pot să nu concorde în privința fișierelor care mai sunt necesare. Documentele pre-randate sunt verificate în raport cu foaia de stil asociată înainte de a fi servite, astfel încât eliminarea unui fișier duce la o singură randare nouă, nu la o pagină fără stiluri. Dacă măriți cache_max_files peste numărul cheilor distincte la nivel de pagină, evitați complet randarea din nou.

Pre-randare statică

Memoria cache anonimă HTML care se află în aceeași rădăcină.