Almacena datos en el servidor de caché

# Memcache::set

# memcache_set

(PECL memcache >= 0.2.0)

Memcache::set -- memcache_set — Almacena datos en el servidor de caché

### Descripción

function Memcache::set(
string `$key`,
mixed `$var`,
int `$flag` = ?,
int `$expire` = ?
): bool
function 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

Esta función retorna `true` en caso de éxito o `false` si ocurre un 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

- Memcache::add() - Añade un elemento en el servidor
- Memcache::replace() - Remplaza el valor de un elemento existente

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open