Перейти до вмісту

Кешування

Blockstudio містить постійні кеші на основі файлів. Вони ввімкнені за замовчуванням параметром cache.enabled і записуються сюди:

Код
wp-content/blockstudio/cache/

Цей єдиний налаштований кореневий каталог містить корисні дані збирання середовища виконання, попередньо створені дані реєстрації блоків, ресурси редактора, Tailwind CSS, відрендерені документи, фрагменти островів, статичні HTML, індекси графів, черги прогрівання та діагностику кешу. Це дає змогу не повторювати пошук, розбір, компіляцію й рендеринг, зберігаючи весь згенерований стан середовища виконання в межах, якими може керувати хост.

За задумом стандартний каталог розташований поза uploads, де захищені хости можуть блокувати корисні дані кешу PHP. Змініть розташування за допомогою cache.path; відносні шляхи визначаються від WP_CONTENT_DIR, а абсолютні дають змогу використовувати окремі доступні для запису томи кешу:

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

Для конфігурації, специфічної для середовища, скористайтеся фільтром параметра або фільтром визначеного каталогу:

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';
});

Зміна шляху запускає роботу з порожнім кешем. Старі файли в wp-content/uploads/blockstudio/cache більше не читаються, їх можна видалити.

Ідентифікація та інвалідація

Кожна область кешування вкладена в ідентифікатор мережі/блогу та повний ідентифікатор середовища виконання. Записи кешу змінюються разом зі зміною вхідних даних, зокрема файлів блоків під наглядом, файлів полів, залежностей ресурсів, параметрів, активної теми, активних плагінів, логічних переліків джерел пошуку, версій WordPress, PHP і Blockstudio. Хеші залежностей для окремих елементів відокремлюють збирання лише змінених даних від не пов’язаних об’єктів.

Логічні джерела пошуку також додають свій ідентифікатор джерела, відбиток вмісту й вхідні дані для відстеження. Альтернативні вибори середовища виконання можуть додати значення blockstudio/cache/context, щоб ізолювати всі області кешування. Хости, де межа між клієнтами відрізняється від ідентифікаторів мережі/блогу WordPress, можуть фільтрувати blockstudio/cache/site_key; перед використанням у сегменті шляху значення проходить очищення.

Під час актуального запиту до фронтенду Blockstudio завантажує реєстр середовища виконання перед створенням джерел пошуку. Тому в разі дійсного кешованого результату можна пропустити рекурсивний пошук джерел, створення блоків, розбір полів і повторний обхід дерева для побудови ключів кешу.

Середовище виконання також зберігає визначені шляхи до ресурсів блоків, їхні розміри, часові позначки та списки таблиць стилів модулів. Запити після прогрівання повторно використовують ці метадані, не виконуючи для кожного відрендереного блоку повторний пошук згенерованих ресурсів і сканування каталогів модулів. Фільтри URL ресурсів і вимкнення продовжують виконуватися для поточного запиту, а assets.inlineLimit зберігає загальний для сторінки бюджет і порядок каскаду. Метадані про згенеровані ресурси не збираються, якщо вимкнено assets.enqueue або постійне кешування. Застаріла остання успішна збірка переходить до визначення ресурсів на диску.

Незмінені розв’язані налаштування також повторно використовують свій відбиток у межах запиту. Перезавантаження або зміна налаштувань робить його недійсним; для змінюваних значень об’єктів або посилань хеш обчислюється повторно, а потенційно застарілий відбиток не використовується повторно.

У production і staging перевірений знімок стану файлів вважається актуальним протягом 20 секунд, перш ніж Blockstudio повторно отримає дані про їхні файли й каталоги. У середовищах local і development за замовчуванням установлено нульове значення, щоб зміни джерел було видно відразу. Змініть цей інтервал так:

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

Затримка може відкласти автоматичне виявлення змін у джерелі не більше ніж на налаштовану кількість секунд. Обов’язкові скомпільовані ресурси, кешовані непорожні вихідні ресурси та таблиці стилів модулів усе одно перевіряються під час кожного звернення до кешу. Видалення будь-якого з них негайно робить корисне навантаження середовища виконання недійсним, замість того щоб віддавати застарілі метадані ресурсів до завершення періоду очікування. Установіть затримку на 0, якщо середовище, подібне до виробничого, також використовується для активного редагування файлів.

Файли корисного навантаження захищені PHP. Для невеликих даних використовуються звичайні масиви, якщо процес запису має активну спільну пам’ять OPcache, а цільовий файл не виключено. Тоді OPcache може повторно використовувати скомпільований масив під час наступних підключень; зміна повернених даних і далі використовує звичайну поведінку копіювання під час запису в PHP.

Без OPcache зі спільною пам’яттю корисні дані залишаються стисненими серіалізованими даними. Це також стосується випадків, коли OPcache заповнений, його API недоступний або обмежений, чи його чорний список або opcache.max_file_size виключає файл. OPcache лише з файловим кешем не вибирає формат звичайного масиву. Див. конфігурацію OPcache для цих налаштувань на рівні хоста. PHP

Типовий формат звичайного масиву обмежено 1 MiB за розміром серіалізованих даних і згенерованого вихідного коду PHP. Більші дані залишаються стисненими, щоб уникнути витрат на компіляцію великих масивів, коли процес CLI без OPcache читає кеш, попередньо заповнений вебворкерами. На такому пристрої читання навіть невеликі звичайні файли все одно потрібно аналізувати, а щойно записані файли, можливо, доведеться компілювати під час opcache.file_update_protection.

Фільтр blockstudio/cache/compress перевизначає формат для кожної області, наприклад, коли WP-CLI заповнює файли кешу для вебворкерів із увімкненим OPcache. Повернення false також скасовує обмеження розміру: робіть це лише тоді, коли кожен процес читання може обробити згенерований файл PHP. Якщо zlib недоступний, звичайний PHP залишається резервним варіантом.

Паралельність і зберігання

Для ключів холодного кешу використовується блокування типу single-flight. Один запит створює корисні дані, а паралельні запити чекають на атомарно опублікований результат, замість того щоб повторювати пошук або компіляцію. Атомарна публікація запобігає появі часткових об’єктів. Якщо оновлення не вдається, дійсний застарілий об’єкт із останнім успішним результатом залишається доступним, помилка фіксується, а наступний запит може відновити роботу.

За замовчуванням області середовища виконання зберігають 20 опублікованих корисних даних. Змініть обмеження для кожної області, якщо інтеграція навмисно створює більше контекстів кешу:

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

Під час очищення не видаляються файли, на які посилається встановлена мапа ранньої видачі, а фільтр blockstudio/cache/protected_paths позначає додаткові шляхи, які потрібно зберегти.

Невикористані простори імен автоматично очищуються, тож вони не накопичуються після кожної активації плагіна та оновлення PHP чи WordPress. У фрагменті розгортання, який раніше шукав файли за шаблоном у старому каталозі кешу Tailwind, тепер слід викликати Blockstudio\Runtime_Cache::purge('tailwind').

Простір імен виводиться з використання, коли змінюється ідентифікатор середовища виконання, наприклад після оновлення ядра WordPress. Під час першого циклу очищення, який виявляє його застарілим, у ньому записується маркер .retired; дерево очищується, коли відтоді мине cache.namespaceGrace секунд (за замовчуванням — один день). Якщо за цей час дерево буде записано повторно, відлік пільгового періоду почнеться спочатку. Не очищуються ні поточний простір імен області кешування, ні простір імен, з якого мапа ранньої видачі все ще обслуговує активований артефакт; для останнього пільговий період починається, коли під час наступної активації запис мапи буде перенесено в інше місце. На сторінках, кешованих поза WordPress, і далі використовуються таблиці стилів із хешем вмісту, з якими їх було відрендерено. Тому для сайту, який обслуговує сторінки tailwind.output: "link" через CDN або з тривалим кешуванням у браузері, слід збільшити пільговий період до найдовшого часу існування такої копії:

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

Якщо оновлена інсталяція містить плаский каталог cache/runtime з версії до 7.6, Blockstudio атомарно перейменовує його, прибираючи з активного шляху. Потім завдання WP-Cron видаляє не більше ніж 500 елементів файлової системи за один прохід. Це не дає старим корисним даним і деревам .build.lock займати диск, водночас не змушуючи запит, який виявив великий каталог, рекурсивно видаляти його. Очищення виконується, лише коли активний cache.enabled; змініть розмір пакета за допомогою blockstudio/cache/legacy_cleanup_batch_size, якщо хосту потрібні менші або більші порції.

Вимкніть постійні кеші в blockstudio.json:

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

Або через фільтр:

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

Кеш рендерингу в пам’яті на один запит, описаний у розділі Продуктивність, навмисно відокремлений, але його постійні артефакти використовують ті самі межі файлової системи.

Очищення черги застарілих блокувань

У версіях до 7.6.14 після кожної зміни вмісту залишався один файл .build.lock, і на завантаженому сайті їх може бути сотні тисяч. Після оновлення WP-Cron самостійно видаляє їх обмеженими порціями. Щоб одразу очистити чергу й отримати кількість від хоста, запустіть CLI:

Командна оболонка
wp bs cache status
wp bs cache cleanup

status підраховує решту застарілих блокувань і повідомляє, коли запуститься наступна порція. cleanup запускає порції, доки не залишиться жодного неактивного блокування, а потім очищує простори імен кешу, для яких минув пільговий період. Блокування, створені менш ніж годину тому або досі утримувані активним запитом, залишаються до наступного проходу. Ніколи не видаляйте файли блокувань вручну, поки сайт обслуговує трафік: утримуване блокування координує запити, щоб вони не створювали збірки паралельно.

wp bs cache clear очищує весь кеш середовища виконання поточного сайту або область кешування в усіх просторах імен за допомогою --scope=runtime. Під час наступного запиту кеш збиратиметься з нуля, тому запускайте команду за низького трафіку.

Кеш Tailwind

Скомпільований кеш CSS від Tailwind використовує спільний кореневий каталог середовища виконання в просторі імен network/site/runtime та області tailwind. За замовчуванням у ньому зберігається до 1,000 записів протягом 30 днів — цього достатньо, щоб зберегти ключі для всіх сторінок сайту замість їх видалення після перегляду лише кількох маршрутів.

Tailwind також повторно використовує актуальний компілятор для того самого вхідного CSS у довготривалих процесах і зберігає стан створення компілятора між процесами. Набори кандидатів для холодних сторінок усе одно компілюються окремо, але щоразу не потрібно заново створювати аналізатор фреймворку.

Використовуйте ці фільтри, щоб змінити строк зберігання:

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

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

Мінімальний вік — одна година.

Файли кешу мають хеші вмісту, а кешована сторінка посилається на них по одному через URL, тому під час очищення дані сторінки можуть не відповідати тому, які файли ще потрібні. Перед показом попередньо відрендерені документи перевіряються на наявність пов’язаної таблиці стилів, тож видалення файла спричиняє повторний рендеринг, а не показ сторінки без стилів. Якщо встановити cache_max_files вище за кількість унікальних ключів сторінок, повторного рендерингу не буде.

Статичне попереднє рендерення

Анонімний кеш HTML у цьому самому кореневому каталозі.