Memcached::set

(PECL memcached >= 0.1.0)

Memcached::set — Store an item

Opis

public bool Memcached::set ( string $key , mixed $value [, int $expiration ] )

Memcached::set() stores the value on a memcache server under the specified key. The expiration parameter can be used to control when the value is considered expired.

The value can be any valid PHP type except for resources, because those cannot be represented in a serialized form. If the Memcached::OPT_COMPRESSION option is turned on, the serialized value will also be compressed before storage.

Parametry

key: Klucz określający przechowywaną wartość.
value: Wartość do przechowania.
expiration: Czas wygaśnięcia, domyślnie 0. Zobacz Czasy wygaśnięcia, aby dowiedzieć się wiecej.

Zwracane wartości

Zwraca TRUE w przypadku powodzenia, FALSE w przypadku błędu. Użyj Memcached::getResultCode(), jeśli to konieczne.

Przykłady

Przykład #1 Memcached::set() example


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

$m->set('int', 99);
$m->set('string', 'a simple string');
$m->set('array', array(11, 12));
/* expire 'object' key in 5 minutes */
$m->set('object', new stdclass, time() + 300);


var_dump($m->get('int'));
var_dump($m->get('string'));
var_dump($m->get('array'));
var_dump($m->get('object'));
?>

Powyższy przykład wyświetli coś podobnego do:

int(99)
string(15) "a simple string"
array(2) {
  [0]=>
  int(11)
  [1]=>
  int(12)
}
object(stdClass)#1 (0) {
}

Zobacz też:

Memcached::setByKey() - Store an item on a specific server
Memcached::add() - Add an item under a new key
Memcached::replace() - Replace the item under an existing key

add a note User Contributed Notes Memcached::set

miha at hribar dot info 16-Jul-2009 08:26


The method correctly returns false if you set the value to false. This means that in order to have proper fault checking mechanism in place you need to check the result code.



<?php

$Memcached = new Memcached();

$Memcached->addServer('localhost', 11211);

$Memcached->set('key', false);

var_dump($Memcached->get('key'));      // boolean false

var_dump($Memcached->getResultCode()); // int 0 which is  Memcached::RES_SUCCESS  

?>

add a note