exit

(PHP 4, PHP 5)

exit — Affiche un message et termine le script courant

Description

void exit ([ string $status ] )

void exit ( int $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é.

Liste de paramètres

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.

Valeurs de retour

Aucune valeur n'est retournée.

Exemples

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()

Notes

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().

Voir aussi

register_shutdown_function() - Enregistre une fonction de rappel pour exécution à l'extinction