(PECL apcu >= 5.1.0)
apcu_entry — 原子地获取或生成缓存条目
原子地尝试在缓存中查找 key
,如果找不到,则调用 generator
,并将 key
作为唯一参数传递。然后将调用的返回值使用可选指定的 ttl
缓存并返回。
注意: 当控制权进入 apcu_entry() 时,缓存的锁将被独占获取,当控制权离开 apcu_entry() 时释放:实际上,这将
generator
的主体变成了一个临界区,不允许两个进程同时执行相同的代码路径。此外,它还禁止任何其他 APCu 函数的并发执行,因为它们将获取相同的锁。
generator
可以安全调用的唯一 APCu 函数是 apcu_entry()。
key
缓存条目的标识
generator
一个可调用函数,它接受 key
作为唯一参数并返回要缓存的值。
ttl
生存时间;将 var
存储在缓存中 ttl
秒。在 ttl
过期后,存储的变量将从缓存中清除(在下一个请求时)。如果未提供 ttl
(或如果 ttl
为 0
),则该值将一直保留,直到手动将其从缓存中删除或以其他方式在缓存中不存在(清除、重启等)。
返回缓存的值
示例 #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" } }