(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()时，锁被释放:实际上，这将生成器的主体变成一个临界区，不允许两个进程并发地执行相同的代码路径。此外，它禁止任何其他APCu函数的并发执行，因为它们将获得相同的锁。

警告

唯一可以被生成器安全地调用的APCu函数是apcu_entry()。

参数

key

缓存项标识

generator

接受​key​作为唯一参数并将值返回到缓存的可调用对象。

ttl

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

返回值

返回缓存的值。

示例

示例 #1 An apcu_entry() example

<?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"
  }
}

参见

• apcu_store() - 缓存一个变量到存储中
• apcu_fetch() - Fetch a stored variable from the cache
• apcu_delete() - Removes a stored variable from the cache