register_shutdown_function
(PHP 4, PHP 5, PHP 7)
register_shutdown_function — Enregistre une fonction de rappel pour exécution à l'extinction
Description
Enregistre une fonction de rappel callback
pour exécution à l'extinction ou lorsque
exit() est appelé.
Plusieurs appels à register_shutdown_function() sont possibles dans le même script, et les fonctions seront appelées dans le même ordre que celui dans lequel elles sont enregistrées. Si vous appelez exit() durant l'une des fonctions d'extinction, le processus sera définitivement arrêté, sans que les autres fonctions soient appelées.
Liste de paramètres
-
callback -
La fonction de rappel à enregistrer.
La fonction de rappel est exécuté comme faisant parti de la requête, aussi, il est possible d'envoyer quelque à la sortie depuis cette dernière, puis d'accéder aux buffers de sortie.
-
parameter -
Il est possible de passer des paramètres aux fonctions d'extinction en configurant ces paramètres supplémentaires.
-
... -
Erreurs / Exceptions
Si la fonction de rappel ne peut être appelée pour diverses raisons, une
alerte de niveau E_WARNING sera émise.
Exemples
Exemple #1 Exemple avec register_shutdown_function()
<?php
function shutdown()
{
// Voici notre fonction shutdown
// dans laquelle nous pouvons faire
// toutes les dernières opérations
// avant la fin du script.
echo 'Script exécuté avec succès', PHP_EOL;
}
register_shutdown_function('shutdown');
?>
Notes
Note:
Le dossier de travail du script peut changer dans la fonction d'extinction sous quelques serveurs web, e.g. Apache.
Note:
Les fonctions d'extinction ne seront pas exécutées si le processus est tué avec un signal SIGTERM ou SIGKILL. Bien que vous ne pouvez pas intercepter un SIGKILL, vous pouvez utiliser la fonction pcntl_signal() pour installer un gestionnaire pour un SIGTERM qui utilisera la fonction exit() pour mettre fin proprement.
Voir aussi
- auto_append_file
- exit() - Affiche un message et termine le script courant
- La section sur la gestion des connexions
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.register-shutdown-function.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
