# wincache_ucache_info

(PECL wincache >= 1.1.0)

wincache_ucache_info — Recupera información sobre los datos almacenados en la caché del usuario

### Descripción

wincache_ucache_info(bool `$summaryonly` = `false`, string `$key` = NULL): array|false

Recupera información sobre los datos almacenados en la caché del usuario.

### Parámetros

`summaryonly`

  Controla si el array devuelto contiene información sobre las entradas de caché individuales junto con el resumen caché del usuario.

`key`

  La clave de una entrada en la caché del usuario. Si se especifica a continuación, el array devuelto contendrá información sólo acerca de que la entrada de caché. Si no se especifica y `summaryonly` es establecido a `false` entonces el array devuelto contendrá información sobre todas las entradas en la caché.

### Valores devueltos

Array de metadatos sobre caché de usuario o `false` en caso de error

El array devuelto por esta función contiene los siguientes elementos:

- `total_cache_uptime` - tiempo total en segundos que el caché de usuario ha sido activo
- `total_item_count` - número total de elementos que están actualmente en la caché del usuario
- `is_local_cache` - true si el caché es de metadatos para una instancia de caché local, false si los metadatos es para el la caché global
- `total_hit_count` - número de veces que los datos se han servido de la memoria caché
- `total_miss_count` - número de veces que los datos no se han encontrado en la caché

- `ucache_entries` - un array que contiene la información sobre todos los elementos almacenados en caché:

  - `key_name` - nombre de la clave que se utiliza para almacenar los datos
  - `value_type` - tipo de valor almacenado por la clave
  - `use_time` - tiempo en segundos desde el fichero ha sido visitado en la caché de código de operación
  - `last_check` - tiempo en segundos desde el fichero ha sido chequeado para modificaciones
  - `is_session` - indica si los datos son una variable de sesión
  - `ttl_seconds` - el tiempo restante de los datos a vivir en la memoria caché, 0 significa infinito
  - `age_seconds` - tiempo transcurrido desde el momento que los datos han sido añadidos en la caché
  - `hitcount` - número de veces que los datos se han servido de la memoria caché

### Ejemplos

Ejemplo #1 Usar wincache_ucache_info()

`<?php
wincache_ucache_get('green');
wincache_ucache_set('green', 2922);
wincache_ucache_get('green');
wincache_ucache_get('green');
wincache_ucache_get('green');
print_r(wincache_ucache_info());
?>`

El resultado del ejemplo sería:

    Array
    ( ["total_cache_uptime"] => int(0)
      ["is_local_cache"] => bool(false)
      ["total_item_count"] => int(1)
      ["total_hit_count"] => int(3)
      ["total_miss_count"] => int(1)
      ["ucache_entries"] => Array(1)
        ( [1] => Array(6)
          (
            ["key_name"] => string(5) "green"
            ["value_type"] => string(4) "long"
            ["is_session"] => int(0)
            ["ttl_seconds"] => int(0)
            ["age_seconds"] => int(0)
            ["hitcount"] => int(3)
           )
        )
    )

### Ver también

- wincache_fcache_meminfo() - Recupera información sobre el uso de memoria caché de ficheros
- wincache_ocache_fileinfo() - Retrieves information about files cached in the opcode cache
- wincache_ocache_meminfo() - Retrieves information about opcode cache memory usage
- wincache_rplist_meminfo() - Retrieves information about memory usage by the resolve file path cache
- wincache_rplist_fileinfo() - Retrieves information about resolve file path cache
- wincache_refresh_if_changed() - Refreshes the cache entries for the cached files
- wincache_ucache_meminfo() - Recupera información sobre el uso de memoria caché de usuario
- wincache_scache_info() - Retrieves information about files cached in the session cache
- wincache_scache_meminfo() - Recupera información sobre el uso de memoria caché de sesión