Memcache::get
(PECL memcache >= 0.2.0)
Memcache::get — Récupère un élément du serveur de cache
Description
$key
[, int &$flags
] )$keys
[, array &$flags
] )
Memcache::get() retourne les données précédemment stockées
dans l'élément identifié par la clé key
s'il existe sur
le serveur au moment de l'appel.
Vous pouvez passer un tableau de clés à la fonction Memcache::get() pour obtenir un tableau de valeurs. Le tableau résultant contiendra seulement les paires de clé-valeur trouvées.
Liste de paramètres
-
key
-
La clé ou le tableau de clés à récupérer.
-
flags
-
Si ce paramètre est présent, il représentera les drapeaux des valeurs à récupérer. Ces drapeaux sont les mêmes que ceux donnés en exemple de la fonction Memcache::set(). L'octet le plus faible de la valeur est réservé à un usage interne de pecl/memcache (e.g. pour indiquer le statut de compression et de linéarisation).
Valeurs de retour
Retourne une chaîne de caractères associée avec le paramètre key
ou un tableau contenant les paires clé/valeur trouvées lorsque le paramètre
key
est un tableau. Retourne FALSE
si une erreur
survient, si le paramètre key
n'est pas trouvé,
ou si le paramètre key
est un tableau vide.
Exemples
Exemple #1 Exemple avec Memcache::get()
<?php /* API procédurale */ $memcache_obj = memcache_connect('memcache_host', 11211); $var = memcache_get($memcache_obj, 'some_key'); /* API orientée objet */ $memcache_obj = new Memcache; $memcache_obj->connect('memcache_host', 11211); $var = $memcache_obj->get('some_key'); /* Vous pouvez également utiliser un tableau de clés en tant que paramètre. Si un tel élément n'est pas trouvé sur le serveur, le tableau résultat ne comprendra simplement pas une telle clé. */ /* API procédurale */ $memcache_obj = memcache_connect('memcache_host', 11211); $var = memcache_get($memcache_obj, Array('some_key', 'another_key')); /* API Orientée Objet */ $memcache_obj = new Memcache; $memcache_obj->connect('memcache_host', 11211); $var = $memcache_obj->get(Array('some_key', 'second_key')); ?>