Vai al contenuto

Prestazioni

Le prestazioni in produzione in Blockstudio si basano su un singolo profilo, una serie di strumenti di misurazione per verificarne gli effetti e due tecniche di rendering che evitano di ripetere operazioni nella pagina.

Sovraccarico dell’editor e delle richieste

L’editor visualizza i blocchi ordinari senza montare un albero di campi nascosto aggiuntivo. Le nuove righe dei repeater vengono inizializzate con i valori predefiniti registrati, incluse le righe minime annidate. I valori esistenti vengono mantenuti. I campi degli asset dell’editor e i controlli personalizzati conservano l’inizializzazione necessaria.

L’ispezione del markup dell’editor usa il parser di frammenti inerte del browser, riducendo il bundle iniziale JavaScript. Le proprietà dei componenti mantengono i nomi camelCase scritti nel codice; sono supportati anche i valori tra virgolette, le proprietà JSON e i frammenti di tabella.

Il codice, le classi, gli attributi e gli editor dei campi WYSIWYG vengono caricati quando i relativi controlli compaiono per la prima volta, anziché insieme allo script iniziale dell’editor. I blocchi non selezionati non scaricano questi editor. Le librerie condivise dell’editor vengono riutilizzate e, passando un campo WYSIWYG alla modalità codice, l’editor di codice viene caricato solo in quel momento. La prima apertura potrebbe richiedere più tempo con una connessione lenta; i valori salvati e quelli predefiniti dei campi sono disponibili prima che questi editor vengano caricati. Non è necessaria alcuna configurazione. I campi di codice che forniscono asset dell’editor inizializzano comunque i propri stili o script senza attendere il download dell’editor di codice.

Anche la formattazione di HTML e CSS viene caricata su richiesta. Una nuova richiesta di anteprima di un singolo blocco annulla la richiesta precedente del browser, mantenendo visibile l’anteprima mostrata. L’annullamento non garantisce che PHP interrompa un rendering già avviato sul server.

Sul server, i campi file inizializzano insieme le proprie cache degli allegati e i blocchi senza estensioni corrispondenti saltano le trasformazioni delle estensioni non utilizzate. Le opzioni comuni delle richieste vengono inizializzate insieme; le normali richieste frontend non cercano il transient di acquisizione degli asset dell’editor. Queste modifiche non richiedono una cache persistente degli oggetti né un profilo delle prestazioni.

Quando il contenuto del post contiene valori salvati dei campi Blockstudio, le cache degli allegati vengono inizializzate per tutti i suoi blocchi prima che WordPress li visualizzi, inclusi i blocchi annidati, i repeater e le estensioni corrispondenti. Gli ID vengono deduplicati e caricati in gruppi di massimo 500. I singoli blocchi continuano a inizializzare i propri allegati quando vengono visualizzati al di fuori di the_content, quando usano i valori predefiniti o quando vengono visualizzati riferimenti a blocchi. Le cache già inizializzate non generano un’altra query degli allegati.

I template che non necessitano di tutte le dimensioni delle immagini possono scegliere un elenco più breve con blockstudio/blocks/attributes/files/sizes. L’output predefinito del campo file resta invariato e i filtri WordPress delle immagini URL continuano ad applicarsi alle dimensioni richieste.

Le letture ripetute delle impostazioni riutilizzano per un secondo, all’interno della stessa richiesta, il controllo del file JSON. I processi di lunga durata continuano a rilevare le modifiche ai file, mentre le letture esplicite di Settings::reload() le rilevano immediatamente. Le impostazioni basate solo sul database e le modifiche al percorso delle impostazioni configurato diventano effettive alla lettura successiva.

La gestione frontend di useBlockProps condivide il passaggio esistente di pulizia dei componenti, anziché riscriverne prima il marker. La gestione dei marker nell’editor resta invariata.

Profili delle prestazioni

performance.profile attiva in un unico punto le impostazioni frontend predefinite per la produzione:

JSON
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

compat è l’impostazione predefinita e non modifica nulla. speed e strict attivano lo stesso insieme di impostazioni: rimuovono dall’head i generatori, le emoji, il feed, l’individuazione e l’output degli articoli correlati; eliminano l’individuazione oEmbed e gli script host; disattivano XML-RPC, i pingback e l’individuazione remota dell’editor; rimuovono le risorse frontend generiche di core; applicano le impostazioni predefinite per l’output delle immagini; limitano Heartbeat al di fuori degli editor; eseguono il prefetch dei documenti della stessa origine al passaggio del puntatore o quando si prevede che un elemento riceva il focus; e usano il caricatore di immagini di Blockstudio.

Ogni valore secondario sovrascrive il profilo, come preload.links qui sopra. La prima cosa da verificare è la rimozione delle risorse frontend di base, perché una pagina che ne dipende si rompe in modo evidente. Runtime_Settings::current() espone il profilo risolto; la tabella completa delle opzioni si trova nel riferimento delle impostazioni.

Le misurazioni sono disponibili a livello programmatico:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Quando measurement.headers è abilitato, Blockstudio invia X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config e, facoltativamente, X-Blockstudio-Performance-Time. L’azione blockstudio/performance/measurement_enabled riceve le impostazioni runtime risolte.

Profiler

Blockstudio include un profiler leggero che monitora le prestazioni del rendering nell’intera pipeline. Mostra i tempi per blocco, la suddivisione per fasi e i tassi di cache hit.

Attivazione

Aggiungete ?blockstudio-perf a qualsiasi frontend URL:

Codice
https://example.com/my-page/?blockstudio-perf

Oppure abilitatelo in modo permanente in blockstudio.json:

JSON
{
  "dev": {
    "perf": true
  }
}

Oppure tramite un filtro:

PHP
add_filter('blockstudio/settings/dev/perf', '__return_true');

Il profiler produce dati solo per gli utenti che hanno effettuato l’accesso e dispongono della capability edit_posts. Per le richieste che non riceveranno i dati, il profiler viene disattivato su init, così il parametro di query o l’impostazione non aggiungono alcun lavoro di misurazione.

Output

Pannello di debug

Nella parte inferiore della pagina appare un pannello fisso con una tabella che mostra ogni metrica monitorata, la relativa durata e il numero di chiamate.

Header Server-Timing

I dati temporali vengono inviati anche negli header HTTP Server-Timing, visibili nella scheda Rete degli Strumenti per sviluppatori del browser, nella sezione “Timing”. Funziona anche se la pagina HTML è memorizzata nella cache da un CDN.

Metriche monitorate

Metrica Descrizione
total Tempo totale di elaborazione di Blockstudio
block-tags Analizzatore dei tag di blocco (sostituzione di <bs:> e <block>)
assets Individuazione e inserimento delle risorse
tailwind Compilazione di Tailwind CSS
phase:transform Trasformazione degli attributi (per rendering del blocco)
phase:template Compilazione dei template PHP/Twig (per rendering del blocco)
phase:twig Compilazione specifica di Twig (per rendering del blocco)
phase:components Sostituzione dei componenti: InnerBlocks, RichText, useBlockProps (per rendering del blocco)
block:{name} Tempo di rendering per tipo di blocco, con numero di chiamate

Rendering in batch nel processo

Gli esportatori di lunga durata e i generatori di siti statici possono eseguire il rendering di diversi documenti WordPress in un unico processo PHP senza ricreare le registrazioni Blockstudio. Reimpostate i contatori per richiesta, le risorse, lo stato delle isole, lo stato del layout della pagina e la generazione per documento di Tailwind tra un documento e l’altro:

PHP
foreach ($routes as $route) {
    Blockstudio\Batch_Render::reset();
    $html = render_route($route);

    write_static_page($route, $html);
}

Batch_Render::reset() mantiene caldi i dati di individuazione e dei blocchi registrati. Non svuota la cache.

Per raccogliere le dipendenze delle fonti di ogni blocco renderizzato, osservate blockstudio/render/dependencies:

PHP
$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
);

I percorsi segnalati includono il template di rendering selezionato, i file template individuati e i file degli asset dei blocchi registrati. Un collector può aggiungere i file caricati separatamente al proprio grafo delle dipendenze. Anche i percorsi aggiunti da un filtro vengono registrati dalle compilazioni del grafo di prerendering statico, così un blocco che legge un file di dati può elencarlo qui e le relative route vengono renderizzate di nuovo quando il file cambia.

Cache di rendering

I tag dei blocchi autochiudenti (senza contenuto interno) vengono memorizzati in cache durante il rendering della pagina. Quando lo stesso blocco con attributi identici compare più volte, i rendering successivi vengono serviti dalla cache. La cache vale per la singola richiesta e viene svuotata al termine del rendering della pagina.

Il profiler mostra un numero inferiore di chiamate di rendering quando la cache è attiva, rendendo facile verificare che funzioni.

Prerendering statico

Servite pagine anonime come contenuto statico HTML, facoltativamente prima dell’avvio di WordPress.

Caching

Le cache persistenti basate su file dietro ogni richiesta.