Кэширование
Blockstudio включает постоянные кэши на основе файлов. По умолчанию они включены параметром cache.enabled и записываются в:
wp-content/blockstudio/cache/
Этот единственный настроенный корневой каталог хранит полезные данные сборки среды выполнения, предварительно собранные данные регистрации блоков, ресурсы редактора, Tailwind CSS, отрисованные документы, фрагменты островов, статические HTML, индексы графа, очереди прогрева и диагностические данные кэша. Это избавляет от повторного поиска, разбора, компиляции и отрисовки, сохраняя все созданное состояние среды выполнения в одном месте, управляемом хостом.
По умолчанию каталог намеренно размещен вне uploads, где защищенные хосты могут блокировать полезные данные кэша PHP. Измените расположение с помощью cache.path; относительные пути отсчитываются от WP_CONTENT_DIR, а абсолютные позволяют использовать выделенные тома с правом записи для кэша:
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Для настройки среды используйте фильтр параметра или фильтр определенного каталога:
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 по умолчанию используется ноль, чтобы изменения исходных файлов были видны сразу. Измените этот интервал с помощью:
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 остается запасным вариантом.
Параллельная работа и хранение
Для холодных ключей кэша используется блокировка с одним исполнителем. Один запрос создает полезные данные, а параллельные запросы ожидают атомарной публикации результата вместо повторного поиска и компиляции. Атомарная публикация предотвращает появление неполных объектов. Если обновление завершается с ошибкой, доступен действительный последний объект, зафиксирована ошибка, а следующий запрос может восстановить работу.
По умолчанию области среды выполнения хранят 20 опубликованных полезных данных. Измените лимит для каждой области, если интеграция намеренно создает больше контекстов кэша:
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 или браузерный кэш с длительным сроком хранения, следует увеличить льготный период до максимального срока жизни такой копии:
{
"cache": {
"namespaceGrace": 777600
}
}
При обновлении установки, содержащей плоский каталог cache/runtime версии до 7.6, Blockstudio атомарно переименовывает его, убирая из активного пути. Затем задание WP-Cron удаляет не более 500 записей файловой системы за один проход. Это не дает старым полезным данным и деревьям .build.lock занимать место на диске и при этом не заставляет запрос, обнаруживший большой каталог, рекурсивно удалять его. Очистка выполняется, только пока активен cache.enabled; измените размер пакета с помощью blockstudio/cache/legacy_cleanup_batch_size, если хосту нужны меньшие или большие проходы.
Отключите постоянные кэши в blockstudio.json:
{
"cache": {
"enabled": false
}
}
Или с помощью фильтра:
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 использует общий корневой каталог среды выполнения в пространстве имен сеть/сайт/среда выполнения и область tailwind. По умолчанию он хранит до 1,000 записей в течение 30 дней — этого достаточно, чтобы хранить ключи уровня страниц для всего сайта, а не удалять их после небольшого числа маршрутов.
Tailwind также повторно использует прогретый компилятор для одного и того же входного CSS в долгоживущих процессах и сохраняет состояние создания компилятора между процессами. Холодные наборы кандидатов страниц по-прежнему компилируются независимо, но при этом не требуется каждый раз заново собирать парсер фреймворка.
Используйте эти фильтры, чтобы изменить срок хранения:
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, расположенный в том же корневом каталоге.