FUNCIONES DE APC

Función apc_add()

Esta función nos permite poner una nueva variable en el caché de almacenamiento de datos, sólo si no está ya almacenada. 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é.

Requisitos(PECL apc >= 3.0.13)

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

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.

Ejemplo

<?php$var = 'HOLA';apc_add('key', $var);var_dump(apc_fetch('key'));?>

El resultado del ejemplo sería:

string(4) "HOLA"

Funcion apc_delete()

Elimina una variable almacenada de la caché

Requerimientos

(PECL apc >= 3.0.0)

Descripción

mixed apc_delete ( string $key )

Parámetros

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 inútil de esta forma?>

Función apc_cache_info()

Recupera información que hay en caché y meta-datos del almacén 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)

Descripción

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

Parámetros

cache_type

Si cache_type es "user", será devuelta la información acerca de la caché de usuario.

Si cache_type es "filehits", será devuelta la información acerca de qué ficheros han sido servidos desde la caché de código de bytes para la solicitud actual. Esta característica debe ser habilitada en la compilación usando --enable-filehits .

Si cache_type no es válido o no se especifica, será devuelta la información 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 reunión de estadísticas.

Valores devueltos

Un array de datos en caché (y metadatos) o FALSE en caso de error.

Historial de cambios

Versión Descripción3.0.11 Se introdujo el parámetro limited.3.0.16 Se introdujo la opción "filehits" del parámetro cache_type.

Ejemplo

<?phpprint_r(apc_cache_info());?>

El resultado del ejemplo sería 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)

Descripción

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

Parámetros

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.

Función apc_define_constants()

Define un conjunto de constantes para recuperación y definición 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 más eficiente el proceso de definición de constantes en masa. Sin embargo, esta función 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 vacío al parámetro constants, limpiando de manera eficaz los valores almacenados.

Requerimientos

(PECL apc >= 3.0.0)

Descripción

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

Parámetros

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 nominación de constantes. valor debe evaluar un valor escalar.

case_sensitive

El comportamiento predeterminado para las constantes es ser declaradas sensibles a mayúsculas-minúsculas; es decir, CONSTANTE y Constante representan valores diferentes. Si este parámetro es FALSE las constantes serán declaradas como símbolos insensibles a mayúsculas-minúsculas.

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('números', $constantes);echo UNO, DOS, TRES;?>

El resultado del ejemplo sería:

123