(PHP 4, PHP 5, PHP 7, PHP 8)
exit — Affiche un message et termine le script courant
$status = ?): void$status): void
Termine le script courant.
Les fonctions d'extinction
et les destructeurs d'objets
seront toujours exécutés même si exit est appelé.
exit est une construction de langage et peut être
appelé sans parenthèse si aucun paramètre status
n'est passé.
status
Si status est une chaîne de caractères, cette fonction affichera
le status juste avant de sortir.
Si le paramètre status est un entier, cette valeur
pourra être utilisée comme statut de sortie et ne sera pas affichée. Le statut
de sortie peut être dans l'intervalle 0-255, le statut de sortie 255 est réservé
par PHP et ne doit pas être utilisé. Le statut 0 est utilisé pour terminer le
programme avec succès.
Aucune valeur n'est retournée.
Exemple #1 Exemple avec exit
<?php
$filename = '/path/to/data-file';
$file = fopen($filename, 'r')
or exit("Impossible d'ouvrir le fichier ($filename)");
?>
Exemple #2 Exemple avec exit et un code d'erreur
<?php
// Quitte normalement
exit;
exit();
exit(0);
// Quitte avec un code d'erreur
exit(1);
exit(0376); // octal
?>
Exemple #3 Exemple d'exécution des fonctions d'extinction et des destructeurs d'objets
<?php
class Foo
{
public function __destruct()
{
echo 'Destructeur : ' . __METHOD__ . '()' . PHP_EOL;
}
}
function shutdown()
{
echo 'Arrêt : ' . __FUNCTION__ . '()' . PHP_EOL;
}
$foo = new Foo();
register_shutdown_function('shutdown');
exit();
echo 'Ceci ne sera jamais affiché.';
?>
L'exemple ci-dessus va afficher :
Arrêt : shutdown() Destructeur : Foo::__destruct()
Note: Comme ceci est une structure du langage, et non pas une fonction, il n'est pas possible de l'appeler avec les fonctions variables ou arguments nommés.
Note:
Cette construction de langage est équivalente à die().