apc_add

(PECL apc >= 3.0.13)

apc_add — Poner una 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 [, int $ttl = 0 ]] )

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

Note: 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 en caso de éxito o FALSE en caso de error. La segunda sintaxis devuelve un array con las claves de errores.

Ejemplos

Example #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é

add a note User Contributed Notes apc_add

There are no user contributed notes for this page.