apcu_entry

(PECL apcu >= 5.1.0)

apcu_entry 原子地获取或生成缓存条目

描述

apcu_entry(string $key, callable $generator, int $ttl = 0): mixed

原子地尝试在缓存中查找 key,如果找不到,则调用 generator,并将 key 作为唯一的参数传递。然后将调用的返回值缓存,并可选地指定 ttl,并返回。

注意: 当控制进入 apcu_entry() 时,缓存的锁被排他地获取,当控制离开 apcu_entry() 时,它被释放:实际上,这将 generator 的主体变成了一个临界区,不允许两个进程同时执行相同的代码路径。此外,它还禁止任何其他 APCu 函数的并发执行,因为它们将获取相同的锁。

警告

generator 可以安全调用的唯一 APCu 函数是 apcu_entry().

参数

key

缓存条目的标识

generator

一个可调用对象,它接受 key 作为唯一的参数并返回要缓存的值。

ttl

生存时间;在缓存中存储 var ttl 秒。在 ttl 过期后,存储的变量将从缓存中删除(在下一次请求时)。如果没有提供 ttl(或 ttl0),则该值将一直存在,直到它被手动从缓存中删除,或者在缓存中不存在(清除、重启等)。

返回值

返回缓存的值

示例

示例 #1 一个 apcu_entry() 示例

<?php
$config
= apcu_entry("config", function($key) {
return [
"fruit" => apcu_entry("config.fruit", function($key){
return [
"apples",
"pears"
];
}),
"people" => apcu_entry("config.people", function($key){
return [
"bob",
"joe",
"niki"
];
})
];
});

var_dump($config);
?>

上面的示例将输出

array(2) {
  ["fruit"]=>
  array(2) {
    [0]=>
    string(6) "apples"
    [1]=>
    string(5) "pears"
  }
  ["people"]=>
  array(3) {
    [0]=>
    string(3) "bob"
    [1]=>
    string(3) "joe"
    [2]=>
    string(4) "niki"
  }
}

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top