CLOSELOG |
Ferme le journal de bord |
PHP 4+ |
Syntaxe
Retour
Valeur |
Description |
TRUE |
Cette valeur permet d'indiquer que l'opération s'est correctement effectué ou un échec s'est produit. |
Description
Cette fonction permet de fermer la connexion du journal de bord du système.
Remarques
- Fermeture de la connexion au syslog : closelog est utilisée pour fermer la connexion au journal système après l'enregistrement de messages avec syslog.
Bien que PHP ferme automatiquement cette connexion à la fin du script, l'appeler explicitement permet de libérer les ressources immédiatement.
- Aucune valeur de retour : Contrairement à certaines fonctions PHP indiquant un succès ou un échec, closelog ne retourne rien. Il est donc impossible de
vérifier directement si la fermeture s'est bien déroulée, bien que cela ne pose généralement pas de problème dans les environnements standards.
- Utile dans les scripts de longue durée : Dans un script PHP tournant en continu (comme un service), ne pas appeler closelog peut entraîner une accumulation
de connexions ouvertes au syslog, ce qui peut consommer des ressources système inutilement. Il est donc conseillé d'appeler closelog après avoir fini d'écrire dans
les journaux de bords.
- Ne supprime pas les journaux de bord existants : closelog ferme seulement la connexion avec le système de journalisation, mais elle ne supprime ni n'efface
les journaux de bords déjà écrits. Les messages envoyés via syslog restent disponibles dans les fichiers de journaux de bord du système (souvent /var/log/syslog ou
/var/log/messages).
- Ne nécessite pas de paramètre : Contrairement à openlog, prenant plusieurs paramètres pour configurer la connexion, closelog ne nécessite aucun
paramètre. Elle ferme simplement la connexion active au syslog ouverte précédemment dans le même script.
- Fonctionnalité dépendante du système : closelog repose sur les mécanismes de journalisation du système d'exploitation sous-jacent, notamment le service syslog
sous Unix/Linux. Sur Windows, PHP utilise un équivalent
simulé pour l'enregistrement des journaux de bord, mais closelog fonctionne de manière similaire.
- Effet immédiat : Une fois closelog appelée, toute tentative d'écriture avec syslog sans rouvrir le journal avec openlog peut ne pas fonctionner
ou générer une erreur. Il est donc important de bien structurer le script pour ne pas fermer la connexion trop tôt.
- Obsolète pour certaines applications modernes : Dans les environnements modernes, où des systèmes comme monolog ou des services infonuagique de journaux de bord
(comme ELK, Papertrail ou Graylog) sont utilisés, l'utilisation directe de closelog est de moins en moins courante. Ces solutions de journalisation
gèrent généralement la fermeture des connexions de manière transparente.
Dernière mise à jour : Mercredi, le 25 mars 2015