connection_timeout()

connection_aborted()

Introdução à Função connection_aborted()

A função connection_aborted() em PHP é utilizada para verificar se o cliente encerrou a conexão com o servidor web. Note que esta função funciona apenas com SAPIs de servidor web (como Apache ou Nginx) e não está disponível no SAPI de CLI. É principalmente útil em scripts de longa duração ou processos em lote nos quais a desconexão do cliente deve interromper a execução. Ao contrário dos timeouts do lado do servidor, esta função detecta especificamente quando o navegador ou script do cliente encerra a conexão prematuramente.

Uso da Função connection_aborted()

A função connection_aborted() retorna um boolean (true ou false). Quando avaliada numericamente, true corresponde a 1 (indicando que o cliente encerrou a conexão), e false corresponde a 0 (indicando que a conexão ainda está ativa).

Exemplo de Uso da Função connection_aborted()

Aqui está um exemplo de como a função connection_aborted() pode ser usada em 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
}

Neste exemplo, a função connection_aborted() é chamada para verificar se o cliente encerrou a conexão, e o valor de retorno é usado para determinar qual ação tomar.

Para scripts de longa duração, é comumente utilizada dentro de um laço para interromper a execução antecipadamente:

<?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
  }
}
?>

Conclusão

Em conclusão, a função connection_aborted() em PHP pode ser útil para verificar se o cliente encerrou a conexão e para tomar as ações adequadas com base no estado da conexão.

Prática