...

Misurare il tempo di esecuzione di PHP separatamente dalla rete e dal frontend

Per distinguere il tempo di esecuzione di PHP dalla rete e dal front-end, devi innanzitutto misurare un intervallo di codice chiaramente definito con hrtime() e lo confronti con i valori del browser e del server relativi alla stessa richiesta. Un singolo dato relativo al tempo non costituisce un resoconto completo delle ore lavorate: Il timer PHP include anche i tempi di attesa all'interno del proprio intervallo, mentre i timing del browser hanno limiti diversi. Il server timing può trasmettere valori aggiuntivi, ma non li misura direttamente. Nel confronto devi tenere conto dello stato della cache, delle risposte provvisorie e delle misurazioni annidate.

Cosa rivelano effettivamente i valori attuali

Una pagina che si carica lentamente può subire ritardi in diversi punti: durante l’attesa di una risposta, in PHP, durante le query al database o successivamente durante l’elaborazione nel browser. Un unico valore per il Tempo di esecuzione di PHP non è in grado di distinguere queste cause. Ciò che conta è quale parte di una richiesta specifica venga effettivamente rilevata da un valore di misurazione.

Un timer PHP misura il tempo trascorso tra due chiamate nel codice dell'applicazione. Se nel frattempo viene effettuata una chiamata al database o a un'API, viene conteggiato anche il tempo di attesa di tale operazione. Il risultato non rappresenta quindi il tempo di CPU puro e non fornisce alcuna informazione sul codice eseguito prima dell'avvio o dopo la fine del timer.

Il browser, invece, osserva gli eventi dal proprio punto di vista: ad esempio l’inizio di una richiesta e l’arrivo di una risposta. Nel caso di una richiesta di documento dinamico, tra questi eventi possono intercorrere percorsi di rete, elaborazione tramite proxy e operazioni lato server. Quali elementi siano inclusi dipende dai rispettivi eventi e dal percorso effettivo della risposta.

L'intestazione HTTP Tempistica del server trasmette inoltre valori specificati, determinati ad esempio dall'applicazione stessa. Non misura automaticamente l'intero percorso del server. Inoltre, un valore relativo a una chiamata al database può rientrare nell'intervallo dell'applicazione; in tal caso, i due valori non possono essere sommati per ottenere una durata complessiva.

Confronta le prospettive relative alla stessa richiesta, invece di considerarle come un resoconto temporale completo. Un intervallo di esecuzione prolungato costituisce un punto di partenza per la ricerca nel backend. Un intervallo breve in presenza di una visualizzazione lenta nel browser indica invece, in un primo momento, solo che la causa potrebbe risiedere al di fuori di quella sezione di codice espressamente misurata.

Definire la richiesta e le condizioni di misurazione

Scegli innanzitutto un percorso specifico e la relativa richiesta di documento, ad esempio la pagina dinamica di un prodotto in un negozio online. Specifica se stai analizzando uno stato con accesso o in modalità anonima e quali dati di test vengono utilizzati. Carrelli, autorizzazioni o contenuti diversi potrebbero altrimenti far sì che l'applicazione non funzioni allo stesso modo.

Definisci quindi la Limiti di misura: Nel codice PHP, dove inizia il timer, dove finisce e quali chiamate al database o all’API si trovano nel mezzo? Annota anche se la misurazione inizia solo dopo l’avvio del framework. Solo con queste informazioni sarà possibile valutare in seguito cosa significhi effettivamente un valore breve o lungo.

Distinguere tra hit e miss della cache. Se una cache a monte fornisce la risposta senza PHP, potrebbe mancare un valore dell’applicazione; ciò non costituisce una prova che il tempo di elaborazione di PHP sia pari a zero millisecondi. Anche i reindirizzamenti dovrebbero essere registrati come richieste separate, anziché confrontare i loro tempi in modo inavvertito con quelli del documento finale.

Ripeti il test in condizioni il più possibile simili: stesso browser, connessione simile, stesse condizioni d’uso e stato della cache documentato. Un singolo ciclo di test potrebbe risultare anomalo a causa di ritardi temporanei o di un percorso di risposta diverso. Registra quindi diversi valori e le relative condizioni, invece di selezionare solo il valore più veloce.

Immagine simbolica generata dall'intelligenza artificiale raffigurante due schede vuote separate e un taccuino su una scrivania
Immagine simbolica generata dall'IA: le condizioni documentate separatamente facilitano il confronto tra più richieste.

Per l'esercizio pratico ti serviranno gli strumenti di sviluppo del browser e, per un timer PHP, l'accesso al codice dell'applicazione. Utilizza un ambiente di test o un percorso autorizzato a tale scopo; le modifiche in produzione e i test di carico richiedono un'apposita autorizzazione. I log del server web o un profiler possono integrare l'analisi, ma non sono un requisito indispensabile per ogni primo confronto.

Assegna il valore del browser e la misurazione lato server alla stessa richiesta, ad esempio tramite un identificativo trattato nel rispetto della normativa sulla protezione dei dati. A tal fine, non raccogliere dati personali non necessari e limitare l'accesso alle informazioni diagnostiche. Senza questa associazione, anche semplici richieste parallele o un cambio di cache nel frattempo possono falsare il confronto.

Comprendere correttamente il "browser timing"

Apri la sezione “Rete” negli strumenti di sviluppo e seleziona innanzitutto la richiesta del documento relativa alla navigazione in esame. I valori temporali di questa richiesta non descrivono automaticamente anche immagini, fogli di stile o successive chiamate API. Per tali singole risorse, Resource Timing fornisce una prospettiva specifica per ciascuna di esse; pertanto, la loro elaborazione nel browser non è completamente spiegata.

Il momento requestStart indica l'inizio della richiesta dal punto di vista del browser. responseStart indica l'inizio di una risposta ricevuta, mentre responseEnd che segna la fine della ricezione della risposta. Le differenze descrivono gli intervalli osservati; in particolare, il tempo che intercorre fino all'inizio della risposta non è da equiparare a un intervallo di codice PHP.

All'indirizzo risposte provvisorie è necessaria particolare cautela: una risposta come “103 Early Hints” può già, nel caso di responseStart devono essere presi in considerazione. Laddove il browser finalResponseHeadersStart se supportato, questo momento aiuta a individuare l’inizio della risposta finale. La differenza rispetto a requestStart non può quindi essere definito in modo generico come il tempo di attesa fino all'intestazione HTML definitiva.

La cache, i service worker, i reindirizzamenti e una connessione riutilizzata influenzano il percorso seguito da una richiesta e il modo in cui vanno interpretati i relativi tempi. Nel caso di risorse provenienti da altre origini, alcuni dati potrebbero mancare o essere pari a zero in assenza di un’autorizzazione adeguata. Verifica queste condizioni prima di confrontare i valori di due browser.

Se il tempo di attesa del browser è elevato, ma l’intervallo PHP misurato è breve, ciò non implica necessariamente un problema di rete. Il tempo può trascorrere anche in un proxy o in una coda prima del punto di misurazione PHP. Il confronto va effettuato con particolare cautela quando l’elaborazione PHP avviene solo dopo una risposta preliminare: in tal caso, i due intervalli hanno limiti diversi.

Misurare il codice PHP con hrtime

Con hrtime(true) misura il tempo trascorso tra due punti scelti dall'utente nel codice PHP. La funzione utilizza una base temporale monotona: Per tutta la durata, calcoli la differenza tra due chiamate, invece di interpretare un istante come ora. L'intervallo misurato può includere anche tempi di attesa e non rappresenta quindi un tempo di CPU puro.

Per l'esempio seguente, crea un file di test isolato in un ambiente condiviso con PHP 7.3 o versioni successive. Accedici tramite il server web, in modo da poter poi controllare l'header di risposta negli strumenti di sviluppo del browser. Il segnaposto rappresenta la parte dell'applicazione di cui definisci intenzionalmente l'inizio e la fine.

Codice
<?php
$start = hrtime(true);

// Hier den zu untersuchenden Anwendungsteil ausführen.
$result = 'Testantwort';

$end = hrtime(true);

if ($start !== false && $end !== false) {
    $durationMs = ($end - $start) / 1000000;
    header('Server-Timing: app;dur=' . sprintf('%.3F', $durationMs), false);
}

echo $result;

La funzione restituisce il valore numerico in nanosecondi; dividendo per un milione si ottiene la durata in millisecondi. Sui sistemi a 32 bit, il valore restituito può essere un numero in virgola mobile. Il controllo degli errori impedisce che, in caso di valore restituito pari a false viene restituita una durata non valida. L'unità "nanosecondi", di per sé, non garantisce una precisione di misurazione adeguata.

Nell'esempio, l'intervallo termina prima dell'impostazione dell'header e prima dell'output. Pertanto, non include né queste fasi né il lavoro svolto prima del primo o dopo il secondo timestamp. Se imposti l'inizio solo dopo l'avvio del framework, nel risultato mancherà anche la sua precedente inizializzazione.

Se sostituisci il segnaposto con una chiamata al database o all’API, il tempo di attesa di quest’ultima viene conteggiato nell’intervallo. Un valore elevato indica quindi, in un primo momento, che la sezione racchiusa ha richiesto molto tempo; non distingue ancora tra il calcolo PHP e l'attesa di altri servizi. Per effettuare questa distinzione sono necessari ulteriori punti di misurazione, più ravvicinati tra loro.

Trasmissione dei valori misurati tramite Server Timing

L'intestazione Server-Timing invia le metriche specificate al client. Non misura direttamente la durata: l’applicazione o un componente server coinvolto deve prima calcolarne il valore. Per dur La specifica raccomanda l'uso dei millisecondi; il nome descrive la metrica, ma non ne definisce automaticamente i limiti di misurazione.

Nell'esempio PHP, l'intestazione deve essere impostata prima che venga effettivamente inviato l'output. Il secondo parametro false all'indirizzo header() aggiunge un ulteriore campo di intestazione, anziché sostituire un campo esistente con lo stesso nome. In un framework, un middleware di risposta rappresenta spesso un punto di integrazione adeguato, a condizione che la misurazione sia già stata completata in quella fase e che le intestazioni non siano ancora state inviate.

Il seguente header di risposta HTTP mostra due valori fittizi; non si tratta di una misurazione. Supponendo che l'intervallo del database ricada interamente all'interno dell'intervallo dell'applicazione, i valori sono annidato. I 75 millisecondi relativi al database sono già inclusi nei 120 millisecondi relativi all'applicazione e non devono essere sommati.

Illustrazione generata dall'intelligenza artificiale di un intervallo parziale che ricade interamente all'interno di un intervallo di tempo più ampio
Illustrazione generata dall'IA: un intervallo contenuto nel database non viene aggiunto alla durata dell'applicazione.
Codice
Server-Timing: app;dur=120.000, db;dur=75.000

In base a questa ipotesi, la differenza di 45 millisecondi descrive semplicemente il tempo rimanente all’interno di app. Non si tratta automaticamente del tempo di CPU di PHP: anche in questo caso potrebbero essere inclusi altri tempi di attesa. Per questo motivo, per ogni metrica, documenta dove inizia e dove finisce e se include altri intervalli.

Fornisci solo valori selezionati con attenzione e sufficientemente approssimativi. I nomi delle metriche e le descrizioni possono rivelare dettagli sull’infrastruttura; i dati personali non devono essere inclusi nell’intestazione. L’accesso ai dati di temporizzazione da più origini tramite JavaScript è limitato e può essere gestito con Timing-Allow-Origin devono essere controllati. Ti consigliamo di verificare in modo mirato tale autorizzazione per le origini necessarie.

Confronto tra gli intervalli di misurazione

I valori riportati nella tabella rispondono a domande diverse. Se possibile, confrontali per la stessa richiesta e annota i rispettivi limiti: un intervallo visibile nel browser non inizia e non termina automaticamente negli stessi punti di un timer PHP o di un valore di log di NGINX. È inoltre particolarmente importante la Unità: I millisecondi e i secondi non devono essere valutati uno accanto all'altro senza essere verificati.

Parametri di misura e relativi limiti
Variabile misurataInizio e fineUnitàTempi di attesa e limitazioni
Intervallo di codice PHPTra due chiamate alla funzione `hrtime` definite dall'utenteNanosecondi come valore numerico; spesso convertiti in millisecondiInclude i tempi di attesa all'interno della sezione; non include il tempo di CPU puro né la richiesta completa.
Metrica di temporizzazione del serverDeterminato dalla componente di misurazionePer te si consigliano i millisecondiTrasmette un valore rilevato; i tempi di attesa inclusi dipendono dai limiti definiti.
Intervallo tra le richieste del browserda requestStart a responseStartMillisecondiComprende il tempo di attesa rilevato dal browser; responseStart può registrare una risposta provvisoria.
Intervallo di risposta del browserda responseStart a responseEndMillisecondiDescrive l'intervallo di risposta osservato; non va equiparato all'esecuzione pura di PHP.
Tempo di risposta di NGINXPrima lettura dei byte del client fino alla scrittura nel log dopo l'invio degli ultimi byteSecondiComprende la richiesta dal punto di vista di NGINX, compresi i tempi di attesa; i limiti differiscono da quelli del timer PHP.

Verifica il formato effettivo del log prima di interpretare un valore come durata complessiva del backend. Il tempo di richiesta di NGINX ha un proprio intervallo: inizia già dalla lettura dei primi byte del client e si estende fino alla scrittura nel log dopo l'invio degli ultimi byte.

I valori del browser e del server possono essere utilizzati come prospettive complementari, ma non devono essere sommati o sottratti l’uno dall’altro per ottenere un resoconto temporale completo senza verificarli prima. Gli intervalli di misurazione possono sovrapporsi e gli orologi del client e del server non sono sincronizzati in modo affidabile. Annota quindi, accanto a ciascun valore, quale richiesta e quale percorso di risposta sono stati effettivamente osservati.

Aggiungere i log e PHP-FPM

Un timer di applicazione mostra solo il codice racchiuso tra le righe. Ulteriori Registri del server aiutano a considerare la stessa richiesta da una prospettiva diversa. A tal fine, associa il valore PHP e la voce di log utilizzando un identificativo di richiesta assegnato nel rispetto della normativa sulla protezione dei dati. Verifica innanzitutto se sia stato effettivamente seguito lo stesso percorso di risposta e che non si stia confondendo un reindirizzamento con una richiesta indipendente.

Con NGINX si inizia $request_time inizia con la lettura dei primi byte del client e termina con la scrittura del log dopo l'invio degli ultimi byte di risposta. Questa durata ha limiti diversi rispetto a quelli di un timer all'interno dell'applicazione PHP e pertanto non è equiparabile ad esso.

Verifica il formato di log configurato e i limiti di misurazione prima di trattare un valore di log come dato di runtime PHP. Il Analisi della latenza dell'hosting per rete, PHP e database offre ulteriori spunti per l'analisi dell'intero percorso di risposta.

Anche la fine della risposta visibile non deve necessariamente significare la fine del lavoro in PHP. Con fastcgi_finish_request() PHP-FPM può completare la risposta e successivamente eseguire altro codice. Per valutare il carico dei worker è quindi necessario ricorrere anche al monitoraggio lato server; un valore breve rilevato lato client non esclude la necessità di ulteriori elaborazioni successive.

In caso di streaming o di header già inviati, un valore complessivo determinato in un secondo momento non può più essere inserito in modo affidabile nell’header di risposta originale. A tal fine, utilizza log o tracciamenti adeguati. Limita l’accesso e la conservazione al minimo indispensabile ed evita di includere dati personali o contenuti riservati nei valori di misurazione e negli identificatori di correlazione.

Restringere il campo di ricerca a database, API e frontend

Se l'intervallo dell'applicazione è lungo, suddividilo in intervalli più piccoli in punti significativi dal punto di vista tecnico. Una chiamata al database misurata separatamente può mostrare quanto tempo è trascorso all'interno di tale chiamata. Dal punto di vista dell’applicazione, tale valore può includere, se del caso, anche i tempi di connessione e di trasmissione e non è da equiparare al tempo di elaborazione puro del database.

Un valore lungo nel database è un'ipotesi per il passo successivo, non una diagnosi definitiva. Verifica la query in questione utilizzando gli strumenti di diagnostica del database disponibili e il relativo piano di esecuzione. Solo in questo modo è possibile stabilire se sia coinvolto, ad esempio, un percorso di accesso non ottimale o un'altra causa; il timer PHP da solo non dimostra la mancanza di un indice.

Per un'API esterna, devi impostare un altro timer immediatamente dopo la chiamata in uscita. Un lungo Intervallo API indica dove l'applicazione va in attesa, ma non spiega automaticamente il motivo. Verifica, utilizzando i tempi dettagliati del client o il tracciamento, se disponibili, se vi siano anomalie nella risoluzione dei nomi, nella creazione della connessione, nella controparte o nella trasmissione.

Se l'HTML viene caricato rapidamente, ma la pagina continua a sembrare lenta, passa alla prospettiva del browser. Esamina le singole richieste di risorse e, successivamente, l'elaborazione JavaScript e la visualizzazione. Il timer PHP del documento non registra automaticamente né le successive richieste di risorse né l’intero funzionamento del browser; anche per questi passaggi dovrai fare delle osservazioni per conto tuo.

Se manca un valore di misurazione PHP, controlla innanzitutto il Percorso della cache: Una cache a monte può fornire una risposta senza ricorrere a PHP per quella richiesta. L'assenza dell'header non significa quindi che PHP abbia impiegato zero millisecondi. Tieni separati i risultati della cache e le risposte dinamiche e confronta solo le richieste corrispondenti.

Valutare i risultati e approfondirne l'analisi

Prima di trarre conclusioni da valori che saltano all’occhio, verifica la loro attribuzione: l’evento del browser, l’header e il log appartengono davvero alla stessa richiesta? Diversi stati dell’utente, risultati della cache o reindirizzamenti potrebbero altrimenti generare differenze apparenti. Documenta inoltre i limiti e le unità di misura di ciascun valore prima di confrontare più cicli di elaborazione.

All'indirizzo intervalli annidati non devi sommare il tempo part-time al tempo totale. Anche la differenza tra l'applicazione e il database non corrisponde automaticamente al tempo di CPU di PHP; essa descrive innanzitutto solo il tempo rimanente trascorso entro i limiti selezionati. Allo stesso modo, la differenza tra la misurazione del browser e quella dell'applicazione non è necessariamente solo tempo di rete.

Se l'intervallo di applicazione definito è ripetutamente lungo, ma il codice che causa il sovraccarico non è ancora noto, l'uso di un profiler rappresenta il passo successivo più sensato. Può aiutare a concentrare l'analisi su determinate funzioni e percorsi di chiamata. In questo caso, specifica chiaramente quale richiesta e quale sezione stai profilando, invece di estendere il risultato a ogni pagina dell'applicazione.

Se invece si tratta di valutare il comportamento in caso di accessi simultanei, la misurazione di una singola richiesta non è sufficiente. Pianifica un test applicativo riproducibile in condizioni controllate e prendi in considerazione le risposte positive, gli errori e i tempi di risposta. Il contributo su Benchmark della CPU del server per carichi di lavoro PHP reali spiega come si possano distinguere tra loro un esercizio di calcolo e un test applicativo.

Infine, includi nella valutazione anche il lavoro svolto dopo aver completato la risposta: quando si utilizza fastcgi_finish_request() La chiusura rapida del browser può coincidere con ulteriori operazioni in PHP. Scegli quindi la misurazione successiva in base alla questione in esame: il tempo di risposta visibile, la durata di un blocco di codice o il carico sul worker sono obiettivi diversi.

Fonti e stato dell'arte

Stato della ricerca:

Aggiornato al: 13 novembre 2026. L'esempio hrtime richiede PHP 7.3 o versioni successive; il server timing viene classificato in base alla bozza di lavoro del W3C del 2 novembre 2026.

https://www.php.net/manual/en/function.hrtime.php

https://www.w3.org/TR/2026/WD-server-timing-20261102/

https://www.w3.org/TR/resource-timing/

https://www.php.net/manual/en/book.hrtime.php

https://www.php.net/manual/en/function.header.php

https://nginx.org/en/docs/http/ngx_http_log_module.html

https://www.php.net/fastcgi_finish_request

Articoli attuali