(PECL apc >= 3.0.13)
apc_add — Poner una nueva variable en caché en el almacén de datos
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é).
key
Almacena la variable usando este nombre. Las claves (key
s) 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.
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.
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"