APC_STORE |
Entreposer dans l'APC |
PHP 5.0 à PHP 5.4 |
Extension APC 3.0.0+ |
Syntaxe
function apc_store( $key, $var );
|
function apc_store( $key, $var, $ttl );
|
Paramètres
Nom |
Description |
$key |
Ce paramètre permet d'indiquer une variable à entreposer à l'aide de son nom. |
$var |
Ce paramètre permet d'indiquer une variable à entreposer. |
$ttl |
Ce paramètre permet d'indiquer la durée de vie en secondes. |
Retour
Valeur |
Description |
FALSE |
Cette valeur permet d'indiquer qu'un problème est survenu. |
TRUE |
Cette valeur permet d'indiquer que tous c'est bien passé. |
Description
Cette fonction permet de mettre dans le cache du magasin de données une variable spécifié.
Remarques
- 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.
- Fonctionnalité principale : La fonction apc_store permet d'entreposer des données dans le cache utilisateur fourni par APC. Elle est utilisée
pour mettre en cache des valeurs fréquemment utilisées, ce qui réduit les temps d'accès aux données en les conservant en mémoire partagée.
- Différence avec apc_add : Contrairement à apc_add, échouant si une clef existe déjà dans le cache, apc_store écrase la valeur existante
si la clef est déjà présente. Cela en fait une fonction plus flexible pour mettre à jour des données en cache.
- Types de données pris en charge : Elle permet d'entreposer des types de données scalaires (comme des chaînes de caractères, des entiers ou des booléens) ainsi
que des structures plus complexes comme des tableaux ou des objets. Cependant, les objets doivent être sérialisables pour être entreposés correctement.
- Expiration des données : La fonction permet de définir un délai d'expiration (en secondes) pour chaque entrée. Une fois ce délai dépassé, les données sont
automatiquement supprimées du cache, ce qui est pratique pour gérer les données temporaires.
- Entreposage en masse : apc_store prend en charge l'entreposage de plusieurs paires clef/valeur en une seule opération si un tableau associatif est
passé en paramètre. Cela permet d'améliorer les performances en réduisant le nombre d'appels à la fonction.
- Retour de la fonction : En cas de succès, apc_store retourne true. Si une erreur se produit (par exemple, si la mémoire partagée est pleine), la
fonction retourne false. Lors du stockage en masse, elle retourne un tableau contenant les clefs n'ayant pas pu être enregistrées.
- Obsolescence d'APC : Bien que cette fonction soit utile, elle est liée à l'extension APC, étant obsolète depuis PHP 7.0. Dans les environnements
modernes, il est recommandé d'utiliser APCu pour les caches utilisateur, car apc_store n'est plus disponible dans les versions récentes de PHP.
- Cas d'utilisation pratique : apc_store est souvent utilisé pour mettre en cache des résultats de calculs lourds, des requêtes de base de données, ou
des fichiers de configuration, ce qui améliore la vitesse des applications. Cependant, il est essentiel de surveiller la taille de la mémoire cache disponible pour éviter des
dépassements.
Dernière mise à jour : Dimanche, le 20 avril 2014