...

Medir o tempo de execução do PHP separadamente da rede e do front-end

Para distinguir o tempo de execução do PHP da rede e do front-end, começa por medir um intervalo de código claramente definido com hrtime() e compara-o com os valores do navegador e do servidor relativos à mesma solicitação. Um único valor temporal não constitui um balanço temporal completo: O temporizador PHP também inclui tempos de espera dentro do seu intervalo, enquanto os tempos de resposta do navegador têm outros limites. O «Server-Timing» pode transmitir valores complementares, mas não os mede por si próprio. É necessário ter em conta o estado da cache, as respostas provisórias e as medições aninhadas ao fazer a comparação.

O que os valores atuais realmente revelam

Uma página que demora a carregar pode perder tempo em várias etapas: enquanto se aguarda uma resposta, no PHP, nas consultas à base de dados ou, posteriormente, durante o processamento no navegador. Um único valor para o Tempo de execução do PHP não consegue distinguir estas causas. O que é determinante é saber qual a parte de um pedido específico que um valor de medição efetivamente regista.

Um temporizador PHP mede o tempo decorrido entre duas chamadas no código da aplicação. Se, entretanto, ocorrer uma chamada à base de dados ou a uma API, o tempo de espera dessa chamada é também contabilizado. Por conseguinte, o resultado não corresponde apenas ao tempo de CPU e também não fornece informações sobre o código que é executado antes do início ou após o fim do temporizador.

Por outro lado, o navegador observa os eventos da sua própria perspetiva: por exemplo, o início de um pedido e a chegada de uma resposta. No caso de um pedido de documento dinâmico, entre estes eventos podem existir percursos de rede, processamento por proxy e operações do lado do servidor. Os elementos que estão incluídos dependem dos respetivos eventos e do percurso real da resposta.

O cabeçalho HTTP Tempo do servidor transmite, além disso, valores especificados que, por exemplo, são determinados pela própria aplicação. Não mede automaticamente todo o percurso do servidor. Além disso, um valor relativo a uma consulta à base de dados pode situar-se dentro do intervalo da aplicação; nesse caso, não é possível somar ambos os valores para obter uma duração total.

Compare as perspetivas para o mesmo pedido, em vez de as tratar como um registo temporal contínuo. Um intervalo de execução prolongado constitui um ponto de partida para a investigação no backend. Por outro lado, um intervalo curto acompanhado de uma exibição lenta no navegador indica, numa primeira análise, apenas que a causa pode estar fora deste trecho de código especificamente medido.

Definir o pedido e as condições de medição

Começa por selecionar um percurso específico e o pedido de documento correspondente, por exemplo, a página dinâmica de um produto numa loja online. Indique se está a analisar um estado de utilizador registado ou anónimo e quais os dados de teste utilizados. Caso contrário, diferentes cestos de compras, autorizações ou conteúdos podem fazer com que a aplicação não funcione da mesma forma.

Em seguida, define a Limites de medição: No código PHP, onde começa o temporizador, onde termina e que chamadas à base de dados ou à API ocorrem entretanto? Anota também se a medição só começa após o arranque do framework. Só com estas informações será possível avaliar posteriormente o que um valor curto ou longo realmente significa.

Distinga entre acertos e falhas de cache. Se um cache a montante fornecer a resposta sem recorrer ao PHP, poderá faltar um valor da aplicação; isso não constitui prova de que o tempo de execução do PHP tenha sido de zero milissegundos. Também deves registar os redirecionamentos como pedidos separados, em vez de comparar os seus tempos, sem dar por isso, com os do documento final.

Repete o teste em condições tão comparáveis quanto possível: o mesmo navegador, ligação semelhante, o mesmo estado do utilizador e estado da cache documentado. Uma única execução pode apresentar resultados atípicos devido a atrasos temporários ou a um caminho de resposta diferente. Por isso, registe vários valores e as respetivas condições, em vez de selecionar apenas o valor mais rápido.

Imagem simbólica gerada por IA de dois cartões vazios separados e um caderno sobre uma secretária
Imagem ilustrativa gerada por IA: as condições documentadas separadamente facilitam a comparação de vários pedidos.

Para a prática, vais precisar das ferramentas de desenvolvimento do navegador e, para um temporizador PHP, acesso ao código da aplicação. Utiliza um ambiente de teste ou um caminho autorizado para esse efeito; as alterações em produção e os testes de carga requerem a devida autorização. Os registos do servidor web ou um profiler podem complementar a análise, mas não são um requisito obrigatório para qualquer comparação inicial.

Associe o valor do navegador e a medição do lado do servidor à mesma solicitação, por exemplo, através de um identificador tratado em conformidade com a proteção de dados. Para tal, não recolha dados pessoais desnecessários e limite o acesso às informações de diagnóstico. Sem esta atribuição, até mesmo chamadas paralelas ou uma alteração entretanto ocorrida na cache podem distorcer uma comparação.

Interpretar corretamente o «Browser Timing»

Nas ferramentas de programador, abra a secção de rede e selecione, em primeiro lugar, o pedido do documento da navegação em análise. Os valores temporais desta solicitação não descrevem automaticamente imagens, folhas de estilo ou chamadas de API posteriores. Para esses recursos individuais, o Resource Timing fornece uma perspetiva específica para cada um; o seu processamento no navegador também não fica, assim, totalmente explicado.

A data requestStart assinala o início do pedido do ponto de vista do navegador. responseStart indica o início de uma resposta recebida, enquanto responseEnd marca o fim da receção da resposta. As diferenças descrevem intervalos observados; em particular, o tempo até ao início da resposta não deve ser equiparado a um intervalo de código PHP.

Em respostas provisórias é necessário ter um cuidado especial: uma resposta como «103 Early Hints» já pode, mesmo em responseStart deve ser tido em conta. Quando o navegador finalResponseHeadersStart Quando apoiado, este momento ajuda a vislumbrar o início da resposta final. A diferença em relação a requestStart não deve, por isso, ser designado de forma genérica como o tempo de espera até ao cabeçalho HTML final.

A cache, o Service Worker, os redirecionamentos e uma ligação reutilizada influenciam o percurso que uma solicitação segue e a forma como os seus tempos devem ser interpretados. No caso de recursos de outras origens, alguns dados podem estar em falta ou ser nulos se não houver a autorização adequada. Verifica estas condições antes de comparares dois valores do navegador.

Se o tempo de espera do navegador for elevado, mas o intervalo PHP medido for curto, isso não significa necessariamente que exista um problema de rede. O tempo também pode ser consumido num proxy ou numa fila antes do ponto de medição do PHP. A comparação deve ser feita com especial cuidado quando o processamento PHP só ocorre após uma resposta preliminar: nesse caso, os dois intervalos têm limites diferentes.

Medir código PHP com a função hrtime

Com hrtime(true) permite medir o tempo decorrido entre dois pontos escolhidos pelo utilizador no código PHP. A função utiliza uma base temporal monotónica: Durante esse período, calculas a diferença entre duas chamadas, em vez de interpretares um momento específico como a hora. O intervalo medido pode também incluir tempos de espera e, por isso, não corresponde apenas ao tempo de CPU.

Para o exemplo seguinte, cria um ficheiro de teste isolado num ambiente partilhado com PHP 7.3 ou superior. Aceda a ele através do servidor Web, para que possa verificar posteriormente o cabeçalho de resposta nas ferramentas de desenvolvimento do navegador. O espaço reservado representa a parte da aplicação cujo início e fim define deliberadamente.

Código
<?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;

A função devolve o valor numérico em nanossegundos; ao dividir por um milhão, obtém-se a duração em milissegundos. Em sistemas de 32 bits, o valor devolvido pode ser um número de tipo float. A verificação de erros impede que, no caso de um valor devolvido de false é apresentada uma duração inválida. A unidade «nanossegundos», por si só, não garante a precisão de medição adequada.

No exemplo, o intervalo termina antes da definição do cabeçalho e antes da saída. Por isso, não inclui estas etapas nem o trabalho realizado antes do primeiro ou após o segundo registo de tempo. Se definires o início apenas após o arranque do framework, a inicialização anterior deste também não constará no resultado.

Se substituíres o marcador de lugar por uma chamada à base de dados ou à API, o tempo de espera dessa chamada será contabilizado no intervalo. Um valor elevado indica, portanto, em primeiro lugar, que a secção entre colchetes demorou muito tempo; ainda não distingue entre cálculos em PHP e a espera por outros serviços. Para fazer essa distinção, são necessários mais pontos de medição, definidos com maior precisão.

Transmitir os valores medidos através do Server-Timing

O cabeçalho Server-Timing transmite as métricas indicadas ao cliente. Não mede a duração por si próprio: a aplicação ou um componente do servidor envolvido tem de determinar previamente o valor. Para dur A especificação recomenda milissegundos; o nome descreve a métrica, mas não define automaticamente os seus limites de medição.

No exemplo em PHP, o cabeçalho deve ser definido antes da saída ser efetivamente enviada. O segundo parâmetro false em header() adiciona um novo campo de cabeçalho, em vez de substituir um campo existente com o mesmo nome. Num framework, um middleware de resposta é frequentemente um ponto de integração adequado, desde que a medição já esteja concluída nessa fase e os cabeçalhos ainda não tenham sido enviados.

O cabeçalho de resposta HTTP a seguir apresenta dois valores fictícios; não se trata de uma medição. Supondo que o intervalo da base de dados se encontre inteiramente dentro do intervalo da aplicação, então os valores são aninhado. Os 75 milissegundos relativos à base de dados já estão incluídos nos 120 milissegundos relativos à aplicação e não devem ser somados.

Ilustração gerada por IA de um intervalo parcial que se insere na totalidade de um intervalo de tempo maior
Ilustração gerada por IA: Um intervalo incluído na base de dados não é adicionado à duração da aplicação.
Código
Server-Timing: app;dur=120.000, db;dur=75.000

Partindo deste pressuposto, a diferença de 45 milissegundos descreve apenas o tempo restante dentro de app. Não se trata automaticamente do tempo de CPU do PHP: também aí podem estar incluídos outros tempos de espera. Por isso, documenta, para cada métrica, onde começa e termina e se inclui outros intervalos.

Apenas forneça valores selecionados de forma consciente e suficientemente aproximados. Os nomes das métricas e as descrições podem revelar detalhes da infraestrutura; os dados pessoais não devem constar no cabeçalho. O acesso entre domínios aos dados de temporização através do JavaScript é restrito e pode ser limitado com Timing-Allow-Origin serem controladas. Deves verificar essa autorização especificamente para as origens necessárias.

Comparação dos intervalos de medição

Os valores apresentados na tabela respondem a diferentes questões. Compará-los, na medida do possível, para o mesmo pedido e anote os respetivos limites: um intervalo visível no navegador não começa nem termina automaticamente nos mesmos pontos que um temporizador PHP ou um valor de registo do NGINX. Além disso, é particularmente importante a Unidade: Os milissegundos e os segundos não devem ser avaliados em simultâneo sem serem verificados.

Parâmetros de medição e os seus respetivos limites
Variável medidaInício e fimUnidadeTempos de espera e restrições
Intervalo de código PHPEntre duas chamadas à função `hrtime` definidas pelo próprio utilizadorNanossegundos como valor numérico; frequentemente convertidos em milissegundosInclui tempos de espera dentro do segmento; não inclui tempo de CPU puro nem uma solicitação completa.
Métrica de temporização do servidorDeterminado pela componente de mediçãoPara o dur, recomenda-se milissegundosTransmite um valor calculado; os tempos de espera incluídos dependem dos limites definidos.
Intervalo de pedidos do navegadorrequestStart até responseStartMilissegundosInclui o tempo de espera observado do ponto de vista do navegador; o `responseStart` pode registar uma resposta preliminar.
Intervalo de resposta do navegadorresponseStart até responseEndMilissegundosDescreve o intervalo de resposta observado; não deve ser confundido com a execução pura do PHP.
Tempo de resposta do NGINXPrimeira leitura dos bytes do cliente até à gravação no registo após o envio dos últimos bytesSegundosInclui o pedido do ponto de vista do NGINX, incluindo os tempos de espera; os limites diferem dos do temporizador do PHP.

Verifica o formato real do registo antes de interpretares um valor como a duração total do backend. O tempo de pedido do NGINX tem um intervalo próprio: começa logo na leitura dos primeiros bytes do cliente e vai até à gravação no registo, após o envio dos últimos bytes.

Os valores do navegador e do servidor podem ser utilizados como perspetivas complementares, mas não devem ser somados nem subtraídos uns dos outros para obter um registo temporal completo sem uma verificação prévia. As faixas de medição podem sobrepor-se e os relógios do cliente e do servidor não estão sincronizados de forma fiável. Por isso, registe, ao lado de cada valor, qual a solicitação e qual o percurso de resposta que foram efetivamente observados.

Complementar os registos e o PHP-FPM

Um temporizador de aplicação mostra apenas o código entre parênteses. Complementar Registos do servidor ajudam a analisar o mesmo pedido de uma perspetiva diferente. Para tal, associe o valor PHP e a entrada do registo a um identificador de pedido atribuído em conformidade com a legislação de proteção de dados. Verifique, em primeiro lugar, se foi efetivamente percorrido o mesmo caminho de resposta e se não se está a confundir um redirecionamento com um pedido independente.

No NGINX, começa $request_time começa com a leitura dos primeiros bytes do cliente e termina com a gravação do registo após o envio dos últimos bytes da resposta. Este valor tem limites diferentes dos de um temporizador dentro da aplicação PHP e, por isso, não deve ser equiparado a este.

Verifica o formato de registo configurado e os limites de medição antes de tratares um valor de registo como parte do tempo de execução do PHP. O Análise da latência de alojamento para a rede, PHP e base de dados oferece outros pontos de partida para a análise de todo o percurso da resposta.

Mesmo o fim da resposta visível não tem de significar o fim do trabalho do PHP. Com fastcgi_finish_request() O PHP-FPM pode concluir a resposta e, em seguida, executar mais código. Para avaliar a carga dos workers, é, portanto, necessário um monitorização adicional do lado do servidor; um valor breve do lado do cliente não exclui a possibilidade de trabalho posterior.

No caso de streaming ou de cabeçalhos já enviados, um valor total determinado posteriormente já não pode ser incluído de forma fiável no cabeçalho de resposta original. Recorra, para o efeito, a registos ou rastreios adequados. Limite o acesso e a conservação ao estritamente necessário e evite incluir dados pessoais ou conteúdos confidenciais nos valores de medição e nos identificadores de correlação.

Delimitar a base de dados, a API e o front-end

Se o intervalo da aplicação for longo, divida-o em intervalos mais pequenos em pontos que façam sentido do ponto de vista técnico. Uma chamada à base de dados medida separadamente pode mostrar quanto tempo decorreu no âmbito dessa chamada. Do ponto de vista da aplicação, este valor pode incluir, se for o caso, os tempos de ligação e de transmissão, não devendo ser equiparado ao tempo de processamento puro da base de dados.

Um valor extenso na base de dados é uma hipótese para o próximo passo, não um diagnóstico definitivo. Verifica a consulta em questão com as ferramentas de diagnóstico da base de dados disponíveis e o seu plano de execução. Só assim é possível determinar se está envolvido, por exemplo, um caminho de acesso desfavorável ou outra causa; o temporizador do PHP, por si só, não prova a ausência de um índice.

Para uma API externa, define-se um temporizador adicional imediatamente a seguir à chamada de saída. Uma chamada demorada Intervalo da API mostra onde a aplicação fica em espera, mas não indica automaticamente o motivo. Verifique, através de medições detalhadas dos tempos do cliente ou de rastreamento, sempre que disponíveis, se há algo de anormal na resolução de nomes, no estabelecimento da ligação, na parte contrária ou na transmissão.

Se o HTML for carregado rapidamente, mas a página continuar a parecer lenta, passa para a perspetiva do navegador. Analisa os pedidos de recursos individualmente e, em seguida, o processamento do JavaScript e a apresentação. O temporizador PHP do documento não regista automaticamente as solicitações de recursos posteriores nem todo o trabalho do navegador; para estas etapas, também precisas das tuas próprias observações.

Se faltar um valor de medição do PHP, verifica primeiro o Caminho da cache: Uma cache a montante pode fornecer uma resposta sem recorrer ao PHP para essa solicitação. A ausência do cabeçalho não significa, portanto, que o PHP tenha demorado zero milissegundos. Regista separadamente os acertos na cache e as respostas dinâmicas e compara apenas as solicitações devidamente associadas.

Avaliar os resultados e continuar a analisá-los

Antes de deduzir uma medida a partir de valores que chamam a atenção, verifica a sua atribuição: o evento do navegador, o cabeçalho e o registo pertencem realmente à mesma solicitação? Caso contrário, diferentes estados do utilizador, acertos na cache ou redirecionamentos podem criar diferenças aparentes. Além disso, documenta os limites e as unidades de cada valor antes de comparares várias execuções.

Em intervalos aninhados não podes somar o tempo a tempo parcial ao tempo total. Uma diferença entre a aplicação e a base de dados também não corresponde automaticamente ao tempo de CPU do PHP; descreve, em primeiro lugar, apenas o tempo restante decorrido dentro dos limites selecionados. Da mesma forma, a diferença entre a medição do navegador e a da aplicação não corresponde, de imediato, a tempo de rede puro.

Se o intervalo de execução definido for repetidamente longo, mas o código dispendioso ainda for desconhecido, a utilização de um profiler é o próximo passo sensato. Este pode ajudar a direcionar a análise para determinadas funções e percursos de chamadas. Ao fazê-lo, especifica claramente qual a solicitação e qual a secção que estás a analisar, em vez de generalizar o resultado a todas as páginas da aplicação.

Por outro lado, no que diz respeito ao comportamento em caso de acessos simultâneos, a medição de uma única solicitação não é suficiente. Planeie um teste de aplicação reproduzível em condições controladas e tenha em conta as respostas bem-sucedidas, os erros e os tempos de resposta. O artigo sobre o Avaliação do desempenho da CPU do servidor para cargas de trabalho reais em PHP explica como se pode distinguir entre um exercício de cálculo e um teste de aplicação.

Por fim, inclua também o trabalho realizado após a conclusão da resposta na avaliação: ao utilizar fastcgi_finish_request() O encerramento rápido do navegador pode coincidir com mais trabalho em PHP. Por isso, escolhe a próxima medição de acordo com a questão em aberto: o tempo de resposta visível, a duração de um trecho de código ou a carga do worker são objetivos diferentes.

Fontes e estado atual dos conhecimentos

Estado da pesquisa:

Data da pesquisa: 13 de novembro de 2026. O exemplo hrtime requer PHP 7.3 ou superior; o Server-Timing é classificado com base no rascunho de trabalho do W3C de 2 de novembro de 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

Artigos actuais

Ilustração gerada por IA de intervalos de medição sobrepostos e entrelaçados sobre um fundo escuro
Administração

Medir o tempo de execução do PHP separadamente da rede e do front-end

Um temporizador PHP, os tempos do navegador e o tempo do servidor mostram diferentes fases de um pedido. Desta forma, podes comparar os seus limites e identificar de forma específica os pontos de estrangulamento na base de dados, na rede e no front-end.