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-meta заявка за многоезични страници. Краткотрайната опцияthemeDefaults.syncPagesInDevelopmentе премахната, защото синхронизирането на страниците вече не се изпълнява от куки за заявките.Pages::init()вече се използва само при зареждане; интеграциите, които са подавалиforce, трябва да използватPages::reconcile()или CLI. Отварянето на Canvas все още извършва едно изрично съгласуване с удостоверяване за опис на съдържанието за авторите.
7.6.12 актуализация: Стиловите таблици на редактора вече се префиксират с едно преминаване за пренаписване вместо с компилация на SASS за всеки ресурс, така че студено изграждане на редактора на сайт с много блокове вече не рискува да изчерпи умерено ограничение на паметта. Кеширана предварително рендерирана страница, чиято хеширана по съдържание Tailwind таблица със стилове е премахната, се рендерира отново, вместо да се показва без стилове, както през кеша PHP, така и чрез добавката 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отвъд шаблоните на блоковете. - Управляван hook за commit:
blockstudio-githooks syncзаписва и управлява hook за 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, име, кратко име, път или път до източника.
- Празен низ, празен списък или
falseне зарежда нищо от този тип. - Щом присъства ключ за който и да е тип, пропуснатите типове остават недокоснати.
Идентификаторите, които вече не съществуват, се връщат под deleted, вместо да се получи грешка,
а крайната точка за опресняване на Canvas REST прилага същото правило към параметрите си blocks и
pages.
Canvas::documents() използва същия избор и добавя по един рендериран документ за
всеки запис. Избраните страници се рендерират във възстановен контекст на фронтенда, така че условните проверки на заявката, класовете на тялото, кратките кодове, оформленията, пренасочванията и обратните извиквания за зареждане виждат тази страница, а не заявката, която я е поискала.
Самостоятелно рендериране
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 включват
един и същ набор: премахват от главната част извеждането на генератор, емоджита, емисии, откриване и съседни публикации; премахват откриването на oEmbed и скриптовете на хоста; изключват XML–RPC, pingback съобщенията
и отдалеченото откриване на редактора; премахват общите ресурси на ядрото за фронтенда;
прилагат стандартни настройки за извеждане на изображения; ограничават 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, ефективните настройки, активната тема и плъгини, източниците за откриване и участващите изходни файлове. При промяна на входните данни се създават нови засегнати обекти, а старите се премахват.
Студените изграждания се изпълняват само веднъж: една заявка изгражда и публикува резултата атомарно, докато останалите чакат. При неуспешно опресняване последният валиден обект продължава да се обслужва, като грешката остава видима, а
Blockstudio\Runtime_Cache::purge('tailwind') изчиства един обхват.
Статично предварително рендериране
Статичното предварително рендериране кешира пълни анонимни документи HTML и може да ги обслужва преди стартирането на WordPress. По подразбиране е изключено.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}
Допустимост
Допустими са само пълни анонимни документи HTML. Заявки, които не са GET, низове на
заявки, администрацията, REST, Ajax, cron, емисии, търсене, предварителни прегледи, заявки с nonce,
бисквитки за персонализация и всички пътища под 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 управлява малка карта на маршрутите за всеки сайт и
добавка advanced-cache.php, която изпраща поток при попадение в кеша, преди да се стартират WordPress,
плъгините или темата.
То никога не презаписва чужда карта, добавка или декларация WP_CACHE. Графов
артефакт проверява всеки посочен файл HTML, преди да се смени картата, така че
частично рендерирано внедряване оставя предишния граф активен. Записите за мрежи от сайтове остават изолирани по хост, началния път и ID на сайта.
Затопляне и състояние
Три команди WP-CLI покриват ежедневната употреба:
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
status отчита активната идентичност, броя на файловете и байтовете, записите в графа, състоянието на опашката и броячите за попадения, пропуски, изграждания и неуспешни операции за всеки обхват.
Инструменти за анализ и агенти
Предварителни настройки за анализ
blockstudio/phpstan получава три слоя над анализа на блоковете си, както и една
команда, която изпълнява избрания от проекта слой.
| Предварителна настройка | Какво добавя |
|---|---|
base |
Съществуващият анализ на схемата, шаблоните, hook-овете, настройките и API. |
theme |
Коренови директории на темите, заглавки на стилове, ресурси, ограничаване на обхвата на селекторите, стойности на полетата по подразбиране, граници на повторителите. |
extreme-theme |
PHPStan max, опасни PHP, екраниране, Tailwind, JavaScript и проверки на Interactivity. |
wordpress-render |
Проверка чрез рендериране на живо, предоставена от извикващия, над extreme-theme. |
Стойностите по подразбиране идват от blockstudio.json, така че интерактивните изпълнения, CI и hook-овете за commit
споделят една конфигурация:
{
"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.
Управляван hook за commit
Една настройка и една команда превръщат конфигурираната предварителна настройка във входен контрол при commit.
{
"githooks": {
"commit": true
}
}
vendor/bin/blockstudio-githooks sync
Синхронизирането записва hook-а и запис за собственост в общата директория на Git,
насочва core.hooksPath към управляваната директория и свързва предходно конфигурирания hook за pre-commit. Hook-ът определя хранилището и основната директория на проекта при извършване на commit, така че свързаните работни копия и пътищата с интервали работят.
Hook-ът изпълнява vendor/bin/blockstudio-phpstan и нищо друго; никога
не форматира и не пренаписва файлове. Ако зададете commit на false и синхронизирате отново или
изпълните blockstudio-githooks remove, пътят до записания hook се възстановява и се изтриват само файловете, притежавани от Blockstudio.
Договор на проекта
blockstudio-agents записва AGENTS.md, който указва къде се намират блоковете, какво представлява
страницата в този проект, кои функции са включени и какво ще отхвърли анализаторът.
vendor/bin/blockstudio-agents
Документът се генерира според проекта, а не от шаблон. Договорът за тема със заглавка style.css,
блокове и страници във файлове се различава от договора за плъгин, който регистрира само блокове, и включва броя, директориите, пространствата от имена и езиците за шаблони, открити от скенера. blockstudio.json определя кои функции се показват,
така че проект без статично предварително рендериране изобщо няма да го спомене.
Разделът за коректността се прочита слой по слой от собствените файлове с правила на избраната предварителна настройка. Затова добавянето на правило към предварителна настройка променя всеки генериран от нея договор.
Управлението на собствеността работи като при hook-а за commit. Ако във файла няма генериран маркер, той се отхвърля, вместо да бъде заменен, освен ако --force не указва друго; областта за бележки в края се запазва при регенериране; --check излиза с код 1, когато договорът е остарял; а --stdout го извежда, без да докосва файловата система.
Индекс на документацията
blockstudio-llm.txt вече е индекс, а не конкатенация. Всеки
публикуван документ се появява веднъж в своя раздел и подраздел, заедно с маршрута,
изходния файл, едноредово описание на предназначението и идентификаторите, за които отговаря: пътища към настройки,
имена на hook-ове, функции и класове 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. Докато статичното предварително рендиране е изключено, не се записват файлове и не се инсталира допълнителен компонент.
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 може да бъде изтрит; фрагмент код, който го търси с glob, трябва вместо това да извика Blockstudio\Runtime_Cache::purge('tailwind').
Старата плоска директория wp-content/blockstudio/cache/runtime отпреди 7.6 автоматично се преименува и извежда от активния път, а след това се премахва на ограничени порции с WP-Cron. Така не се налага големите наследени дървета от заключващи файлове да бъдат изтривани по време на заявка за внедряване.
Генерираните файлове имат собствени места. assets/media.json трябва да бъде под контрола на версиите или част от стъпка по изграждането. Картата на маршрутите, допълнителният компонент advanced-cache.php и декларацията WP_CACHE съществуват само когато earlyServe е активирано, а куката за предварително потвърждаване — само докато е синхронизирана. Всички останали генерирани файлове се намират под 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