# wincache_ucache_info

(PECL wincache >= 1.1.0)

wincache_ucache_info — Récupère des informations sur des données stokées dans le cache utilisateur

### Description

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

Récupère des informations sur des données stokées dans le cache utilisateur.

### Liste de paramètres

`summaryonly`

  Contrôle si le tableau résultant doit contenir les informations sur des entrées individuelles en plus du résumé du cache utilisateur.

`key`

  La clé de l'entrée du cache utilisateur. Si spécifiée, alors le tableau résultant contiendra des informations uniquement sur cette entrée du cache. Si non spécifiée, et le paramètre `summaryonly` est défini à `false`, alors le tableau résultant contiendra des informations sur toutes les entrées du cache.

### Valeurs de retour

Un tableau de données méta sur le cache utilisateur ou `false` si une erreur survient

Le tableau retourné par cette fonction contient les éléments suivants :

- `total_cache_uptime` - durée, en secondes, depuis l'activation de ce cache utilisateur
- `total_item_count` - nombre total d'éléments contenus dans le cache utilisateur
- `is_local_cache` - `true` si les données méta du cache sont pour une instance locale du cache, `false` si elles sont pour le cache global
- `total_hit_count` - durée depuis laquelle les données ont été servies depuis le cache
- `total_miss_count` - durée depuis laquelle les données n'ont pu être trouvée dans le cache

- `ucache_entries` - un tableau contenant les informations sur les éléments mis en cache :

  - `key_name` - nom de la clé utilisée pour stoker les données
  - `value_type` - type de valeur stokée pour cette clé
  - `use_time` - durée, en secondes, depuis laquelle le fichier a été accédé dans le cache opcode
  - `last_check` - durée, en secondes, depuis laquelle le fichier a été vérifié pour y détecter les modifications
  - `is_session` - indique si la donnée est une variable de session
  - `ttl_seconds` - durée de vie de la donnée dans le cache ; 0 signifie indéfiniment
  - `age_seconds` - durée depuis laquelle la donné a été ajoutée dans le cache
  - `hitcount` - nombre de fois que la donnée a été servie depuis le cache

### Exemples

Exemple #1 Exemple avec 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());
?>`

L'exemple ci-dessus va afficher :

    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)
           )
        )
    )

### Voir aussi

- wincache_fcache_meminfo() - Extrait des informations sur l'utilisation de la mémoire du cache de fichiers.
- wincache_ocache_fileinfo() - Extrait des informations sur les fichiers mis en cache dans le cache opcode
- wincache_ocache_meminfo() - Extrait des informations sur l'utilisation du cache opcode
- wincache_rplist_meminfo() - Récupère des informations sur l'utilisation de la mémoire par le cache de chemin de fichier résolu
- wincache_rplist_fileinfo() - Récupère des informations du cache sur un chemin de fichier résolu
- wincache_refresh_if_changed() - Actualise les entrées du cache pour les fichiers mis en cache
- wincache_ucache_meminfo() - Récupère des informations sur l'utilisation mémoire du cache utilisateur
- wincache_scache_info() - Récupère des informations sur des fichiers mis en cache
- wincache_scache_meminfo() - Récupère des informations sur l'utilisation de la mémoire du cache