Перейти к содержимому

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() возвращает все зарегистрированные в проекте записи одним обычным массивом, ничего не рендеря.

PHP
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 указывает на шаблон для рендеринга.

Выбор записей

Указание записей ограничивает объём работы сразу, поэтому фильтровать результаты позже не требуется.

PHP
$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 в виде строки, используя тот же конвейер, что и фронтенд.

PHP
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.

PHP
$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
<?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() возвращает небольшую вызываемую функцию для вариантов компонента:

PHP
$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 сразу включает настройки фронтенда для эксплуатации.

JSON
{
  "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.

PHP
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.

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

Данные сборки, сведения о регистрации блоков, ресурсы редактора, скомпилированный Tailwind CSS, документы рендеринга, фрагменты островов, статические HTML, индексы графа, очереди прогрева и диагностические данные хранятся в этом каталоге. Относительный путь отсчитывается от WP_CONTENT_DIR, а абсолютный указывает на выделенный том.

Объекты сохраняются для текущей сети и сайта, затем распределяются по идентификатору среды выполнения: это отпечаток версий Blockstudio, WordPress и PHP, действующих настроек, активной темы и плагинов, источников обнаружения и участвующих исходных файлов. При изменении входных данных для затронутых объектов создаются новые версии, а старые удаляются.

Холодные сборки выполняются по принципу single-flight: один запрос собирает и атомарно публикует результат, пока остальные ждут. Если обновить кэш не удаётся, продолжает отдаваться последний корректный объект, а ошибка остаётся доступной для наблюдения. Команда Blockstudio\Runtime_Cache::purge('tailwind') очищает одну область.

Статический предварительный рендеринг

Статический предварительный рендеринг кэширует целые анонимные документы HTML и может отдавать их до запуска WordPress. По умолчанию эта функция выключена.

JSON
{
  "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.

PHP
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 и хуки коммита используют одну конфигурацию:

JSON
{
  "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.

Управляемый хук коммита

Одна настройка и одна команда превращают выбранный профиль в условие для коммита.

JSON
{
  "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, а также командами.

Text
## 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 это сокращение:

HTML
<brand-card>
  <ui-input />
</brand-card>

означает то же, что и:

HTML
<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 отменяет по одному слою.

Разумная последовательность внедрения:

  1. Установите performance.profile в значение speed, затем проверьте вывод в head, ленты и все плагины, зависящие от oEmbed или XML-RPC.
  2. Создайте assets/media.json, переместите шаблоны в bs_media_image(), затем включите performance.media.lazy.
  3. Включите performance.staticPrerender, оставив earlyServe выключенным; проверьте обращения с помощью wp bs prerender status, затем включите earlyServe.
  4. Запускайте blockstudio-phpstan --preset theme, пока проверка не завершится без ошибок, и только после этого подключайте пресет к githooks.commit.

Где найти подробности