Dennis · 27 июля 2026 г.
Blockstudio 7.6
Blockstudio 7.6 позволяет просматривать содержимое проекта и отображать его части через PHP, а настройки производственного интерфейса переносит в blockstudio.json: перечень API, автономное отображение, помощники шаблонов для медиа и Tailwind, профили производительности, единый каталог кеша, предварительное создание статических страниц с ранней раздачей, более строгие наборы правил анализа и сгенерированные инструменты проекта для кодовых агентов.
Основную часть релиза обеспечивают два вызова. Canvas::inventory() возвращает все страницы,
блоки, паттерны, шаблоны редактора сайта, части шаблонов и примеры из пакетов UI, зарегистрированные проектом. Render::document() возвращает готовый результат HTML для любого из них, включая именно те ресурсы, которые использовались при отображении.
7.6.2 обновление: страницы из файлов больше не сверяются при обычных запросах WordPress. Для применения изменений источника запустите
wp bs pages syncили вызовитеBlockstudio\Pages::reconcile(). Маршрутизация коллекций и настройки по умолчанию дляtemplateForиспользуют сохранённую конфигурацию среды выполнения, а при явной сверке больше не выполняется прежний большой запрос с условием OR по метаданным на многих языках. Кратковременная настройкаthemeDefaults.syncPagesInDevelopmentудалена, поскольку синхронизация страниц больше не запускается из хуков запросов. ТеперьPages::init()выполняется только при загрузке; интеграциям, передававшимforce, следует использоватьPages::reconcile()или CLI. При открытии Canvas по-прежнему выполняется одна явная аутентифицированная сверка перечня материалов для редактирования.
7.6.12 обновление: Таблицы стилей редактора теперь получают префиксы за один проход переписывания, а не компилируются через SASS для каждого ресурса. Поэтому холодная сборка редактора на сайте с большим количеством блоков больше не рискует превысить скромный лимит памяти. Если из кэша вытеснена таблица стилей Tailwind с хешем содержимого, страница с предварительным рендерингом создаётся заново, а не отдаётся без стилей, как через кэш PHP, так и через drop-in Early Serve. Атрибуты блоков, записанные на верхнем уровне, теперь считываются при рендеринге, а не отбрасываются, поэтому схема Blockstudio, зарегистрированная в
WP_Block_Type, учитывается при программной записи данных.
7.6.11 обновление: При установке артефактов графа документ маршрута теперь атомарно заменяется, если копия в хранилище изменилась, но ключ остался прежним; идентичные документы не затрагиваются. Сведения о добавленных, заменённых, пропущенных и сохранённых маршрутах выводятся через
Static_Prerender_Early_Serve::last_promotion().
7.6.10 обновление: При попадании в кэш среды выполнения теперь обнаруживаются удалённые скомпилированные ресурсы, в том числе во время задержки пакетной обработки изменений. Плоские кэши среды выполнения версий ниже 7.6 атомарно помещаются в карантин и удаляются пакетами ограниченного размера cron. Глобальные переменные встроенного UI выводятся один раз на страницу. Режим Early Serve для графа может отдавать маршруты с актуальным рендерингом, отсутствующие в карте развёрнутых маршрутов, из кэша идентичности. Tailwind теперь при желании может выводить файл кэша с хешем содержимого через
tailwind.output: "link"; по умолчанию вывод остаётся встроенным.
Кратко:
- Состав проекта:
Canvas::inventory()возвращает все зарегистрированные записи вместе с их источниками и стабильным порядком отображения. - Выбор записей: указание блоков и страниц ограничивает поиск, синхронизацию, рендеринг и компиляцию этими записями.
- Автономный рендеринг:
Blockstudio\Renderвозвращает готовый HTML для блока, композиции или целого документа. - Семейства компонентов UI:
Blockstudio\Uiобъединяет библиотеку компонентов в одно общедоступное семейство на компонент и приводит пример каждого. - Стабильные размеры изображений:
bs_media_image()рендерит ресурсы темы с реальными размерами из сгенерированногоassets/media.json. - Вспомогательные функции классов Tailwind:
bs_tw_merge()иbs_tw_variants()объединяют классы в PHP с учётом конфликтов. - Профили производительности:
performance.profileсразу включает производственные настройки по умолчанию для фронтенда; дочерние значения имеют приоритет. - Доступ к типизированным настройкам:
Settings::get_bool()и родственные функции считываютblockstudio.jsonс настоящими типами и сообщают об ошибках разбора. - Единый каталог кэша: все сгенерированные файлы хранятся в
cache.pathи индексируются по идентификатору среды выполнения. - Статический предварительный рендеринг: анонимные документы HTML можно кэшировать, инвалидировать через граф зависимостей и отдавать до запуска WordPress.
- Профили анализа:
theme,extreme-themeиwordpress-renderрасширяют возможностиblockstudio/phpstanза пределы шаблонов блоков. - Управляемый хук коммита:
blockstudio-githooks syncсоздаёт хук pre-commit и управляет им, запуская настроенный профиль. - Контракт проекта:
blockstudio-agentsсоздаётAGENTS.mdс описанием того, что создают авторы проекта, какие функции он включает и какие требования обеспечивает выбранный профиль. - Индекс документации: файл контекста для ИИ теперь содержит индекс всех документов, их назначений и принадлежащих им идентификаторов.
- Канонические теги блоков: отдельная команда заменяет сокращённые записи с префиксами и псевдонимами на
<bs:namespace-slug>; доступен пробный запуск. - Совместимость по умолчанию: перечисленные выше функции не влияют на сайт, пока их не укажут в
blockstudio.json.
Чтение и рендеринг проекта
Состав проекта
Canvas::inventory() возвращает все зарегистрированные в проекте записи одним обычным массивом, ничего не рендеря.
use Blockstudio\Canvas;
$result = Canvas::inventory();
foreach ($result['inventory']['blocks'] as $block) {
echo $block['name'] . "\n";
}
Записи сгруппированы по типу: pages, blocks, patterns, templates, parts и ui. order задаёт стабильный порядок отображения для всех типов, sources связывает каждую запись с путями к её источникам, а warnings и errors собирают проблемы в структурированные записи.
Записи блоков содержат id, name, title, source, path, provenance и готовый к рендерингу declaration. Для записей страниц стабильным идентификатором служит source, а path указывает на шаблон для рендеринга.
Выбор записей
Указание записей ограничивает объём работы сразу, поэтому фильтровать результаты позже не требуется.
$changed = Canvas::inventory([
'blocks' => ['mytheme/hero'],
'pages' => ['about'],
]);
Это возвращает один блок и одну страницу. patterns, templates, parts и ui возвращаются пустыми, а их источники не считываются, не синхронизируются, не рендерятся и не компилируются.
Правила однозначны:
- Если ключи типов не указаны, загружаются все типы.
- Значение
true,nullили"*"загружает все записи этого типа. - Строка или список выполняют точное сопоставление по ID, имени, slug, пути или пути к источнику.
- Пустая строка, пустой список или
falseне загружают записи этого типа. - Если указан хотя бы один ключ типа, типы с пропущенными ключами остаются нетронутыми.
Несуществующие идентификаторы возвращаются в deleted, а не приводят к ошибке. Конечная точка обновления REST в Canvas применяет то же правило к параметрам blocks и pages.
Canvas::documents() принимает те же параметры выбора и добавляет по одному отрендеренному документу для каждой записи. Выбранные страницы рендерятся в восстановленном контексте фронтенда, поэтому условные запросы, классы body, шорткоды, макеты, перенаправления и функции обратного вызова для подключения ресурсов видят эту страницу, а не запрос, который запустил рендеринг.
Автономный рендеринг
Blockstudio\Render возвращает отрендеренный HTML в виде строки, используя тот же конвейер, что и фронтенд.
use Blockstudio\Render;
$html = Render::composition([
'root' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
'layers' => [
['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
],
]);
В основе лежит одна структура объявления с четырьмя ключами: name, attributes, content и children. root, data, inner, innerBlocks, layers и example — это упрощённые входные параметры, которые Render::normalize() сводит к этой структуре.
Дочерние элементы рендерятся рекурсивно, а при некорректных данных выбрасывается исключение с именем проблемного блока.
Render::document() помещает результат в полноценный автономный документ HTML.
$document = Render::document('mytheme/hero', [
'title' => 'Hero preview',
]);
echo $document['html'];
body содержит только вывод блока, html — собранный документ, blocks — имена участвовавших блоков, а assets разбивает разметку на head, footer, styles, scripts, modules, interactivity, ui и tailwind. Подключаются только ресурсы, нужные для рендеринга, поэтому ресурсы только для редактора не выводятся.
Render::document_from_html() оборачивает HTML, отрендеренный в другом месте, а Render::content() рендерит сериализованное содержимое блоков без документа. Вызывайте Blockstudio\Batch_Render::reset() между документами в рамках одного процесса PHP; Canvas::documents() уже делает это.
Семейства компонентов UI
Blockstudio\Ui предоставляет библиотеку UI: одна запись на общедоступный компонент вместо списка внутренних частей.
Ui::inventory() возвращает по одной записи на семейство с корневым блоком, заголовком и необходимыми ему блоками реализации. Ui::examples() добавляет детерминированное объявление для каждого семейства: значения по умолчанию сохранены, обязательные дочерние слои вложены в родительские, а для пустых полей добавлен стабильный пример текста. Это объявление является каноническим, поэтому его можно сразу использовать в Render::document().
В Canvas используется такая же группировка. Встроенный UI отображается как один пример на семейство в типе ui, а регистрации блоков реализации не попадают в blocks.
Семейства созданы для совместного использования: список открывается внутри диалога, а его всплывающее окно располагается поверх триггера; меню и комбобоксы закрепляются по фиксированным координатам области просмотра, сохраняющими положение при прокрутке; модальные окна открываются одно поверх другого и закрываются по одному нажатию Escape за раз; в каждом нижнем колонтитуле один и тот же элемент управления закрытием сочетается с вариантом оформления. Устройство этих связей и инварианты, которые обеспечивают их работу, описаны в главе композиции; /ui/examples показывает композиции в действии.
Вспомогательные функции шаблонов
Стабильные размеры изображений
bs_media_image() рендерит ресурсы темы с реальными значениями ширины и высоты и зарезервированным соотношением сторон, поэтому изображения вне медиатеки больше не сдвигают макет.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
]);
Результат — figure.blockstudio-media со встроенным aspect-ratio вокруг img с реальными значениями width, height, loading и decoding. Размеры берутся из сгенерированного assets/media.json, созданного командой Blockstudio\Media_Metadata_Builder на этапе сборки или вручную.
src принимает путь относительно темы, абсолютный путь или полный URL, а attachmentId работает с изображениями из медиатеки. eager отключает отложенную загрузку изображений выше сгиба страницы, а sources выводит <picture>.
Если включён performance.media.lazy, настоящее URL перемещается в data-src, а его место занимает правильно размеренный заполнитель.
Вспомогательные функции классов Tailwind
bs_tw_merge() и bs_tw_variants() объединяют классы Tailwind в шаблонах PHP, используя движок Blockstudio, уже входящий в комплект.
bs_tw_merge('px-2 text-sm', 'px-4') возвращает text-sm px-4: конфликтующий px-2 удаляется, а более позднее значение имеет приоритет. Поддерживаются вложенные массивы значений классов.
bs_tw_variants() возвращает небольшую вызываемую функцию для вариантов компонента:
$button = bs_tw_variants([
'base' => 'inline-flex items-center',
'variants' => [
'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
],
'defaultVariants' => ['size' => 'sm'],
]);
echo $button(['size' => 'lg', 'class' => 'rounded']);
Результат — inline-flex items-center h-12 px-6 rounded. Поддерживаются базовые классы, варианты, варианты по умолчанию, составные варианты, а также class или className для отдельного вызова.
Конфигурация для эксплуатации
Профили производительности
performance.profile сразу включает настройки фронтенда для эксплуатации.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}
compat используется по умолчанию и ничего не меняет. speed и strict включают один и тот же набор: удаляют из head данные генератора, эмодзи, ленты, обнаружения и соседних записей; отключают обнаружение oEmbed и скрипты хоста; отключают XML-RPC, пингбэки и обнаружение удалённого редактора; удаляют универсальные ресурсы ядра для фронтенда; применяют настройки изображений по умолчанию; ограничивают частоту Heartbeat вне редакторов; запускают предварительную загрузку документов того же источника при наведении или установке фокуса; и используют загрузчик изображений из Blockstudio.
Каждое дочернее значение имеет приоритет над профилем, как и preload.links выше. Удаление ресурсов ядра для фронтенда нужно проверять в первую очередь: страницы, которые от них зависят, заметно ломаются. Runtime_Settings::current() показывает итоговый профиль.
themeDefaults охватывает две задачи, которые темы иначе решали бы вручную: titleTag и suppressDirectoryUpdates скрывают активную дочернюю и родительскую темы в результатах проверки обновлений.
Доступ к типизированным настройкам
Blockstudio\Settings считывает конфигурацию с настоящими типами, а не возвращает произвольное содержимое JSON.
use Blockstudio\Settings;
$lazy = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
$roles = Settings::get_array('users/roles');
foreach (Settings::errors() as $error) {
error_log($error);
}
О некорректном JSON сообщается через Settings::errors(), вместо того чтобы подставлять значения по умолчанию. Settings::get_raw() возвращает только значения, объявленные активным источником, поэтому можно отличить значение false от значения, которому вообще ничего не присваивали.
Settings::fingerprint() возвращает стабильный идентификатор действующих настроек, а доступ к ним перезагружается при изменении blockstudio.json.
Единый каталог кэша
Теперь все сгенерированные файлы хранятся в cache.path, который по умолчанию равен wp-content/blockstudio/cache.
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Данные сборки, сведения о регистрации блоков, ресурсы редактора, скомпилированный Tailwind CSS, документы рендеринга, фрагменты островов, статические HTML, индексы графа, очереди прогрева и диагностические данные хранятся в этом каталоге. Относительный путь отсчитывается от WP_CONTENT_DIR, а абсолютный указывает на выделенный том.
Объекты сохраняются для текущей сети и сайта, затем распределяются по идентификатору среды выполнения: это отпечаток версий Blockstudio, WordPress и PHP, действующих настроек, активной темы и плагинов, источников обнаружения и участвующих исходных файлов. При изменении входных данных для затронутых объектов создаются новые версии, а старые удаляются.
Холодные сборки выполняются по принципу single-flight: один запрос собирает и атомарно публикует результат, пока остальные ждут. Если обновить кэш не удаётся, продолжает отдаваться последний корректный объект, а ошибка остаётся доступной для наблюдения. Команда Blockstudio\Runtime_Cache::purge('tailwind') очищает одну область.
Статический предварительный рендеринг
Статический предварительный рендеринг кэширует целые анонимные документы HTML и может отдавать их до запуска WordPress. По умолчанию эта функция выключена.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}
Доступность для кэширования
Кэшировать можно только целые анонимные документы HTML. Обходятся запросы не GET, строки запроса, административная часть, REST, Ajax, cron, ленты, поиск, предварительный просмотр, запросы с nonce, персонализированные cookie и любые пути под dynamicPaths.
Ответ можно полностью исключить из кэша с помощью маркера <!-- blockstudio:no-cache -->.
При сопоставлении путей учитываются границы: поэтому /account охватывает /account/orders, но не /accounting.
Режимы подписи и графа
invalidate выбирает, как истекает срок действия записей. В режиме signature, используемом по умолчанию, при отсутствии ответа для анонимного запроса создаётся ответ с ключом идентификатора, который обновляется после изменений на уровне сайта. Этот режим подходит для обычного сайта.
Режим graph предназначен для явных инструментов сборки и развёртывания. Он записывает зависимости каждой страницы от исходных файлов, поэтому план пересобирает только затронутые URL.
use Blockstudio\Static_Prerender_Runtime;
$plan = Static_Prerender_Runtime::build_plan($sourceUrls);
foreach ($plan['affectedUrls'] as $url) {
$result = render_with_dependencies($url);
Static_Prerender_Runtime::persist_built_response(
$url,
$result['html'],
$result['files'],
$result['virtualHashes']
);
}
Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
Ранняя отдача
Если включён earlyServe, Blockstudio управляет небольшой картой маршрутов для сайта и drop-in advanced-cache.php, который перед запуском WordPress, плагинов и темы передаёт поток подходящего кэшированного ответа.
Он никогда не перезаписывает чужую карту, drop-in или объявление WP_CACHE. Перед заменой карты каждый артефакт графа проверяет все указанные файлы HTML, поэтому неудачное развёртывание с неполным рендерингом оставляет активным предыдущий граф. Записи Multisite изолируются по хосту, домашнему пути и ID сайта.
Прогрев и состояние
Для повседневной работы предусмотрены три команды WP-CLI:
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
status выводит активный идентификатор, количество файлов и байтов, записи графа, состояние очереди, а также счётчики попаданий в кэш, промахов, сборок и ошибок по каждой области.
Анализ и инструменты для агентов
Профили анализа
blockstudio/phpstan добавляет к анализу блоков ещё три уровня и команду для запуска уровня, выбранного проектом.
| Профиль | Что добавляет |
|---|---|
base |
Анализ существующих схем, шаблонов, хуков, настроек и API. |
theme |
Корневые каталоги темы, заголовки стилей, ресурсы, области действия селекторов, значения полей по умолчанию и ограничения повторителей. |
extreme-theme |
PHPStan max, небезопасный PHP, экранирование, Tailwind, JavaScript и проверки Interactivity. |
wordpress-render |
Выполняемая вызывающей стороной проверка с помощью живого рендеринга поверх extreme-theme. |
Настройки по умолчанию берутся из blockstudio.json, поэтому интерактивный запуск, CI и хуки коммита используют одну конфигурацию:
{
"phpstan": {
"preset": "theme",
"roots": ["."],
"excludePaths": ["fixtures/**"],
"maxFiles": 10000
}
}
vendor/bin/blockstudio-phpstan --root . -- --no-progress
Коды завершения: 0 при успешном выполнении, 1 при наличии замечаний и 2 при неверном использовании. Обёртка собирает конфигурацию во временном системном каталоге, поэтому в проекте не остаётся сгенерированных конфигураций, базовых снимков или кэша. Лимит памяти для PHPStan увеличивается до 1G.
В комплект также входит поставщик BC Math, поэтому для проверок JavaScript больше не нужен ext-bcmath.
Управляемый хук коммита
Одна настройка и одна команда превращают выбранный профиль в условие для коммита.
{
"githooks": {
"commit": true
}
}
vendor/bin/blockstudio-githooks sync
При синхронизации хук и запись о его принадлежности сохраняются в общем каталоге Git, а core.hooksPath направляется в управляемый каталог. При этом вызывается настроенный ранее хук pre-commit. Во время коммита хук находит корень репозитория и проекта, поэтому клонированные рабочие копии и пути с пробелами поддерживаются.
Хук запускает только vendor/bin/blockstudio-phpstan; форматирования и перезаписи файлов он не выполняет. Если задать для commit значение false и повторно выполнить синхронизацию или запустить blockstudio-githooks remove, восстановится записанный путь к хуку и будут удалены только файлы, принадлежащие Blockstudio.
Контракт проекта
blockstudio-agents создаёт AGENTS.md с указанием расположения блоков, определения страницы в этом проекте, включённых функций и того, что анализатор отклонит.
vendor/bin/blockstudio-agents
Документ формируется на основе проекта, а не шаблона. Для темы с заголовком style.css, блоками и страницами в виде файлов создаётся контракт, отличный от контракта плагина, который только регистрирует блоки; в нём указаны найденные сканером количества, каталоги, пространства имён и языки шаблонов. Функции, включаемые в контракт, определяет blockstudio.json, поэтому в проекте без статического предварительного рендеринга эта функция не упоминается.
Раздел о корректности формируется по файлам правил каждого слоя выбранного профиля. Поэтому новое правило в профиле меняет все создаваемые контракты.
Управление принадлежностью работает так же, как для хука коммита. Файл без маркера генерации не перезаписывается, если только --force не разрешает это. Раздел примечаний в конце сохраняется при повторной генерации; --check завершается с кодом 1, если контракт устарел; а --stdout выводит его, не обращаясь к файловой системе.
Индекс документации
Теперь blockstudio-llm.txt — это индекс, а не объединённый текст. Каждый опубликованный документ указан один раз в своём разделе и подразделе вместе с маршрутом, исходным файлом, кратким описанием и принадлежащими ему идентификаторами: путями настроек, именами хуков, функциями и классами PHP, а также командами.
## Docs / Dev / Inspection Tools
### Canvas
route: /docs/dev/canvas
file: docs/docs/dev/canvas.md
purpose: A visual workspace and public inventory API for Blockstudio content.
settings: dev/canvas/enabled, ui
hooks: blockstudio/settings/dev/canvas/admin_bar, blockstudio/settings/dev/canvas/enabled
php: Blockstudio\Canvas, Canvas::documents(), Canvas::inventory()
Агент читает индекс, находит единственный документ, которому принадлежит нужный ему идентификатор, и открывает этот документ. Прежняя склейка размером в полмегабайта по-прежнему генерируется и публикуется по адресу /blockstudio-llm-full.txt; теперь её не выдают всем в первую очередь.
Канонические теги блоков
Отдельная команда переписывает сокращения префиксов и псевдонимов в каноническое написание <bs:namespace-slug>, которое указывает настоящее имя блока и разрешается без загруженного фильтра проекта.
При префиксе brand для theme-components и префиксе ui для bsui это сокращение:
<brand-card>
<ui-input />
</brand-card>
означает то же, что и:
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Префиксы и точные псевдонимы по-прежнему работают и не объявлены устаревшими. Команда не загружает WordPress и ничего не записывает без --apply:
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
--root="$PWD" \
--prefix-map=/tmp/prefixes.json \
--known-blocks=/tmp/blocks.json \
--report=/tmp/tag-migration.json \
--dry-run
--prefix-map сопоставляет каждому префиксу его пространства имён, а --known-blocks перечисляет зарегистрированные имена блоков. В отчёте указаны соответствия устаревших имён каноническим с числом вхождений, хеши каждого файла, а также отдельные списки неизвестных тегов, неоднозначных псевдонимов и динамических тегов. --apply отказывается записывать изменения, пока что-либо из этого остаётся, если не передан --allow-unresolved.
Поддерживается разметка с парными и вложенными тегами, а также теги без закрытия, включая буквальные теги в строках PHP. Изменяются только имена тегов; при повторном запуске изменений нет, а примеры в комментариях, блоках кода, <pre> или <code> попадают только в отчёт.
Поведение по умолчанию
Сама по себе установка версии 7.6 ничего не меняет.
Профиль производительности по умолчанию — compat. Вывод в head, oEmbed, XML-RPC, Heartbeat, настройки изображений, предварительная загрузка ссылок, отложенная загрузка и фронтенд <title> остаются такими, какими их оставили WordPress и тема.
Остаются отключёнными, пока их не включат: все ключи performance.staticPrerender, performance.measurement, performance.media и themeDefaults, а также githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled и blockTags.enabled. Пока статический пререндеринг отключён, файлы не записываются и drop-in не устанавливается.
Canvas и Render работают пассивно. Они читают существующие реестры и отображают только то, что запрашивает вызывающий код; ни один из них не подключается к выводу фронтенда и не регистрирует маршруты. Для экрана администрирования Canvas по-прежнему нужны dev.canvas.enabled и edit_posts.
Для более строгого анализа нужно явно указать его. Установка blockstudio/phpstan включает только базовое расширение, а каноническая команда запускает base, если проект не указывает пресет.
Для создания сгенерированных файлов нужно запустить соответствующую команду. githooks.commit ничего не делает, пока не запущена blockstudio-githooks sync, а AGENTS.md — пока не выполнена blockstudio-agents.
Переход с версии 7.5
Требования не изменились: PHP 8.2 или новее, WordPress 6.7 или новее.
composer require blockstudio/blockstudio
Кеши перестраиваются один раз. Идентификатор среды выполнения включает версию Blockstudio, поэтому первый запрос после обновления выполняется без кеша, а старые объекты удаляются. Старый кеш Tailwind в wp-content/uploads/blockstudio/tailwind/cache можно удалить; вместо этого фрагмент кода, который находил его по шаблону, должен вызывать Blockstudio\Runtime_Cache::purge('tailwind').
Плоский каталог wp-content/blockstudio/cache/runtime, оставшийся от версий до 7.6, автоматически переименовывается и исключается из активного пути, а затем удаляется в ходе ограниченных проходов WP-Cron. Поэтому большие деревья устаревших файлов блокировок не нужно удалять во время запроса на развёртывание.
У сгенерированных файлов есть владельцы. assets/media.json нужно хранить в системе контроля версий или создавать на этапе сборки. Карта маршрутов, drop-in advanced-cache.php и объявление WP_CACHE существуют, только пока включён earlyServe; хук pre-commit — только пока он синхронизирован. Все остальные сгенерированные файлы находятся в cache.path, их можно безопасно удалить.
Ничего не удалено и не переименовано. bs_render_block(), bs_block(), Blockstudio\Pages и Blockstudio\Patterns остаются каноническими файловыми источниками контента.
Откат выполняется отдельно для каждой функции. Возврат performance.profile к compat, staticPrerender.enabled к false, githooks.commit к false вместе с sync, а также cache.enabled к false отменяет по одному слою.
Разумная последовательность внедрения:
- Установите
performance.profileв значениеspeed, затем проверьте вывод в head, ленты и все плагины, зависящие от oEmbed или XML-RPC. - Создайте
assets/media.json, переместите шаблоны вbs_media_image(), затем включитеperformance.media.lazy. - Включите
performance.staticPrerender, оставивearlyServeвыключенным; проверьте обращения с помощьюwp bs prerender status, затем включитеearlyServe. - Запускайте
blockstudio-phpstan --preset theme, пока проверка не завершится без ошибок, и только после этого подключайте пресет кgithooks.commit.
Где найти подробности
- Canvas и его инвентарь и документAPI
- Рендеринг, UIКомпоненты и UIКомпозиция
- Настройки и производительность
- Производительность, Кеширование и Статический пререндеринг
- Tailwind CSS
- PHPStan: пресеты, каноническая команда, управляемый хук фиксации и контракт проекта
- Интеграция с AI: индекс документации и полный текст
- Миграция и PHPХуки