Resumo : neste tutorial, você aprenderá como usar a construção de saída do PHP para encerrar um script imediatamente.
Introdução à construção de saída do PHP
A exit
construção gera uma mensagem e encerra imediatamente a execução do script atual.
Aqui está a sintaxe da exit
construção:
exit ( string $status = ? ) : void
Linguagem de código: PHP ( php )
Se você usar the $status
como uma string, a exit
saída será $status
antes de encerrar o script.
No entanto, se você usar the $status
como um número inteiro:
exit ( int $status ) : void
Linguagem de código: PHP ( php )
O exit
usará o $status
como status de saída e não gerará o valor. O intervalo válido para $status
é de 0 a 255. O PHP reserva o status 255. E o status 0
indica que o script foi finalizado com sucesso.
Observe que exit
não é uma função, mas uma construção de linguagem como if...else
, foreach , etc. Portanto, você não pode chamá-la usando uma função variável.
O exit
é funcionalmente equivalente a die
.
Exemplos de saída PHP
Vejamos alguns exemplos de uso da exit
construção.
1) Exemplo simples de saída PHP
O exemplo a seguir usa para exit
encerrar o script se o arquivo readme.txt
não existir:
<?php
$filename = 'readme.txt';
$f = fopen($filename, 'r');
if (!$f) {
exit('File ' . $filename . 'does not exist.');
}
// process the fie
// ...
// close the file
fclose($f);
Linguagem de código: HTML, XML ( xml )
2) Usando exit no exemplo de instrução try…catch…finally
O exemplo a seguir usa a exit
construção na try
cláusula. Nesse caso, exit
não encerra o script imediatamente. Em vez disso, o catch
bloco é executado para tratar a exceção e então o finally
bloco é executado:
<?php
try {
echo 'Execute the try block...', PHP_EOL;
throw new Exception('An error occurs');
exit(1);
} catch (\Throwable $e) {
echo $e->getMessage() , PHP_EOL;
} finally {
echo 'Execute the finally block';
}
Linguagem de código: HTML, XML ( xml )
Saída:
Execute the try block
An error occurs
Execute the finally block
Linguagem de código: JavaScript ( javascript )
3) Usando PHP exit em um exemplo de função
O exemplo a seguir define uma função que possui uma exit
construção:
<?php
function shutdown()
{
echo 'Shutting down...';
exit;
}
shutdown();
// doesn't run
echo 'After shutting down...';
Linguagem de código: PHP ( php )
Neste exemplo, a última instrução não é executada porque exit
encerra o script quando a shutdown()
função é concluída.
4) Usando PHP exit com função header()
A header()
função envia um cabeçalho HTTP bruto. Normalmente, você o usa para redirecionar o navegador para um novo URL:
header('Location: https://ww.tutorials.acervolima.com');
Linguagem de código: JavaScript ( javascript )
A header()
função deve ser chamada antes de qualquer saída real ser enviada. Em outras palavras, após chamar a header()
função, o script não deve enviar nenhuma saída. Portanto, the exit
geralmente é usado com a header()
função assim:
<?php
header("Location: https://tutorials.acervolima.com/");
exit;
?>
Linguagem de código: HTML, XML ( xml )
Resumo
- A
exit
construção gera uma mensagem e encerra o script imediatamente. - O
exit
script não será encerrado imediatamente se ele for usado em um bloco try. Ocatch
bloco será executado se ocorrer uma exceção efinally
sempre será executado. - Use
exit
withheader()
para evitar que o PHP envie saída quando o cabeçalho já foi enviado.