PHP 8.6.0 Beta 3 is available for testing

Yac::get

(PECL yac >= 1.0.0)

Yac::getRécupère des valeurs du cache

Description

public function Yac::get(string|array $key, mixed $default = null): mixed

Récupère des valeurs du cache.

Liste de paramètres

key

Une clé string, ou un array de clés.

default

La valeur à retourner quand la clé (ou les clés) demandée n'est pas présente dans le cache, disponible à partir de yac 2.4.0. Quand omis, un défaut de cache retourne false.

Note:

Avant yac 2.4.0, cet emplacement d'argument contenait un jeton $cas par référence plutôt qu'une valeur par défaut. Le code qui passait ou se reposait sur ce jeton doit être mis à jour lors d'une montée en version vers 2.4.0.

Valeurs de retour

Pour une clé string, retourne la valeur mise en cache en cas de succès, sinon la default (ou false si aucune valeur par défaut n'a été donnée).

Pour un array de clés, retourne un tableau contenant les valeurs trouvées indexées par leurs clés. Les clés absentes du cache sont omises du résultat à partir de yac 2.4.0, ou remplies avec la default quand une a été fournie ; avant 2.4.0, un placeholder false était inséré pour chaque clé manquante.

Exemples

Exemple #1 Exemple avec Yac::get()

<?php
$yac = new Yac();

$yac->set("foo", "bar");
var_dump($yac->get("foo"));                 // string(3) "bar"
var_dump($yac->get("missing"));             // bool(false): défaut de cache
?>

Exemple #2 Distinguer un false stocké d'un défaut de cache

<?php
$yac = new Yac();

// un défaut de cache et un false stocké sont indiscernables sans valeur par défaut ;
// une valeur sentinelle (disponible à partir de yac 2.4.0) les distingue
$yac->set("flag", false);
var_dump($yac->get("flag"));                // bool(false): la valeur stockée
var_dump($yac->get("missing", false));      // bool(false): un défaut de cache, même forme
var_dump($yac->get("flag", "__NONE__"));    // bool(false): la valeur stockée
var_dump($yac->get("missing", "__NONE__")); // string(8) "__NONE__": un défaut de cache
?>

Exemple #3 Récupération de plusieurs clés en un appel

<?php
$yac = new Yac();

$yac->set("foo", "bar");
$yac->set("foo2", "bar2");

// avec un tableau de clés, seules les clés trouvées sont présentes dans le résultat
var_dump($yac->get(array("foo", "foo2", "missing")));
// array(2) { ["foo"]=> string(3) "bar" ["foo2"]=> string(4) "bar2" }
?>

Voir aussi

  • Yac::set() - Stocke une valeur dans le cache
  • Yac::__get() - Récupère une valeur via la syntaxe propriété

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top