Saída PHP

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 exitconstrução gera uma mensagem e encerra imediatamente a execução do script atual.

Aqui está a sintaxe da exitconstrução:

exit ( string $status = ? ) : voidLinguagem de código:  PHP  ( php )

Se você usar the $statuscomo uma string, a exitsaída será $statusantes de encerrar o script.

No entanto, se você usar the $statuscomo um número inteiro:

exit ( int $status ) : voidLinguagem de código:  PHP  ( php )

O exitusará o $statuscomo 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 0indica que o script foi finalizado com sucesso.

Observe que exitnã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 exitconstrução.

1) Exemplo simples de saída PHP

O exemplo a seguir usa para exitencerrar o script se o arquivo readme.txtnã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 exitconstrução na trycláusula. Nesse caso, exitnão encerra o script imediatamente. Em vez disso, o catchbloco é executado para tratar a exceção e então o finallybloco é 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 blockLinguagem 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 exitconstruçã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 exitencerra 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 exitgeralmente é usado com a header()função assim:

<?php
header("Location: https://tutorials.acervolima.com/");

exit;
?>Linguagem de código:  HTML, XML  ( xml )

Resumo

• A exitconstrução gera uma mensagem e encerra o script imediatamente.
• O exitscript não será encerrado imediatamente se ele for usado em um bloco try. O catchbloco será executado se ocorrer uma exceção e finallysempre será executado.
• Use exitwith header()para evitar que o PHP envie saída quando o cabeçalho já foi enviado.