2024 年 PHP Conference Japan

apcu_entry

(PECL apcu >= 5.1.0)

apcu_entry 原子性地擷取或產生快取項目

說明

apcu_entry(字串 $key, 可呼叫 $generator, 整數 $ttl = 0): 混合

原子性地嘗試在快取中尋找 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