Memcached::set

(PECL memcached >= 0.1.0)

Memcached::set — Guarda un ítem

Descripción

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

Memcached::set() guarda el valor del value en un servidor memcache bajo la key especificada. El parámetro de expiration puede ser usado para controlar cuando se se considera expirar su valor.

El valor puede ser cualquier tipo de PHP válido excepto recursos, ya que dichos no se pueden representar en forma serializada. Si la opción Memcached::OPT_COMPRESSION está activada, el valor serializado será además comprimido antes de ser guardado.

Parámetros

key: La claven en donde se guardará el valor.
value: El valor a guardar.
expiration: Tiempo de expiración, por defecto definido a 0. VeaTiempos de Expiración para más info info.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error. Use Memcached::getResultCode() si es necesario.

Ejemplos

Ejemplo #1 Ejemplo de Memcached::set()


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

$m->set('int', 99);
$m->set('string', 'una cadena sencilla');
$m->set('array', array(11, 12));
/* expirará la clave 'object' en 5 minutos */
$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'));
?>

El resultado del ejemplo sería algo similar a:

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

Ver también

Memcached::setByKey() - Guardar un ítem en un servidor específico
Memcached::add() - Añade un nuevo ítem asociado a una nueva clave
Memcached::replace() - Reemplaza un ítem bajo una clave ya existente

add a note User Contributed Notes Memcached::set - [1 notes]

down

miha at hribar dot info ¶

3 years ago


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