APC_FETCH |
Demande dans l'APC |
PHP 5.0 à PHP 5.4 |
Extension APC 3.0.0+ |
Syntaxe
function apc_fetch( $key);
|
function apc_fetch( $key, $success );
|
Paramètres
Nom |
Description |
$key |
Ce paramètre permet d'indiquer la variable à rechercher à l'aide de son nom. |
$success |
Ce paramètre permet d'indiquer si l'opération c'est bien passé (TRUE) ou non (FALSE). |
Retour
Valeur |
Description |
variable |
Ces valeurs correspondent à la valeur entreposé dans la cache du magasin. |
Description
Cette fonction permet de demander une variable contenu dans le cache du magasin de données.
Remarques
- ATTENTION ! Le paramètre «$success» est uniquement disponible à partir de la version 3.0.17 d'APC.
- Si vous recevez une erreur «Fatal error: Call to undefined function apc_fetch», c'est que le module n'est pas installé au activé avec le PHP.
Par exemple, sous le système d'exploitation Linux, vous devriez essayer les commandes suivantes :
- Par contre, si vous recevez l'erreur :
Fatal error: Call to undefined function apc_fetch
|
à la suite d'une mise à jour de WordPress par exemple, vous devriez plutôt redémarrer le serveur Web.
- L'utilisation d'un cache pour accélérer le traitement des pages Web est une bonne chose, cependant, il ne faut pas oublier
que c'est approche peut jouer des mauvais tours : des sections de sites ne se mettant pas à jour, des régressions non prises en compte,...
Dans cette situation, il faudra vider le cache ou redémarrer le serveur Web, lors de vos déploiements.
- Récupération de valeurs entreposées dans le cache APC : La fonction apc_fetch permet de récupérer des valeurs précédemment entreposées dans
le cache APC. Cela est particulièrement utile lorsque tu veux accéder rapidement à des données fréquemment utilisées sans avoir à recalculer ou recharger ces données
depuis une base de données ou un autre stockage externe.
- Retourne false en cas d'échec : Si la clef spécifiée n'existe pas dans le cache, ou si une erreur survient lors de la récupération des données,
apc_fetch renvoie false. Il est donc important de vérifier ce retour pour s'assurer que la donnée souhaitée a bien été récupérée et que le cache contient
l'information attendue.
- Optimisation des performances : L'utilisation de apc_fetch peut considérablement améliorer les performances d'une application PHP, car
elle permet d'éviter des opérations coûteuses comme des lectures répétées depuis la base de données ou des calculs complexes. En stockant les résultats de ces opérations dans le
cache, tu réduis la charge sur le serveur et accélères la réponse aux requêtes suivantes.
- Prise en charge de plusieurs valeurs à la fois : apc_fetch permet de récupérer plusieurs valeurs simultanément en passant un tableau de clefs.
Cela peut être particulièrement utile si tu as besoin de récupérer plusieurs valeurs du cache en une seule opération, ce qui réduit les appels au cache et améliore l'efficacité
du processus.
- Cache limité à la durée de vie d'APC : Les valeurs récupérées avec apc_fetch sont entreposées dans le cache tant que l'extension APC reste
active. Toutefois, si le cache APC est vidé, les données seront perdues. Il est donc important de prendre en compte que les données entreposées dans APC ne sont pas
persistantes à long terme, mais dépendent de la gestion du cache.
- Utilisation avec un dépassement de délai pour récupérer des valeurs : Un paramètre optionnel de apc_fetch permet de spécifier un dépassement de délai
déterminant combien de temps PHP attendra pour récupérer les données avant de revenir à un état d'erreur ou de non-disponibilité. Cela peut être utile pour gérer les cas où le cache
pourrait être temporairement inaccessible ou en maintenance.
- Vérification de l'existence de la clef avec un second paramètre : En plus de la valeur retournée, apc_fetch peut également prendre un deuxième
paramètre permettant de vérifier si une valeur est présente dans le cache. Si ce paramètre est passé, une variable booléenne sera remplie avec la valeur true si la donnée est
trouvée dans le cache, et false si elle ne l'est pas.
- Dépendance à l'extension APC : Pour utiliser apc_fetch, l'extension APC doit être installée et configurée sur le serveur PHP. Sans
cette extension, la fonction ne sera pas disponible et le code peut entraîner des erreurs. Il est donc essentiel de s'assurer que l'environnement dispose de l'extension APC
avant de tenter d'utiliser cette fonction.
Dernière mise à jour : Dimanche, le 22 mars 2015