2024 年 PHP 日本研討會

wincache_ucache_info

(PECL wincache >= 1.1.0)

wincache_ucache_info擷取儲存在使用者快取中的資料資訊

說明

wincache_ucache_info(bool $summaryonly = false, string $key = NULL): array|false

擷取儲存在使用者快取中的資料資訊。

參數

summaryonly

控制返回的陣列是否包含個別快取項目的資訊以及使用者快取摘要。

key

使用者快取中項目的鍵值。如果指定,則返回的陣列將僅包含關於該快取項目的資訊。如果未指定且 summaryonly 設為 false,則返回的陣列將包含快取中所有項目的資訊。

返回值

使用者快取中繼資料的陣列,或失敗時返回 false

此函數返回的陣列包含以下元素

  • total_cache_uptime - 使用者快取已啟用的總時間(以秒為單位)
  • total_item_count - 目前使用者快取中的元素總數
  • is_local_cache - 如果快取中繼資料用於本機快取執行個體,則為 true,如果中繼資料用於全域快取,則為 false
  • total_hit_count - 從快取中提供資料的次數
  • total_miss_count - 在快取中找不到資料的次數
  • ucache_entries - 包含所有快取項目資訊的陣列

    • key_name - 用於儲存資料的鍵值名稱
    • value_type - 鍵值儲存的值的類型
    • use_time - 自檔案在操作碼快取中被存取以來的時間(以秒為單位)
    • last_check - 自檢查檔案是否有修改以來的時間(以秒為單位)
    • is_session - 指示資料是否為工作階段變數
    • ttl_seconds - 資料在快取中存留的剩餘時間,0 表示無限期
    • age_seconds - 自資料新增到快取以來經過的時間
    • hitcount - 從快取中提供資料的次數

範例

範例 #1 使用 wincache_ucache_info()

<?php
wincache_ucache_get
('green');
wincache_ucache_set('green', 2922);
wincache_ucache_get('green');
wincache_ucache_get('green');
wincache_ucache_get('green');
print_r(wincache_ucache_info());
?>

上述範例將輸出

Array 
( ["total_cache_uptime"] => int(0)
  ["is_local_cache"] => bool(false)
  ["total_item_count"] => int(1) 
  ["total_hit_count"] => int(3) 
  ["total_miss_count"] => int(1) 
  ["ucache_entries"] => Array(1) 
    ( [1] => Array(6)
      ( 
        ["key_name"] => string(5) "green"
        ["value_type"] => string(4) "long" 
        ["is_session"] => int(0) 
        ["ttl_seconds"] => int(0)
        ["age_seconds"] => int(0)
        ["hitcount"] => int(3) 
       ) 
    ) 
)

另請參閱

新增註解

使用者貢獻的註解 1 則註解

1
don dot raman at microsoft dot com
14 年前
需要注意的是,使用者快取陣列中作為中設資料之一返回的「is_local_cache」欄位將始終返回布林值 false,因為使用者快取始終是全域的,而不是區域的。
To Top