性能
Blockstudio 的生产环境性能由一个配置文件开关、一组用于验证其效果的测量工具,以及两种避免页面重复执行工作的渲染技术组成。
编辑器和请求开销
编辑器渲染普通区块时不会挂载额外的隐藏字段树。 新建的重复器行会根据已注册的默认值初始化,包括嵌套的最小行数。现有值会予以保留。编辑器资源字段和自定义控件仍会进行所需的初始化。
编辑器标记检查使用浏览器的惰性片段解析器,从而缩小初始 JavaScript 包。组件属性保留书写时的 camelCase 名称,并继续支持带引号的值、JSON 属性和表格片段。
代码、类、属性和所见即所得字段编辑器会在其控件首次出现时加载,而不是随初始编辑器脚本一起加载。未选中的区块不会下载这些编辑器。编辑器库会共享复用;将所见即所得字段切换为代码模式时,才会加载代码编辑器。在网速较慢时,首次使用可能需要更长时间;这些编辑器加载前,已存储的值和字段默认值仍可用。无需进行任何配置。 提供编辑器资源的代码字段仍会初始化其样式或脚本,无需等待代码编辑器下载。
HTML 和 CSS 格式化代码也会按需加载。发起新的单区块预览请求时,会取消之前的浏览器请求,同时保留当前显示的预览。取消请求并不能保证 PHP 停止已在服务器上开始的渲染。
在服务器端,文件字段会一并预热其附件缓存;没有匹配扩展名的区块会跳过未使用的扩展转换。常用请求选项会一并预热;普通前端请求不会查找编辑器资源捕获瞬态数据。这些更改无需持久对象缓存或性能配置文件。
当文章内容包含已保存的 Blockstudio 字段值时,会在 WordPress 渲染文章中的区块之前,预热这些区块的附件缓存,包括嵌套区块、重复器和匹配的扩展。ID 会去重,并以每批最多 500 个的方式加载。单独渲染区块时,若在 the_content 之外、使用默认值或渲染区块引用,区块仍会预热自己的附件。缓存已预热时,不会再次查询附件。
如果模板不需要所有图像尺寸,可以使用 blockstudio/blocks/attributes/files/sizes 选择较短的列表。
文件字段的默认输出保持不变,WordPress 图像 URL 筛选器仍会应用于所请求的尺寸。
在同一请求中,重复读取设置时会复用其 JSON 文件检查结果,持续一秒。长时间运行的进程仍会检测文件更改,而显式 Settings::reload() 会立即读取设置。仅存储在数据库中的设置,以及配置的设置路径发生更改时,都会在下次读取时生效。
前端 useBlockProps 处理会与现有的组件清理流程共用,而不是先重写其标记。编辑器标记处理保持不变。
性能配置文件
performance.profile 可在一个位置启用生产环境前端默认值:
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}
compat 是默认配置,不会更改任何内容。speed 和 strict 会启用同一组设置:从 head 中移除 generator、emoji、feed、discovery 和相邻文章输出;移除 oEmbed discovery 和主机脚本;禁用 XML-RPC、pingbacks 和远程编辑器发现;移除通用的 core 前端资源;应用图像输出默认值;在编辑器之外降低 Heartbeat 频率;在用户意图悬停或聚焦时预获取同源文档;并使用 Blockstudio 的图像加载器。
每个子项值都会覆盖配置文件设置,如上面的 preload.links 所示。移除核心前端资源是应首先测试的操作,因为依赖这些资源的页面会明显出错。Runtime_Settings::current() 会显示解析后的配置文件;完整选项表见设置参考。
可通过程序获取测量数据:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
启用 measurement.headers 后,Blockstudio 会发送 X-Blockstudio-Performance-Profile、X-Blockstudio-Performance-Config,并可选择发送 X-Blockstudio-Performance-Time。blockstudio/performance/measurement_enabled 操作会接收解析后的运行时设置。
分析器
Blockstudio 内置了轻量级分析器,可跟踪整个流水线中的渲染性能。它会显示每个区块的耗时、各阶段明细和缓存命中率。
启用
将 ?blockstudio-perf 添加到任意前端 URL:
https://example.com/my-page/?blockstudio-perf
也可以在 blockstudio.json 中永久启用:
{
"dev": {
"perf": true
}
}
也可以通过筛选器启用:
add_filter('blockstudio/settings/dev/perf', '__return_true');
分析器仅向具有 edit_posts 权限的已登录用户输出数据。对于不会收到输出的请求,分析器会在 init 关闭,因此查询参数或设置不会给这些请求带来任何测量开销。
输出
调试面板
页面底部会显示一个固定面板,其中的表格会列出每项跟踪指标、耗时和调用次数。
Server-Timing 标头
计时数据也会作为 Server-Timing HTTP 标头发送,并可在浏览器开发者工具的 Network 选项卡的“Timing”部分查看。即使页面 HTML 由 CDN 缓存,此功能也照常工作。
跟踪的指标
| 指标 | 说明 |
|---|---|
total |
Blockstudio 总处理时间 |
block-tags |
区块标签解析器(替换 <bs:> 和 <block>) |
assets |
资源发现与注入 |
tailwind |
Tailwind CSS 编译 |
phase:transform |
属性转换(每次区块渲染) |
phase:template |
PHP/Twig 模板编译(每次区块渲染) |
phase:twig |
Twig 专用编译(每次区块渲染) |
phase:components |
组件替换:InnerBlocks、RichText、useBlockProps(每次区块渲染) |
block:{name} |
单个区块类型的渲染时间及调用次数 |
进程内批量渲染
长期运行的导出器和静态站点构建器可以在同一个 PHP 进程中渲染多个 WordPress 文档,而无需重新构建 Blockstudio 注册信息。每个文档之间请重置请求级计数器、资源、岛屿状态、页面布局状态,以及 Tailwind 的单文档生成状态:
foreach ($routes as $route) {
Blockstudio\Batch_Render::reset();
$html = render_route($route);
write_static_page($route, $html);
}
Batch_Render::reset() 会保留热状态的发现数据和已注册区块数据。它不会清除缓存。
要收集每个已渲染区块的源依赖项,请监听 blockstudio/render/dependencies:
$dependencies = [];
add_filter(
'blockstudio/render/dependencies',
function (
array $paths,
string $name,
array $block,
bool $is_editor,
bool $is_preview
) use (&$dependencies): array {
$dependencies[$name] = array_values(array_unique([
...($dependencies[$name] ?? []),
...$paths,
]));
return $paths;
},
10,
5
);
报告的路径包括所选渲染模板、发现的模板文件以及已注册的区块资源文件。收集器可以将单独加载的文件添加到自己的依赖图中。筛选器添加的路径也会由静态预渲染图构建记录,因此,读取数据文件的区块可以在此列出该文件;文件发生变化时,其路由会重新渲染。
渲染缓存
页面渲染期间,无内部内容的自闭合区块标签会缓存在内存中。同一区块以相同属性多次出现时,后续渲染会直接使用缓存。缓存按请求隔离,并在页面渲染完成后清除。
缓存启用后,性能分析器会显示渲染调用次数减少,便于确认缓存是否生效。
将匿名页面作为静态HTML提供,可选择在WordPress启动前提供。
每个请求背后的持久化文件缓存。