PHP Conference Nagoya 2025

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

    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 sérialisés. Reportez-vous à la fonction __sleep() pour plus de détails sur la sérialisation 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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    0
    don dot raman at microsoft dot com
    14 years ago
    As of writing this note (PHP 5.3.1) serialization of closure is not allowed.

    This means a code like the one below:

    <?php
    //Closure
    $bar3 = function($a) {
    return     $a * 2;
    };
    wincache_ucache_set('foo3', $bar3);
    var_dump(wincache_ucache_get('foo3'));
    echo     "<br>";
    ?>

    Will throw exception:
    [11-Feb-2010 09:25:33] PHP Fatal error: Uncaught exception 'Exception' with message 'Serialization of 'Closure' is not allowed' in C:\inetpub\wwwroot\phptest\tests\ucache\wincache15.php:6
    Stack trace:
    #0 C:\inetpub\wwwroot\phptest\tests\ucache\wincache15.php(6): wincache_ucache_set('foo3', Object(Closure))
    #1 {main}
    thrown in C:\inetpub\wwwroot\phptest\tests\ucache\wincache15.php on line 6

    However one catch this exception like:
    <?php
    //Closure
    $bar3 = function($a) {
    return     $a * 2;
    };
    try
    {
    wincache_ucache_set('foo3', $bar3);
    }
    catch (    Exception $e)
    {
    var_dump($e->getMessage());
    }
    var_dump(wincache_ucache_get('foo3'));
    echo     "<br>";
    ?>

    This will generate output as shown beloe:
    string(41) "Serialization of 'Closure' is not allowed" NULL
    ＋add a note
    To Top