Yac::get

(Yac >= 1.0.0)

Yac::get — 从缓存中取值

说明

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

从缓存中取值。

参数

keys

string 类型的键，或者由键组成的 array。

default

当请求的键（或多个键）不在缓存中时返回的值， 自 yac 2.4.0 起可用。省略时，未命中返回 false。

注意:

在 yac 2.4.0 之前，该参数位置是一个引用形式的 $cas 令牌，而不是默认值。 传递过或依赖该令牌的代码在升级到 2.4.0 时必须更新。

返回值

对于 string 类型的键，命中时返回缓存的值， 否则返回 default（未指定默认值时返回 false）。

对于由键组成的 array，返回一个数组， 其中包含所有命中的值，以各自的键为索引。 自 yac 2.4.0 起，不在缓存中的键会被直接忽略 （若指定了 default，则用默认值填充）； 在 2.4.0 之前，每个缺失的键都会插入一个 false 占位值。

示例

示例 #1 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)：未命中

// 没有默认值时，未命中和存了 false 无法区分；
// 哨兵默认值（自 yac 2.4.0 起可用）可以区分二者
$yac->set("flag", false);
var_dump($yac->get("flag"));                // bool(false)：存的就是这个值
var_dump($yac->get("missing", false));      // bool(false)：未命中，形态相同
var_dump($yac->get("flag", "__NONE__"));    // bool(false)：存的就是这个值
var_dump($yac->get("missing", "__NONE__")); // string(8) "__NONE__"：未命中

// 传入键数组时，结果中只包含命中的键
$yac->set("foo2", "bar2");
var_dump($yac->get(array("foo", "foo2", "missing")));
// array(2) { ["foo"]=> string(3) "bar" ["foo2"]=> string(4) "bar2" }
?>

参见