Memcached::delete

(PECL memcached >= 0.1.0)

Memcached::delete — Efface un élément

Description

public Memcached::delete(string $key, int $time = 0): bool

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::delete()

<?php
$m = new Memcached();
$m->addServer('localhost', 11211);

$m->delete('key1');
?>

Voir aussi