ApplicationPathCacheClear

Syntaxe

Description

Cette fonction permet de vider le cache des chemins pour les fichiers application.cfc ou application.cfm, assurant que les modifications récentes soient prises en compte immédiatement.

Remarques

• La fonction ApplicationPathCacheClear() permet de vider le cache des chemins utilisés pour localiser les fichiers Application.cfc ou Application.cfm. Cela garantit que toutes les modifications récentes apportées à ces fichiers sont prises en compte immédiatement, sans attendre l'expiration du cache par défaut.
• Le cache de chemins améliore les performances de Lucee en évitant de rechercher à chaque requête le fichier Application.cfc approprié sur le système de fichiers. Cette optimisation est particulièrement utile pour les applications avec une grande arborescence de fichiers, réduisant ainsi la charge du serveur et le temps de réponse.
• Par défaut, le cache des chemins est configuré avec un dépassement de délai de 20 secondes (20000 ms). ApplicationPathCacheClear() permet de forcer le vidage immédiat du cache, ce qui est utile lors du déploiement de nouvelles versions d'une application ou après des modifications structurelles importantes.
• Cette fonction ne prend aucun paramètre, ce qui simplifie son utilisation. Elle est conçue pour être appelée ponctuellement, par exemple dans un script d'administration ou dans un processus de déploiement automatisé, pour garantir que la prochaine requête utilisera les chemins et configurations les plus récents.
• L'activation ou la configuration du cache des chemins peut être ajustée via la propriété système lucee.application.path.cache.timeout ou la variable d'environnement LUCEE_APPLICATION_PATH_CACHE_TIMEOUT. Cela permet de personnaliser le comportement du cache en fonction des besoins spécifiques de l'application, tout en conservant la possibilité d'un vidage manuel.
• ApplicationPathCacheClear() est particulièrement utile dans les environnements de développement ou de staging, où les fichiers Application.cfc peuvent être modifiés fréquemment. Elle permet aux développeurs de tester leurs changements sans devoir attendre que le cache expire automatiquement.
• L'usage de cette fonction contribue à la stabilité et à la prévisibilité des applications. En s'assurant que le cache est vidé au moment approprié, on évite les incohérences où une requête pourrait utiliser une ancienne version du fichier Application.cfc, ce qui pourrait provoquer des comportements inattendus.
• Enfin, ApplicationPathCacheClear() fait partie des fonctions d'optimisation avancées introduites dans Lucee 5.3.8.149. Elle illustre comment Lucee offre un contrôle fin sur le comportement interne du serveur pour la gestion des chemins et la performance, tout en permettant un ajustement précis dans des scénarios complexes de déploiement ou de développement continu.