array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.ignore-user-abort.php', 1 => 'ignore_user_abort', 2 => 'Define se uma desconexão de cliente deve abortar execução de script', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Funções Miscelâneas', ), 'prev' => array ( 0 => 'function.hrtime.php', 1 => 'hrtime', ), 'next' => array ( 0 => 'function.pack.php', 1 => 'pack', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/misc/functions/ignore-user-abort.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ignore_user_abort

(PHP 4, PHP 5, PHP 7, PHP 8)

ignore_user_abort — Define se uma desconexão de cliente deve abortar execução de script

Descrição

ignore_user_abort(?bool $enable = null): int

Define se a desconexão do cliente deve abortar a execução do script.

Ao executar o PHP como um script de linha de comando, e o terminal do script for fechado antes do script ser terminado, o script irá morrer na próxima vez que tentar escreve algo, a menos que o parâmetro enable seja definido para true

Parâmetros

enable

Se definido e não null, esta função definirá a configuração ini ignore_user_abort para o valor definido em enable. Caso contrário, esta função irá somente retornar a configuração anterior sem alterá-la.

Valor Retornado

Retorna a configuração anterior, como um inteiro.

Registro de Alterações

Versão Descrição
8.0.0 enable agora pode ser nulo.

Exemplos

Exemplo #1 Um exemplo de ignore_user_abort()

<?php
// Ignora o cancelamento pelo usuário e permite que o script
// seja executado para sempre
ignore_user_abort(true);
set_time_limit(0);

echo 'Testando gerenciamento de conexões no PHP';

// Executa uma repetição sem sentido que em algum momento
// talvez nos faça clicar fora da página ou
// clicar no botão de "Stop" do navegador.
while(1)
{
// A conexão falhou?
if(connection_status() != CONNECTION_NORMAL)
{
break;
}

// Espera por 10 segundos
sleep(10);
}

// Se esta linha for alcançada, então o 'break'
// foi ativado de dentro da repetição 'while'

// Aqui pode-se fazer algum registro, ou executar outras tarefas
// conforme necessário sem realmente ficar dependente do
// navegador.
?>

Notas

O PHP não irá detectar que o usuário cancelou a conexão até que uma tentativa seja feita de enviar informação ao cliente. Simplesmente usar uma isntrução 'echo' não garante que a informação é enviada, consulte a função flush().

Veja Também