exit

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

exitMostra uma mensagem e termina o script atual

Descrição

exit(string$status = ?): void
exit(int$status): void

Termina a execução do script. Funções de desligamento e destruidores de objeto sempre serão executados mesmo que exit seja chamada.

exit é uma construção de linguagem e pode ser chamada sem parênteses se status não foi informado.

Parâmetros

status

Se status for uma string, a função mostra status logo antes de sair.

Se status for um int, este valor será usado como o estado da saída e não será mostrado Estados de saída devem estar no intervalo de 0 a 254, o estado de saída 255 é reservado pelo PHP e não deve ser usado. O estado 0 é usado para terminar o programa com sucesso.

Valor Retornado

Nenhum valor é retornado.

Exemplos

Exemplo #1 Exemplo de exit

<?php

$filename
= '/path/to/data-file';
$file = fopen($filename, 'r')
or exit(
"unable to open file ($filename)");

?>

Exemplo #2 Exemplo de exit com estado de saída

<?php

//sai do programa normalmente
exit;
exit();
exit(
0);

//sai com código de erro
exit(1);
exit(
0376); //octal

?>

Exemplo #3 Desligamento de funções e destruidores de objeto são executados independentemente

<?php
class Foo
{
public function
__destruct()
{
echo
'Destruidor: ' . __METHOD__ . '()' . PHP_EOL;
}
}

function
shutdown()
{
echo
'Desligamento: ' . __FUNCTION__ . '()' . PHP_EOL;
}

$foo = new Foo();
register_shutdown_function('shutdown');

exit();
echo
'Este texto não será mostrado.';
?>

O exemplo acima produzirá:

Desligamento: shutdown() Destruidor: Foo::__destruct()

Notas

Nota: Como esta é uma construção da linguagem e não uma função, ela não pode ser chamada usando funções variáveis ou argumentos nomeados.

Nota:

Esta construção de linguagem é equivalente a die().

Veja Também

To Top