exit

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

exit — Mostra 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

Example #1 Exemplo de exit

<?php

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

?>

Example #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

?>

Example #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

Note: 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.

Note:

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

Veja Também