(PHP 4, PHP 5)
exit — Affiche un message et termine le script courant
$status
] )$status
)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.
Note: PHP >= 4.2.0 n'affiche pas le message
status
si c'est un entier entier.
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.
Note:
Cette construction de langage est équivalente à die().