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