APC_ADD |
Ajout d'APC |
PHP 5.0 à PHP 5.4 |
Extension APC 3.0.13+ |
Syntaxe
function apc_add($key, $var);
|
function apc_add($key, $var, $ttl);
|
Paramètres
Nom |
Description |
$key |
Ce paramètre permet d'indiquer une variable entreposer à l'aide de son nom. |
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 d'ajouter une variable au cache du magasin de données.
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.
- Ajoute une entrée dans le cache APC si elle n'existe pas déjà : La fonction apc_add est utilisée pour ajouter une entrée dans le cache APC
(Alternative PHP Cache) seulement si la clef spécifiée n'existe pas déjà dans le cache. Si la clef existe déjà, la fonction retourne false et n'affiche aucune
modification. Cela permet d'éviter de réécrire des données déjà présentes, optimisant ainsi la gestion du cache.
- Utilisation dans la gestion des caches d'applications PHP : apc_add est particulièrement utile dans les applications PHP où le cache des résultats
de calculs lourds ou de requêtes fréquentes est nécessaire. Plutôt que de recalculer ces résultats à chaque demande, les stocker dans le cache permet d'accélérer considérablement
la performance de l'application en réduisant la charge serveur.
- Entrepose les données en mémoire partagée : APC entrepose les données en mémoire partagée, ce qui signifie qu'elles sont accessibles par tous les processus
PHP en cours d'exécution. Cela offre une manière très rapide d'accéder à des informations étant utilisées fréquemment et ne changeant pas souvent, comme les paramètres
de configuration ou les résultats de requêtes de base de données.
- Retourne true en cas d'ajout réussi : Lorsque apc_add parvient à ajouter les données dans le cache, elle retourne true. Cela indique que l'entrée
a bien été ajoutée. En revanche, si la clef existe déjà ou si l'ajout échoue pour une autre raison (par exemple, une limite de mémoire du cache), la fonction retourne
false.
- Limitations de taille des données mises en cache : Bien que apc_add soit pratique pour stocker des données en cache, il existe des limitations quant à la
taille des données pouvant être entreposées dans le cache. Les données trop volumineuses risquent de ne pas être ajoutées, en particulier si la configuration du cache a une
limite de mémoire stricte ou si la clef dépasse une taille maximale.
- Permet d'éviter les collisions dans le cache : Comme apc_add n'ajoute la donnée au cache que si la clé n'existe pas déjà, elle aide à éviter les collisions
de cache où différentes parties de l'application écrivent sur la même entrée. Cela est particulièrement important dans les environnements de production où plusieurs processus
PHP peuvent accéder au même cache.
- Besoin d'un module APC installé et activé : Pour utiliser apc_add, le module APC doit être installé et activé sur le serveur. APC est une
extension de cache PHP nécessitant une installation manuelle sur certains systèmes. Si ce module n'est pas installé, l'appel à la fonction échouera, et des alternatives
comme OPcache ou Memcached peuvent être envisagées.
- Peut être utilisé pour le cache d'objets et de résultats : Cette fonction est couramment utilisée pour mettre en cache des objets ou des résultats complexes étant
coûteux à calculer. Par exemple, elle peut être utilisée pour mémoriser les résultats de requêtes de bases de données ou les résultats d'algorithmes complexes. Cela permet de
réduire la charge des systèmes et d'améliorer la réactivité des applications.
Dernière mise à jour : Dimanche, le 22 mars 2015