apcu_store

(PECL apcu >= 4.0.0)

apcu_store Almacena una variable en la caché de datos

Descripción

apcu_store(string $key, mixed $var, int $ttl = 0): bool
apcu_store(array $values, mixed $unused = NULL, int $ttl = 0): array

Almacena una variable en la caché de datos.

Nota: A diferencia de muchos otros mecanismos en PHP, las variables almacenadas utilizando apcu_store() persistirán entre las peticiones (hasta que sus valores sean retirados de la caché).

Parámetros

key

Almacena la variable utilizando este nombre de clave. Cada clave es única en la caché, almacenar un segundo valor con el mismo parámetro key sobrescribirá el valor original.

var

La variable a almacenar.

ttl

Duración de vida; almacena la variable var en la caché durante un tiempo de ttl segundos. Después de la expiración de ttl, la variable almacenada será retirada de la caché (en la próxima petición). Si no se pasa ningún valor al parámetro ttl (o si el valor de ttl es 0), la variable persistirá hasta que sea retirada manualmente de la caché, o, de lo contrario, fallará al salir de la caché (durante un borrado, reinicio, etc.).

values

Los nombres son proporcionados por las claves del array values, las variables por los valores.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error. La segunda sintaxis devuelve un array con las claves erróneas.

Ejemplos

Ejemplo #1 Un ejemplo con apcu_store()

<?php
$bar
= 'BAR';
apcu_store('foo', $bar);
var_dump(apcu_fetch('foo'));
?>

El resultado del ejemplo sería:

string(3) "BAR"

Ver también

  • apcu_add() - Almacena en caché una nueva variable en el almacén de datos
  • apcu_fetch() - Recupera una variable almacenada en la caché
  • apcu_delete() - Elimina una variable almacenada en caché

add a note

User Contributed Notes 1 note

up
2
info at qmegas dot info
4 years ago
Be careful when updating same key with ttl set during same request. For example:
<?php
for ($i = 0; $i < 20; $i++) {
apcu_store('test', $i, 10);
sleep(1);
}
?>

After 10 seconds the key will become not available and won't be updated. Tested on Windows and Linux platforms. Not sure if it's a bug or undocumented behavior.
To Top