Yac::add

(PECL yac >= 1.0.0)

Yac::addAlmacena un valor sin sobrescribir uno existente

Descripción

public function Yac::add(string|array $key, mixed $value, int $ttl = 0): bool
public function Yac::add(array $values, int $ttl = 0): bool

Almacena un valor en la caché. A diferencia de Yac::set(), no sobrescribe una entrada existente que siga siendo válida; en ese caso el almacenamiento es rechazado.

Parámetros

key

Una clave de tipo string, o un array de pares clave => valor que se almacenan en una sola llamada.

value

El valor a almacenar. Puede almacenarse cualquier tipo de PHP excepto resource. Solo se utiliza en la forma de clave única; cuando key es un array, este argumento es en su lugar el parámetro opcional ttl.

ttl

Tiempo de vida en segundos. 0 significa que la entrada nunca expira por tiempo.

Valores devueltos

Devuelve true en caso de éxito, false en caso de fallo. El almacenamiento también es rechazado (devolviendo false) cuando la clave ya existe y no ha expirado.

Ejemplos

Ejemplo #1 Ejemplo de Yac::add()

<?php
$yac = new Yac();

var_dump($yac->add("foo", "bar"));          // bool(true)
var_dump($yac->add("foo", "baz"));          // bool(false): "foo" ya existe
?>

Ejemplo #2 Añadir una entrada con un TTL

<?php
$yac = new Yac();

// ttl en segundos; 0 (el valor predeterminado) significa que la entrada nunca expira
$yac->add("short-lived", "value", 5);
sleep(6);
var_dump($yac->get("short-lived"));        // bool(false): expirado
?>

Ejemplo #3 Añadir varias entradas en una sola llamada

<?php
$yac = new Yac();

// almacena varios pares clave => valor en una sola llamada, con un ttl
$yac->add(array("a" => 1, "b" => 2), 60);
?>

Véase también

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top