Fonctions diverses
PHP Manual

exit

(PHP 4, PHP 5)

exitAffiche 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


Fonctions diverses
PHP Manual