PHP 8.6.0 Beta 3 is available for testing

Yac::set

(PECL yac >= 1.0.0)

Yac::setAlmacena un valor en la caché

Descripción

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

Almacena un valor en la caché. Si la clave ya existe, la entrada existente se sobrescribe, independientemente de si ha expirado.

Parámetros

key

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

value

El valor que almacenar. Se puede almacenar 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 error.

Ejemplos

Ejemplo #1 Ejemplo de Yac::set()

<?php
$yac = new Yac();

$yac->set("foo", "bar");                    // almacena un único valor
$yac->set("foo", "baz");                    // sobrescribe la entrada existente
?>

Ejemplo #2 Almacenar una entrada con un TTL

<?php
$yac = new Yac();

// ttl en segundos: la entrada expira transcurridos 5 segundos
$yac->set("short-lived", "value", 5);
sleep(6);
var_dump($yac->get("short-lived"));        // bool(false): ha expirado
?>

Ejemplo #3 Almacenar varias entradas en una sola llamada

<?php
$yac = new Yac();

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

Véase también

  • Yac::add() - Almacena un valor sin sobrescribir uno existente
  • Yac::get() - Recupera valores de la caché
  • Yac::__set() - Almacena un valor utilizando la sintaxis de propiedades

add a note

User Contributed Notes

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