Memcache::set

memcache_set

(PECL memcache >= 0.2.0)

Memcache::set -- memcache_setAlmacena datos en el servidor de caché

Descripción

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

Memcache::set() almacena el elemento var con la clave key en el servidor de caché. El parámetro expire representa el tiempo de expiración en segundos del elemento. Si vale 0, el elemento no expirará nunca (aunque el servidor de caché no garantiza que este elemento siempre estará almacenado, puede ser eliminado de la caché para hacer espacio para otros elementos). Puede utilizarse la constante MEMCACHE_COMPRESSED como valor del parámetro flag si se desea utilizar la compresión en tiempo real (utilizando la biblioteca zlib).

Nota:

Tenga en cuenta que los recursos (es decir, identificadores de archivos o conexiones) no pueden almacenarse en la caché, ya que no pueden ser representados linealmente.

Parámetros

key

La clave que se asociará con el elemento.

var

La variable a registrar. Los strings y los integers se registran como tales, los demás tipos se registran de manera serializada.

flag

Utilice MEMCACHE_COMPRESSED para registrar el elemento comprimido (utiliza zlib).

expire

Tiempo de expiración para el elemento. Si es igual a 0, el elemento no expirará. También puede utilizarse un timestamp Unix o un número de segundos a partir de la fecha actual, pero en este último caso, el número de segundos no debe exceder 2592000 (30 días).

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo con Memcache::set()

<?php
/* API procedimental */

/* conexión al servidor de caché */
$memcache_obj = memcache_connect('memcache_host', 11211);

/*
define el valor del elemento identificado por la clave 'var_key' ;
utilización del valor 0 para el flag ;
la compresión no se utiliza ;
el tiempo de expiración es de 30 segundos
*/
memcache_set($memcache_obj, 'var_key', 'algunas variables', 0, 30);

echo
memcache_get($memcache_obj, 'var_key');

?>

Ejemplo #2 Ejemplo con Memcache::set()

<?php
/* API orientada a objetos */

$memcache_obj = new Memcache;

/* conexión al servidor de caché */
$memcache_obj->connect('memcache_host', 11211);

/*
define el valor del elemento identificado por la clave 'var_key' ;
utilización de la compresión en tiempo real ;
el tiempo de expiración es de 50 segundos
*/
$memcache_obj->set('var_key', 'algunas variables grandes', MEMCACHE_COMPRESSED, 50);

echo
$memcache_obj->get('var_key');

?>

Ver también