FUNCIONES DE APC

Funcin apc_add()
Esta funcin nos permite poner una nueva variable en el cach de almacenamiento de datos, slo si no est ya
almacenada. A diferencia de otros mecanismos de PHP, las variables almacenadas al usar apc_add() persistirn
entre peticiones hasta que el valor sea eliminado de la cach.

Requisitos
(PECL apc >= 3.0.13)

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

Parmetros
Key
Almacena la variable usando este nombre. Las claves (keys) son nicas en la cach, por lo que intentar usar
apc_add() para almacenar informacin con una clave que ya existe no sobrescribir la informacin 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. Despus 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 aadido algo a la cach, de lo contrario devuelve FALSE.
La segunda sintaxis devuelve un array con las claves de errores.
Ejemplo
<?php
$var = 'HOLA';
apc_add('key', $var);
var_dump(apc_fetch('key'));
?>
El resultado del ejemplo sera:
string(4) "HOLA"

Funcion apc_delete()
Elimina una variable almacenada de la cach

Requerimientos
(PECL apc >= 3.0.0)

Descripcin
mixed apc_delete ( string $key )

Parmetros
Key
La clave dada por key usada para almacenar el valor (con apc_store()).
Valores devueltos
Devuelve TRUE en caso de xito o FALSE en caso de error.
Ejemplo
<?php
$var = 'HOLA';
apc_store('key', $var);
apc_delete('key');
// esto es obviamente intil de esta forma
?>

Funcin apc_cache_info()
Recupera informacin que hay en cach y meta-datos del almacn de datos de APC. apc_cache_info() emitir una
advertencia si no es capaz de recuperar datos en cach de APC. Esto normalmente ocurre cuando APC no est
habilitado.

Requerimientos
(PECL apc >= 2.0.0)

Descripcin
array apc_cache_info ([ string $cache_type = "" [, bool $limited = false ]] )

Parmetros
cache_type
Si cache_type es "user", ser devuelta la informacin acerca de la cach de usuario.
Si cache_type es "filehits", ser devuelta la informacin acerca de qu ficheros han sido servidos desde la cach de
cdigo de bytes para la solicitud actual. Esta caracterstica debe ser habilitada en la compilacin usando --enablefilehits .
Si cache_type no es vlido o no se especifica, ser devuelta la informacin sobre la cach del sistema (ficheros
almacenados en cach).
limited
Si limited es TRUE, el valor devuelto excluir la lista individual de entradas de cach. Esto es til cuando se intenta
optimizar llamadas para reunin de estadsticas.
Valores devueltos
Un array de datos en cach (y metadatos) o FALSE en caso de error.

Historial de cambios

Versin
Descripcin
3.0.11 Se introdujo el parmetro limited.
3.0.16 Se introdujo la opcin "filehits" del parmetro cache_type.
Ejemplo
<?php
print_r(apc_cache_info());
?>
El resultado del ejemplo sera algo similar a:
Array
(
[num_slots] => 2000
[ttl] => 0
[num_hits] => 9
[num_misses] => 3
[start_time] => 1123958803
[cache_list] => Array
(
[0] => Array
(
[filename] => /path/to/apc_test.php
[device] => 29954
[inode] => 1130511
[type] => file
[num_hits] => 1
[mtime] => 1123960686
[creation_time] => 1123960696
[deletion_time] => 0
[access_time] => 1123962864
[ref_count] => 1
[mem_size] => 677
)
[1] => Array (...itera para cada ficheros en cach)
)

Funcion apc_clear_cache()
Limpiar la cach de usuario/sistema.

Requerimientos
(PECL apc >= 2.0.0)

Descripcin
bool apc_clear_cache ([ string $cache_type = "" ] )

Parmetros
cache_type
Si cache_type es "user", se limpiar la cach de usuario; de otro modo, se limpiar la cach del sistema (ficheros
almacenados en cach).
Valores devueltos
Siempre devuelve TRUE.

Funcin apc_define_constants()
Define un conjunto de constantes para recuperacin y definicin en masa
define() es notoriamente lenta. Ya que el principal beneficio de APC es aumentar el rendimiento de
scripts/aplicaciones, se proporciona este mecanismo para hacer ms eficiente el proceso de definicin de
constantes en masa. Sin embargo, esta funcin no lo realiza tan bien como se esperaba.
Para eliminar un conjunto de constantes almacenadas (sin limpiar la cach por completo), se puede pasar un array
vaco al parmetro constants, limpiando de manera eficaz los valores almacenados.

Requerimientos
(PECL apc >= 3.0.0)

Descripcin
bool apc_define_constants ( string $key , array $constants [, bool $case_sensitive = true ] )

Parmetros
key
key sirve como el nombre del conjunto de constantes que va a ser almacenado. key se usa para recuperar las
constantes almacenadas en apc_load_constants().
constants
Un array asociativo de pares nombre_constante => valor. nombre_constante debe seguir las reglas normales de
nominacin de constantes. valor debe evaluar un valor escalar.
case_sensitive
El comportamiento predeterminado para las constantes es ser declaradas sensibles a maysculas-minsculas; es
decir, CONSTANTE y Constante representan valores diferentes. Si este parmetro es FALSE las constantes sern
declaradas como smbolos insensibles a maysculas-minsculas.

Valores devueltos
Devuelve TRUE en caso de xito o FALSE en caso de error.
Ejemplo
<?php
$constantes = array(
'UNO' => 1,
'DOS' => 2,
'TRES' => 3,
);
apc_define_constants('nmeros', $constantes);
echo UNO, DOS, TRES;
?>

El resultado del ejemplo sera:

123