connection_timeout()

connection_aborted()

Introducción a la función connection_aborted()

La función connection_aborted() en PHP se utiliza para comprobar si el cliente ha interrumpido la conexión con el servidor web. Tenga en cuenta que esta función solo funciona con SAPIs de servidor web (como Apache o Nginx) y no está disponible en el CLI SAPI. Es especialmente útil en scripts de larga duración o procesos por lotes donde la desconexión del cliente debería detener la ejecución. A diferencia de los tiempos de espera del lado del servidor, esta función detecta específicamente cuándo el navegador del cliente o el script cierra la conexión de forma prematura.

Uso de la función connection_aborted()

La función connection_aborted() devuelve un boolean (true o false). Cuando se evalúa numéricamente, true corresponde a 1 (lo que indica que el cliente ha interrumpido la conexión) y false corresponde a 0 (lo que indica que la conexión sigue activa).

Ejemplo de uso de la función connection_aborted()

A continuación se muestra un ejemplo de cómo se puede utilizar la función connection_aborted() en PHP:

<?php

// Typically used in long-running scripts or loops to detect client disconnection
if (connection_aborted()) {
  // Clean up resources or stop processing
  // e.g., close open files, release locks, or log the disconnection event
} else {
  // Continue normal execution
}

En este ejemplo, se llama a la función connection_aborted() para comprobar si el cliente ha interrumpido la conexión, y el valor de retorno se utiliza para determinar qué acción tomar.

En scripts de larga duración, se usa habitualmente dentro de un bucle para interrumpir la ejecución de forma anticipada:

<?php
$processing = true;

while ($processing) {
  // Perform a chunk of work
  do_work();

  // Check if the client has disconnected
  if (connection_aborted()) {
    $processing = false; // Break the loop early
  }
}
?>

Conclusión

En conclusión, la función connection_aborted() en PHP puede ser útil para comprobar si el cliente ha interrumpido la conexión y para tomar las medidas adecuadas en función del estado de la conexión.

Práctica