Para diferenciar el tiempo de ejecución de PHP en la red y en el frontend, primero debes medir un intervalo de código claramente definido con hrtime() y lo comparas con los valores del navegador y del servidor correspondientes a esa misma solicitud. Un único dato de tiempo no constituye un registro completo de horas trabajadas: El temporizador de PHP también incluye tiempos de espera dentro de su intervalo, mientras que los tiempos del navegador tienen otros límites. El temporizador del servidor puede transmitir valores complementarios, pero no los mide por sí mismo. A la hora de comparar, debes tener en cuenta el estado de la caché, las respuestas provisionales y las mediciones anidadas.
Lo que realmente muestran los valores actuales
Una página que tarda en cargarse puede perder tiempo en varios puntos: mientras espera una respuesta, en PHP, en las consultas a la base de datos o más tarde, durante el procesamiento en el navegador. Un único valor para la Tiempo de ejecución de PHP No puede distinguir entre estas causas. Lo decisivo es qué parte de una solicitud concreta recoge realmente un valor de medición.
Un temporizador de PHP mide el tiempo transcurrido entre dos llamadas en el código de la aplicación. Si entre ambas llamadas se produce una consulta a la base de datos o una llamada a una API, su tiempo de espera también se tiene en cuenta. Por lo tanto, el resultado no es únicamente tiempo de CPU y tampoco proporciona información sobre el código que se ejecuta antes del inicio o después de la finalización del temporizador.
El navegador, por su parte, observa los eventos desde su propia perspectiva: por ejemplo, el inicio de una solicitud y la recepción de una respuesta. En el caso de una solicitud de documento dinámica, entre estos eventos pueden intercalarse rutas de red, procesamiento mediante proxy y tareas del lado del servidor. Los componentes que se incluyen dependen de los eventos concretos y de la ruta de respuesta real.
El encabezado HTTP Horario del servidor Además, transmite valores especificados que, por ejemplo, determina la propia aplicación. No mide automáticamente todo el recorrido del servidor. Además, el valor correspondiente a una consulta a la base de datos puede estar comprendido dentro del intervalo de la aplicación; en ese caso, no es posible sumar ambas cifras para obtener una duración total.
Compara las perspectivas de la misma solicitud, en lugar de tratarlas como un historial temporal completo. Un intervalo de aplicación prolongado es un punto de partida para la búsqueda en el backend. Por el contrario, un intervalo corto con una visualización lenta en el navegador solo indica, en un primer momento, que la causa puede encontrarse fuera de ese fragmento de código medido expresamente.
Definir la solicitud y las condiciones de medición
Elige primero una ruta concreta y la solicitud de documento correspondiente, por ejemplo, la página dinámica de un producto en una tienda online. Indica si estás analizando un estado de usuario registrado o anónimo y qué datos de prueba se utilizan. De lo contrario, la presencia de diferentes carritos de la compra, permisos o contenidos podría hacer que la aplicación no funcione de la misma manera.
A continuación, define la Límites de medición: ¿En qué parte del código PHP comienza el temporizador, dónde termina y qué llamadas a la base de datos o a la API hay entre medias? Anota también si la medición no comienza hasta después de que se haya iniciado el framework. Solo con estos datos se podrá evaluar más adelante qué significa realmente un valor corto o largo.
Distingue entre aciertos y fallos de caché. Si una caché previa proporciona la respuesta sin PHP, es posible que falte un valor de la aplicación; eso no demuestra que el tiempo de ejecución de PHP sea de cero milisegundos. También debes registrar las redirecciones como solicitudes independientes, en lugar de comparar sus tiempos, sin darte cuenta, con los del documento final.
Repite la prueba en condiciones lo más similares posible: el mismo navegador, una conexión similar, el mismo estado del usuario y el estado de la caché documentado. Una sola ejecución puede dar lugar a resultados atípicos debido a retrasos temporales o a una ruta de respuesta diferente. Por lo tanto, registra varios valores y sus condiciones, en lugar de seleccionar únicamente el valor más rápido.
Para la práctica, necesitarás las herramientas de desarrollo del navegador y, para un temporizador PHP, acceso al código de la aplicación. Utiliza un entorno de pruebas o una ruta autorizada para ello; los cambios en producción y las pruebas de carga requieren la autorización correspondiente. Los registros del servidor web o un perfilador pueden complementar el análisis, pero no son imprescindibles para una primera comparación.
Asigna el valor del navegador y la medición del lado del servidor a la misma solicitud, por ejemplo, mediante un identificador tratado de conformidad con la normativa de protección de datos. Para ello, no recopiles datos personales innecesarios y limita el acceso a la información de diagnóstico. Sin esta asignación, incluso las llamadas paralelas o un cambio de caché entretanto pueden falsear la comparación.
Interpretar correctamente los tiempos del navegador
Abre la sección «Red» en las herramientas de desarrollo y selecciona, en primer lugar, la solicitud del documento correspondiente a la navegación que estás analizando. Los valores temporales de esta solicitud no describen automáticamente las imágenes, las hojas de estilo o las llamadas posteriores a la API. Para cada uno de estos recursos individuales, Resource Timing ofrece una perspectiva propia; por lo tanto, su procesamiento en el navegador tampoco queda completamente explicado.
El momento requestStart marca el inicio de la solicitud desde el punto de vista del navegador. responseStart indica el inicio de una respuesta recibida, mientras que responseEnd marca el final de la recepción de la respuesta. Las diferencias describen intervalos observados; en particular, el tiempo transcurrido hasta el inicio de la respuesta no debe equipararse a un intervalo de código PHP.
En respuestas provisionales hay que tener especial cuidado: una respuesta como «103 Early Hints» ya puede, incluso en responseStart se debe tener en cuenta. Cuando el navegador finalResponseHeadersStart Si se tiene en cuenta este momento, resulta útil para situar el inicio de la respuesta definitiva. La diferencia con respecto a requestStart Por lo tanto, no debe denominarse de forma generalizada como «tiempo de espera hasta el encabezado HTML definitivo».
La caché, los Service Workers, las redirecciones y una conexión reutilizada influyen en la ruta que sigue una solicitud y en cómo deben interpretarse sus tiempos. En el caso de recursos de otros orígenes, algunos datos pueden faltar o ser nulos si no se dispone de la autorización correspondiente. Comprueba estas condiciones antes de comparar dos valores de navegador entre sí.
Si el tiempo de espera del navegador es elevado, pero el intervalo de PHP medido es corto, eso no implica necesariamente que haya un problema de red. El tiempo también puede transcurrir en un proxy o en una cola antes del punto de medición de PHP. Hay que tener especial cuidado al realizar la comparación cuando el procesamiento de PHP no se lleva a cabo hasta después de una respuesta preliminar: en ese caso, los dos intervalos tienen límites diferentes.
Medir código PHP con hrtime
Con hrtime(true) mide el tiempo transcurrido entre dos puntos del código PHP que tú mismo elijas. La función utiliza una base de tiempo monótona: Durante ese tiempo, se calcula la diferencia entre dos llamadas, en lugar de interpretar un momento concreto como la hora. El intervalo medido puede incluir también tiempos de espera y, por lo tanto, no se trata de un tiempo de CPU puro.
Para el siguiente ejemplo, crea un archivo de prueba aislado en un entorno compartido con PHP 7.3 o superior. Accede a él a través del servidor web para poder comprobar después el encabezado de respuesta en las herramientas de desarrollo del navegador. El marcador de posición representa la parte de la aplicación cuyo inicio y fin debes definir tú mismo.
La función devuelve el valor numérico en nanosegundos; al dividirlo por un millón se obtiene la duración en milisegundos. En sistemas de 32 bits, el valor devuelto puede ser un número de tipo «float». La comprobación de errores evita que, si el valor devuelto es false se muestra una duración no válida. La unidad «nanosegundos», por sí sola, no garantiza la precisión de medición correspondiente.
En el ejemplo, el intervalo finaliza antes de establecer el encabezado y antes de la salida. Por lo tanto, no recoge ni estos pasos ni el trabajo que tiene lugar antes de la primera marca de tiempo o después de la segunda. Si estableces el inicio solo después del inicio del framework, su inicialización previa tampoco aparecerá en el resultado.
Si sustituyes el marcador de posición por una llamada a una base de datos o a una API, el tiempo de espera de esta se contabiliza en el intervalo. Por lo tanto, un valor elevado indica, en un primer momento, que la sección entre corchetes tardó mucho tiempo; aún no distingue entre el cálculo de PHP y la espera de otros servicios. Para realizar esta distinción, necesitas más puntos de medición, más precisos.
Transmisión de los valores medidos mediante el temporizador del servidor
El encabezado Server-Timing envía las métricas especificadas al cliente. No mide la duración por sí mismo: la aplicación o un componente del servidor implicado debe calcular el valor previamente. Para dur La especificación recomienda milisegundos; el nombre describe la métrica, pero no establece automáticamente sus límites de medición.
En el ejemplo de PHP, el encabezado debe establecerse antes de que se envíe realmente la salida. El segundo parámetro false en header() añade otro campo de encabezado, en lugar de sustituir un campo ya existente con el mismo nombre. En un marco de trabajo, el middleware de respuesta suele ser un punto de integración adecuado, siempre que la medición ya haya finalizado en ese punto y los encabezados aún no se hayan enviado.
El siguiente encabezado de respuesta HTTP muestra dos valores ficticios; no se trata de una medición. Suponiendo que el intervalo de la base de datos se encuentre íntegramente dentro del intervalo de la aplicación, los valores son anidado. Los 75 milisegundos correspondientes a la base de datos ya están incluidos en los 120 milisegundos de la aplicación y no deben sumarse.
Bajo esta hipótesis, la diferencia de 45 milisegundos describe únicamente el tiempo restante dentro de app. No se trata automáticamente del tiempo de CPU de PHP: también ahí pueden incluirse otros tiempos de espera. Por lo tanto, documenta para cada métrica dónde comienza y dónde termina, y si incluye otros intervalos.
Solo se deben mostrar valores seleccionados de forma consciente y lo suficientemente aproximados. Los nombres y las descripciones de las métricas pueden revelar detalles de la infraestructura; los datos personales no deben figurar en el encabezado. El acceso entre dominios a los datos de tiempo mediante JavaScript está restringido y puede gestionarse con Timing-Allow-Origin se controlan. Deberías comprobar específicamente si existe dicha autorización para los orígenes necesarios.
Comparación de intervalos de medición
Las magnitudes de la tabla responden a diferentes preguntas. Compáralas, en la medida de lo posible, para la misma solicitud y anota los límites correspondientes: un intervalo visible en el navegador no comienza ni termina automáticamente en los mismos puntos que un temporizador de PHP o un valor de registro de NGINX. Además, es especialmente importante la Unidad: Los milisegundos y los segundos no deben evaluarse juntos sin comprobarlos previamente.
| Variable medida | Inicio y fin | Unidad | Tiempos de espera y restricciones |
|---|---|---|---|
| Intervalo de código PHP | Entre dos llamadas a «hrtime» definidas por uno mismo | Nanosegundos como valor numérico; a menudo convertidos a milisegundos | Incluye los tiempos de espera dentro del tramo; no incluye el tiempo de CPU puro ni la solicitud completa. |
| Métrica de tiempo del servidor | Determinado por el componente de medición | Para «dur» se recomiendan milisegundos | Transmite un valor calculado; los tiempos de espera incluidos dependen de los límites definidos. |
| Intervalo de solicitud del navegador | desde requestStart hasta responseStart | Milisegundos | Incluye el tiempo de espera observado desde el navegador; «responseStart» puede registrar una respuesta provisional. |
| Intervalo de respuesta del navegador | Desde «responseStart» hasta «responseEnd» | Milisegundos | Describe el intervalo de respuesta observado; no debe confundirse con la ejecución pura de PHP. |
| Tiempo de solicitud de NGINX | Primera lectura de los bytes del cliente hasta el registro en el log tras el envío de los últimos bytes | Segundos | Incluye la solicitud desde el punto de vista de NGINX, incluidos los tiempos de espera; los límites difieren de los del temporizador de PHP. |
Comprueba el formato real del registro antes de interpretar un valor como la duración total del backend. El tiempo de solicitud de NGINX tiene su propio marco: comienza ya al leer los primeros bytes del cliente y se extiende hasta que se escribe el registro tras el envío de los últimos bytes.
Los valores del navegador y del servidor pueden utilizarse como perspectivas complementarias, pero no deben sumarse ni restarse entre sí para obtener un balance temporal completo sin comprobarlos previamente. Los rangos de medición pueden solaparse, y los relojes del cliente y del servidor no están sincronizados de forma fiable. Por lo tanto, junto a cada valor, anota qué solicitud y qué ruta de respuesta se han observado realmente.
Completar los registros y PHP-FPM
Un temporizador de aplicación solo muestra el código enmarcado. Complementario Registros del servidor ayudan a analizar la misma solicitud desde otra perspectiva. Para ello, asocia el valor de PHP y la entrada del registro mediante un identificador de solicitud asignado de conformidad con la normativa de protección de datos. Comprueba primero si realmente se ha recorrido la misma ruta de respuesta y que no se confunda una redirección con una solicitud independiente.
En NGINX comienza $request_time comienza con la lectura de los primeros bytes del cliente y finaliza con el registro en el log tras el envío de los últimos bytes de respuesta. Este valor tiene límites distintos a los de un temporizador dentro de la aplicación PHP y, por lo tanto, no debe equipararse a él.
Comprueba el formato de registro configurado y los límites de medición antes de tratar un valor de registro como parte del tiempo de ejecución de PHP. El Análisis de la latencia del alojamiento web para la red, PHP y la base de datos ofrece otros puntos de partida para el análisis de toda la ruta de respuesta.
El final de la respuesta visible tampoco tiene por qué suponer el final del trabajo de PHP. Con fastcgi_finish_request() PHP-FPM puede completar la respuesta y, a continuación, ejecutar código adicional. Por lo tanto, para evaluar la carga de los trabajadores, necesitas además una supervisión del lado del servidor; un valor breve del lado del cliente no descarta que haya trabajo posterior.
En el caso del streaming o de los encabezados ya enviados, un valor total determinado posteriormente ya no puede incluirse de forma fiable en el encabezado de respuesta original. Utiliza para ello los registros o el rastreo adecuados. Limita el acceso y la conservación a lo estrictamente necesario y evita incluir datos personales o contenidos confidenciales en los valores de medición y los identificadores de correlación.
Delimitar la base de datos, la API y el front-end
Si el intervalo de la aplicación es largo, divídelo en intervalos más pequeños en los puntos que resulten más adecuados desde el punto de vista técnico. Una consulta a la base de datos medida por separado puede mostrar cuánto tiempo ha transcurrido dentro de dicha consulta. Desde el punto de vista de la aplicación, este valor puede incluir también, en su caso, los tiempos de conexión y de transmisión, y no debe equipararse al tiempo de cálculo puro de la base de datos.
Un valor largo en la base de datos es una hipótesis para el siguiente paso, no un diagnóstico definitivo. Comprueba la consulta en cuestión con las herramientas de diagnóstico de la base de datos disponibles y su plan de ejecución. Solo así se podrá determinar si hay, por ejemplo, una ruta de acceso poco óptima u otra causa implicada; el temporizador de PHP por sí solo no demuestra que falte un índice.
Para una API externa, debes establecer otro temporizador inmediatamente después de la llamada saliente. Una llamada larga Intervalo de la API Muestra dónde se produce la espera en la aplicación, pero no explica automáticamente el motivo. Comprueba, mediante tiempos detallados del cliente o un seguimiento (si está disponible), si hay algo anómalo en la resolución de nombres, el establecimiento de la conexión, el lado remoto o la transmisión.
Si el código HTML se carga rápidamente, pero la página sigue pareciendo lenta, cambia a la perspectiva del navegador. Analiza las solicitudes de recursos individuales y, a continuación, el procesamiento de JavaScript y la visualización. El temporizador PHP del documento no registra automáticamente las solicitudes de recursos posteriores ni todo el trabajo del navegador; para estos pasos también necesitarás realizar tus propias observaciones.
Si falta un valor de PHP, comprueba primero el Ruta de caché: Una caché previa puede proporcionar una respuesta sin necesidad de ejecutar PHP para esa solicitud. Por lo tanto, la ausencia del encabezado no significa que PHP haya tardado cero milisegundos. Registra por separado los aciertos en la caché y las respuestas dinámicas, y compara únicamente las solicitudes correspondientes.
Evaluar los resultados y seguir analizándolos
Antes de deducir una medida a partir de cifras llamativas, comprueba su asignación: ¿el evento del navegador, el encabezado y el registro pertenecen realmente a la misma solicitud? De lo contrario, los diferentes estados del usuario, las coincidencias en la caché o los redireccionamientos pueden generar diferencias aparentes. Además, documenta los límites y las unidades de cada valor antes de comparar varias ejecuciones.
En intervalos anidados No debes sumar el tiempo a tiempo parcial al tiempo total. La diferencia entre la aplicación y la base de datos tampoco es automáticamente tiempo de CPU de PHP; en primer lugar, solo describe el tiempo restante transcurrido dentro de los límites seleccionados. Del mismo modo, la diferencia entre la medición del navegador y la de la aplicación no es, sin más, tiempo de red puro.
Si el intervalo de aplicación definido es repetidamente largo, pero aún se desconoce cuál es el código que genera el coste, lo más sensato es utilizar un perfilador. Este puede ayudar a centrar el análisis en funciones y rutas de llamada concretas. Para ello, especifica claramente qué solicitud y qué sección estás perfilando, en lugar de aplicar el resultado a todas las páginas de la aplicación.
Sin embargo, cuando se trata del comportamiento ante accesos simultáneos, no basta con medir una sola solicitud. Planifica una prueba de aplicación reproducible en condiciones reales y ten en cuenta las respuestas correctas, los errores y los tiempos de respuesta. El artículo sobre el Pruebas de rendimiento de la CPU del servidor para cargas de trabajo reales de PHP explica cómo se pueden diferenciar entre sí un ejercicio de cálculo y una prueba de aplicación.
Por último, incluye también en la valoración el trabajo realizado tras dar la respuesta: al utilizar fastcgi_finish_request() El cierre rápido del navegador puede coincidir con otras tareas de PHP. Por lo tanto, elige la siguiente medición en función de la cuestión que se plantee: el tiempo de respuesta visible, la duración de un fragmento de código o la carga del worker son objetivos distintos.
Fuentes y estado actual de los conocimientos
Estado de la investigación:
Fecha de la investigación: 13 de noviembre de 2026. El ejemplo de hrtime requiere PHP 7.3 o superior; el «server timing» se clasifica según el borrador de trabajo del W3C del 2 de noviembre 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




