Memcache::add

memcache_add

(PECL memcache >= 0.2.0)

Memcache::add -- memcache_add — Ajoute un élément dans le serveur

Description

function Memcache::add(
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool

function memcache_add(
    Memcache $memcache,
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool

Memcache::add() stocke la variable var avec la clé key seulement si cette clé n'existe pas déjà dans le serveur.

Liste de paramètres

key: La clé à associer à l'élément.
var: La variable à stocker. Les chaines et les entiers sont stockés tels quels, les autres types sont sérialisés.
flag: Utiliser MEMCACHE_COMPRESSED pour compresser l'élément (utilise zlib).
expire: Temps d'expiration de l'élément. Si égal à zéro, l'élément n'expirera jamais. Il est également possible d'utiliser un timestamp Unix ou un nombre de secondes partant du temps actuel, mais dans ce cas le nombre de secondes ne doit pas excéder 2592000 (30 jours).

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient. Retourne false si la clé existe déjà. Pour le reste, le comportement de Memcache::add() est le même que Memcache::set().

Exemples

Exemple #1 Exemple avec Memcache::add()

<?php

$memcache_obj = memcache_connect("localhost", 11211);

/* procedural API */
memcache_add($memcache_obj, 'var_key', 'test variable', false, 30);

/* OO API */
$memcache_obj->add('var_key', 'test variable', false, 30);

?>

Voir aussi

Memcache::set() - Stocke des données dans le serveur de cache
Memcache::replace() - Remplace une valeur d'un élément existant