Xcache使用小结

一、配置

  1、分层：Xcache将缓存对象分为两类：php代码和php变量，前者在xcache.ini中只是单纯的xcache前缀，后者则用xcache_var前缀，两个对象可以独立调整。

  2、配置说明：

xcache.admin.user string
 //"验证名."
xcache.admin.pass string
//"md5 后的验证密码, 亦即 md5(您的密码), 留空则禁用管理页面."
xcache.test string
//"仅在测试一些功能的时候才启用. 如果您不知道这个功能的作用, 则您不需要知道."
xcache.coredump_directory string
//"设置在 crash (SIGSEGV/SIGABRT) 时保存 core dump 文件的路径. 留空则禁止, 或者设置为类似 "/tmp/phpcore/" 的目录. 确保这个路径可以被 php 写入文件. (与 open_basedir 无关)."
xcache.admin.enable_auth string
//"如果你打算自己处理验证, 用这个选项禁止 HTTP 验证功能. 值得注意的是任意 vhost 用户都可以安装一个 XCache admin 页面, 如果禁止了内建 HTTP 验证, 则他们亦不需要权限即可访问管理页面. 出于安全考虑, 您应该尽量考虑保留 XCache 内建验证功能, 针对 XCache admin 页面特定地址取消网页服务器的 mod_auth //这个选项仅在 1.2.x 系列有作用, 起始版本 1.2.1"

/*   XCache Cacher   */

xcache.cacher boolean
// 使用/不使用 opcode 缓存器. xcache.size = 0 时无效.
xcache.size int
//0 禁止, 非 0 则启用缓存器. 请注意您系统所允许的 mmap 最大值.
xcache.count int
//指定将 cache 切分成多少块. 参考 SplittedCache，官方文档是说一般跟CPU的数目相同，实际操作中，跟fcgi-php的数目相同？？？（没有求证，因为设置为CPU的数目，比如说2,则只有两个进程的内存增加，每个php-cgi的内存占用不平衡。）
xcache.slots size
//只是作为 hash 槽个数的参考值, 您可以放心地缓冲超过这个个数的项目.
xcache.ttl seconds
//设置缓冲项目的 Ttl (Time To Live) 值, 0=永不过期.
xcache.gc_interval seconds
//检查过期项目, 回收内存空间的间隔.
xcache.var_size int
xcache.var_count int
xcache.var_slots size
xcache.var_gc_interval seconds
//同上, 不过用于数据缓冲而不是 opcode 缓冲.
xcache.var_ttl seconds
//xcache_(get|set|inc|dec) 等的默认 ttl 值.
xcache.var_maxttl seconds
//最大 ttl 值, 程序无法指定超过这个最大值的 ttl.
xcache.readonly_protection boolean
//如果启用了 ReadonlyProtection, 将会略微降低性能, 但是会提高一定的安全系数. 这个选项对于 xcache.mmap_path = /dev/zero 无效.
xcache.mmap_path string
对于 *nix, xcache.mmap_path 是 文件路径, 不是目录. 对于 Win32, xcache.mmap_path //只是匿名的 map 名, 不是实际的文件路径. 如果您要启用 ReadonlyProtection 请用类似 "/tmp/xcache" 的路径. 2 组 php 不该共用同一个路径 (/dev/zero 除外).

/*  XCache Optimizer */
//Name Default Changeable

xcache.optimizer boolean
//启用优化器 (目前无效).

 3、最重要的参数是xcache.var_size和xcache.size，可以根据内存设置，但是在top中，内存占用直接多出来很多，比如都设置了为256M，则php-cgi的占用就在530M左右，基本的php大约10-15M，加上512M，就快到530了。

 4、admin配置后，可以使用xcache自带的admin程序。

二、函数说明：

1、数据函数()
mixed xcache_get(string name)
bool xcache_set(string name, mixed value [, int ttl])
bool xcache_isset(string name)
bool xcache_unset(string name)
bool xcache_unset_by_prefix(string prefix)
    //低版本没有这个函数，使用之前要测试一下
 
int xcache_inc(string name [, int value [, int ttl]])
   //自增函数，value为步长，如果没有初始化，则默认为零，ttl为过期时间
  
int xcache_dec(string name [, int value [, int ttl]])
   //自减函数，同上


    注意：xcache不能存放对象、资源等内容。

2、管理函数：
int xcache_count(int type)
//type值定义为宏，返回值为把指定的共享内存分为多少份，见xcache.count配置参数
    XC_TYPE_PHP:  Cache Type = php opcode     XC_TYPE_VAR： Cache Type = variable data array xcache_info(int type, int id)
//返回值：为数组：

array(16) {
  ["slots"]=>   //slots值
  int(65536)
  ["compiling"]=>
  int(0)
  ["misses"]=>  //失误
  int(0)
  ["hits"]=>   //命中
  int(0)
  ["clogs"]=>
  int(0)
  ["ooms"]=>
  int(1)
  ["errors"]=>  //错误
  int(0)
  ["cached"]=>  //缓存
  int(78)
  ["deleted"]=>  //
  int(0)
  ["gc"]=>
  int(6)
  ["hits_by_hour"]=>  //最近24小时的命中数
  array(24) {
    [0]=>
    int(0)
    [1]=>
    int(0)
    [2]=>
    int(0)
    [3]=>
    int(0)
    [4]=>
    int(0)
    [5]=>
    int(0)
    [6]=>
    int(0)
    [7]=>
    int(0)
    [8]=>
    int(0)
    [9]=>
    int(0)
    [10]=>
    int(0)
    [11]=>
    int(0)
    [12]=>
    int(0)
    [13]=>
    int(0)
    [14]=>
    int(0)
    [15]=>
    int(0)
    [16]=>
    int(0)
    [17]=>
    int(0)
    [18]=>
    int(0)
    [19]=>
    int(0)
    [20]=>
    int(0)
    [21]=>
    int(0)
    [22]=>
    int(0)
    [23]=>
    int(0)
  }
  ["hits_by_second"]=>  //最近5秒钟的命中数
  array(5) {
    [0]=>
    int(0)
    [1]=>
    int(0)
    [2]=>
    int(0)
    [3]=>
    int(0)
    [4]=>
    int(0)
  }
  ["size"]=>     //共享内存大小，仅此count的，不是所有
  int(134217728)
  ["avail"]=>    //可用内存大小
  int(125642656)
  ["can_readonly"]=>
  bool(false)
  ["free_blocks"]=>
  array(1) {
    [0]=>
    array(2) {
      ["size"]=>   //空闲块链首
      int(125642656)
      ["offset"]=>
      int(8575064)
    }
  }
}

array xcache_list(int type, int id)
//返回值：

array(2) {
  ["cache_list"]=> //缓存列表
 array(78) {
    [0]=>
    array(7) {
      ["size"]=>  //大小
      int(107952)
      ["refcount"]=> //引用次数
      int(0)
      ["hits"]=>     //命中次数
      int(0)
      ["ctime"]=>     //创建时间
      int(1306710407)
      ["atime"]=>     //存在时间
      int(1306710407)
      ["hvalue"]=>
      int(1257)
      ["name"]=>     //名称
      string(9) "my_var100"
    }
    [1]=> ......

 ["deleted_list"]=> //删除列表
  array(0) {
  }
}

void xcache_clear_cache(int type, int id)
string xcache_coredump(int op_type)


三、

Cache 帮助

槽:
  
    Hash 槽个数, 对应 php.ini 里的设置
大小:
  
    共享内存区大小, 单位: 字节
剩余:
  
    可用内存, 对应共享内存区的剩余内存字节数
%:
  
    百分比, 条状显示可用内存的比例
清除:
  
    清除按钮, 点击按钮清除对应共享内存区的数据
编译中:
  
    编译标记, 当共享内存区正在编译 php 脚本时标记为 "yes"
命中:
  
    共享内存命中次数, 命中=从该共享内存载入php或者变量
错过:
  
    共享内存错过次数, 错过=请求的php或者变量并不在该共享内存内
阻塞:
  
    编译阻塞跳过, 阻塞=当需该共享内存区负责编译时, 其他进程/现成无法访问此共享内存. 跳过=XCache 自动判断阻塞的共享内存区自动跳过阻塞等待, 直接使用非共享内存方式继续处理请求
内存不足:
  
    内存不足次数, 显示需要存储新数据但是共享内存区内存不足的次数. 如果出现太频繁请考虑加大配置中的 xcache.size 或者 xcache.var_size
错误:
  
    编译错误, 显示您的脚本被编译时出错的次数. 如果您发现这个数字不断增长, 您应该检查什么脚本产生错误. 参考 ini.error-log and ini.display-errors
保护:
  
    显示该 Cache 是否支持并启用 readonly_protection
缓冲:
  
    共享内存于该共享内存区的项目条数
待删:
  
    共享内存区内将要删除的项目 (已经删除但是还被某些进程占用)
GC:
  
    垃圾回收的倒计时
空闲块:
  
    共享内存区内的空闲内存块

List 帮助

项目:
  
    项目名或者文件名
命中:
  
    该项目被命中的次数 (从共享内存区载入)
引用数:
  
    项目依然被其他进程占据的引用次数
大小:
  
    项目在共享内存里占用字节数
源大小:
  
    源文件大小
修改:
  
    源文件最后修改时间
设备:
  
    源文件所在设备ID
Inode:
  
    源文件的inode
访问:
  
    最后访问该项目的时间
创建:
  
    该项目被创建于共享内的时间

四、Coverager Functions和