Memcached::delete
(PECL memcached >= 0.1.0)
Memcached::delete — Efface un élément
Description
$key
[, int $time
= 0
] )
Memcached::delete() efface l'élément représenté par la clé
key
du serveur. Le paramètre time
est la durée, en seconde (ou la date Unix) durant laquelle le client veut que
le serveur refuse les opérations add et
replace sur cette clé. Durant ce laps de temps, l'élément
est mis dans une queue d'effacement, ce qui signifie qu'il ne sera pas
possible d'utiliser la commande get, mais les commandes
add and replace avec cette clé vont
aussi échouer (la commande set va fonctionner, toutefois).
Après ce laps de temps, l'élément sera effectivement effacé du serveur. Le paramètre
time
vaut par défaut 0, ce qui signifie que l'élément
sera effacé immédiatement, et que les prochains stockages seront acceptés.
Liste de paramètres
-
key
-
La clé a effacer.
-
time
-
La durée d'effacement sur le serveur.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
La méthode Memcached::getResultCode() retourne
Memcached::RES_NOTFOUND
si la clé n'existe pas.
Exemples
Exemple #1 Exemple avec Memcached::append()
<?php $m = new Memcached(); $m->addServer('localhost', 11211); $m->delete('key1'); ?>
Voir aussi
- Memcached::deleteByKey() - Supprime un élément d'un serveur spécifique
- Memcached::deleteMulti() - Supprime plusieurs éléments