apc_add

(PECL apc >= 3.0.13)

apc_add — Poner una nueva variable en caché en el almacén de datos

Descripción

bool apc_add ( string $key , mixed $var [, int $ttl = 0 ] )
array apc_add ( array $values [, mixed $unused = NULL [, int $ttl = 0 ]] )

Pone una variable en caché en el almacén de datos, sólo si no está ya almacenada.

Nota: A diferencia de otros mecanismos de PHP, las variables almacenadas al usar apc_add() persistirán entre peticiones (hasta que el valor sea eliminado de la caché).

Parámetros

key

Almacena la variable usando este nombre. Las claves (keys) son únicas en la caché, por lo que intentar usar apc_add() para almacenar información con una clave que ya existe no sobrescribirá la información existente, en su lugar devolverá FALSE. (Esta es la única diferencia entre apc_add() y apc_store().)

var

La variable a almacenar

ttl

Time To Live (Tiempo de Vida); almacena var en la caché durante ttl segundos. Después de que pase ttl, la variable almacenada será expurgada de la caché (en la siguiente solicitud). Si no se proporciona ttl (o si ttl es 0), el valor persistirá hasta que sea eliminado de la caché manualmente, o si no dejará de existir (al limpiar, reiniciar, etc.).

values

Nombres en clave, variables en valor.

Valores devueltos

Devuelve TRUE si realmente se ha añadido algo a la caché, de lo contrario devuelve FALSE. La segunda sintaxis devuelve un array con las claves de errores.

Ejemplos

Ejemplo #1 Un ejemplo de apc_add()

<?php
$bar = 'BAR';
apc_add('foo', $bar);
var_dump(apc_fetch('foo'));
echo "\n";
$bar = 'NUNCA SE ESTABLECE';
apc_add('foo', $bar);
var_dump(apc_fetch('foo'));
echo "\n";
?>

El resultado del ejemplo sería:

string(3) "BAR"
string(3) "BAR"

Ver también

  • apc_store() - Guardar una variable en caché en el almacén de datos
  • apc_fetch() - Traer una variable almacenada desde la caché
  • apc_delete() - Elimina una variable almacenada de la caché