# Memcache::get

# memcache_get

(PECL memcache >= 0.2.0)

Memcache::get -- memcache_get — Récupère un élément du serveur de cache

### Description

Memcache::get(string `$key`, int `&$flags` = ?): string
Memcache::get(array `$keys`, array `&$flags` = ?): array
memcache_get(Memcache `$memcache`, string `$key`, int `&$flags` = ?): string
memcache_get(Memcache `$memcache`, array `$keys`, array `&$flags` = ?): array

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 sérialisation).

### Valeurs de retour

Retourne la valeur 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'));
?>`