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

wincache_ucache_set ( mixed $key , mixed $value [, int $ttl = 0 ] ) : bool

wincache_ucache_set ( array $values [, mixed $unused = NULL [, int $ttl = 0 ]] ) : bool

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

Retour à la première page de Manuel PHP Table des matières Haut

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

Retour à la première page de Manuel PHP Table des matières Haut

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.

Retour à la première page de Manuel PHP Table des matières Haut

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"

Retour à la première page de Manuel PHP Table des matières Haut

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

Rechercher une fonction PHP

Version en cache

25/12/2024 13:52:37 Cette version de la page est en cache (à la date du 25/12/2024 13:52:37) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-wincache-ucache-set.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut