wincache_ucache_meminfo
wincache_unlock
Fonctions WinCache
PHP Manual

# wincache_ucache_set

(PECL wincache >= 1.1.0)

wincache_ucache_set — Ajoute une variable au cache utilisateur et écrase la variable si elle existe déjà dans le cache

### Description

bool wincache_ucache_set ( mixed `$key` , mixed `$value` [, int `$ttl` = 0 ] )
bool wincache_ucache_set ( array `$values` [, mixed `$unused` [, int `$ttl` = 0 ]] )

Ajoute une variable au cache utilisateur. Écrase une variable si elle existe déjà dans le cache. La variable ainsi créée ou mise à jour restera dans le cache utilisateur tant que le délai d'expiration n'est pas atteint ou tant qu'elle n'est pas supprimée avec la fonction wincache_ucache_delete() ou la fonction wincache_ucache_clear().

### Liste de paramètres

`key`

  Stocke la variable en utilisant la clé `key`. Si une variable utilisant la même clé `key` est déjà présente, la fonction écrasera la précédente valeur avec la nouvelle. Le paramètre `key` est sensible à la casse. `key` peut également être un tableau de paires nom => valeur où les noms seront utilisés comme clés. Ceci peut être utile pour ajouter plusieurs valeurs dans le cache en une seule opération.

`value`

  Valeur de la variable à stocker. Le paramètre `Value` supporte tous les types de données, sauf les ressources, comme les pointeurs de fichiers. Ce paramètre est ignoré si le premier argument est un tableau. Il est de convention de passer la valeur `NULL` comme valeur du paramètre `value` lors de l'utilisation d'un tableau dans le paramètre `key`. Si le paramètre `value` est un objet, ou un tableau contenant des objets, alors tous les objets seront linéarisés. Reportez-vous à la fonction __sleep() pour plus de détails sur la linéarisation d'objets.

`values`

  Tableau associatif de clés et de valeurs.

`ttl`

  Durée de vie de la variable dans le cache, en secondes. Après la durée spécifiée par le paramètre `ttl`, la variable stockée sera effacée du cache utilisateur. Ce paramètre prend par défaut la valeur zéro (0), ce qui signifie que la variable restera dans le cache tant qu'elle ne sera pas explicitement supprimée en appelant la fonction wincache_ucache_delete() ou la fonction wincache_ucache_clear().

### Valeurs de retour

Si `key` est une chaîne de caractères, la fonction retournera `TRUE` en cas de succès, `FALSE` si une erreur survient.

Si `key` est un tableau, la fonction retournera :

- Si toutes les paires nom => valeur du tableau ont pu être définies, la fonction retournera un tableau vide.
- Si toutes les paires nom => valeur du tableau n'ont pu être définies, la fonction retournera `FALSE`.
- Si quelques paires ont été définies, et d'autres non, la fonction retournera un tableau de paires nom => valeur qui n'ont pas pu être définies dans le cache utilisateur.

### Exemples

Exemple #1 Exemple avec wincache_ucache_set() et le paramètre `key` sous forme de chaîne de caractères

`<?php
$bar = 'BAR';
var_dump(wincache_ucache_set('foo', $bar));
var_dump(wincache_ucache_get('foo'));
$bar1 = 'BAR1';
var_dump(wincache_ucache_set('foo', $bar1));
var_dump(wincache_ucache_get('foo'));
?>`

L'exemple ci-dessus va afficher :

    bool(true)
    string(3) "BAR"
    bool(true)
    string(3) "BAR1"

Exemple #2 Exemple avec wincache_ucache_set() et le paramètre `key` sous forme de tableau

`<?php
$colors_array = array('green' => '5', 'Blue' => '6', 'yellow' => '7', 'cyan' => '8');
var_dump(wincache_ucache_set($colors_array));
var_dump(wincache_ucache_set($colors_array));
var_dump(wincache_ucache_get('Blue'));
?>`

L'exemple ci-dessus va afficher :

    array(0) {}
    array(0) {}
    string(1) "6"

### Voir aussi

- wincache_ucache_add() - Ajoute une nouvelle variable au cache utilisateur
- wincache_ucache_get() - Récupère une variable stokée dans le cache utilisateur
- wincache_ucache_delete() - Supprime les variables du cache utilisateur
- wincache_ucache_clear() - Supprime le contenu d'une entrée du cache utilisateur
- wincache_ucache_exists() - Vérifie si une variable existe dans le cache utilisateur
- wincache_ucache_meminfo() - Récupère des informations sur l'utilisation mémoire du cache utilisateur
- wincache_ucache_info() - Récupère des informations sur des données stokées dans le cache utilisateur
- __sleep()

wincache_ucache_meminfo
wincache_unlock
Fonctions WinCache
PHP Manual