Memcached::getByKey

(PECL memcached >= 0.1.0)

Memcached::getByKey — Lit un élément sur un serveur spécifique

Description

public Memcached::getByKey(
    string $server_key,
    string $key,
    callable $cache_cb = ?,
    int $flags = ?
): mixed

Memcached::getByKey() est fonctionnellement équivalente à Memcached::get(), hormis le fait que la variable libre server_key peut être utilisée pour diriger la clé key sur un serveur spécifique.

Liste de paramètres

server_key

La clé d'identification du serveur de stockage ou de récupération. Au lieu de hacher avec la clé courante pour l'élément, nous hachons avec la clé serveur lorsqu'il est décidé avec quel serveur memcache il convient de dialoguer. Ceci permet le regroupement des éléments correspondants sur un seul serveur permettant de meilleures performances lors d'opérations multiples.

key

La clé de l'élément à lire.

cache_cb

Fonction de rappel en cas d'absence, ou null

flags

Drapeaux pour contrôler le résultat retourné. Quand Memcached::GET_EXTENDED est fournit, la fonction retournera aussi le jeton CAS.

Valeurs de retour

Retourne la valeur stockée dans le cache, ou false sinon. La méthode Memcached::getResultCode() retourne Memcached::RES_NOTFOUND si la clé n'existe pas.

Historique

Version Description
PECL memcached 3.0.0 Le paramètre &cas_tokens a été supprimé. Memcached::GET_EXTENDED a été ajoutée et quand passé en tant que drapeau il s'assure que les jetons CAS sont récupérés.

Voir aussi