深入解析php之apc_PHP教程-PHP-Tutorial-php.cn

apc定义：apc是一个开放自由的php opcode缓存。它的目标是提供一个自由、开放和健全的框架，用于缓存和优化php中间代码。
apc常用函数：
1.apc_clear_cache() 清楚apc缓存内容
2.apc_define_constants(string key,array constants,[,bool case_sensitive])   将数组constants以常量加入缓存
3.apc_load_constants(string key) 取出常量缓存
4.apc_store(string key,mixed var [, int ttl])   在缓存中保存数据
5.apc_fetch(string key) 获取apc_store保存的缓存数据
6.apc_delete(string key) 删除apc_store保存的内容
7.apc_add(string key,mixd var [, int ttl]) 缓存一个变量到数据存储（只在变量之前没有被存储的情况）
8.apc_exists(mix keys) 检查是否有一个或者多个apc键名存在
9.apc_delete_file(mixed keys) 从opcode缓存中删除给定文件的缓存
10.apc_compile_file(string filename [,bool atmic=true]) 绕过filters的限制，缓存文件
11.apc_cache_info(string cache_type [,bool limited=false]) 获取缓存i型奶昔
注：apc_clear_cache只清除opcode缓存文件，apc_delete清楚缓存中的变量；预定义变量，可以使用apc_define_constants函数；php变量可以使用函数apc_store，使用apc比memcache会更好，不需要经过网络传输协议tcp；apc不适用于通过函数apc_store缓存频繁变更的用户数据，会出现一些奇异的现象；apc本身不支持分布式。
apc常用配置：
1.多少内存将被分配给apc，ini选项apc.shm_size（integer）控制这个设置。默认为30M
2.每次请求apc是否检查文件修改，ini选项apc.stat控制这个设置，默认值为1，表示每次请求脚本时都减产脚本是否被更新，如果更新则自动重新编译和缓存编译后的内容，对性能有比例的影响，故这个设为0
3.通过ini选项apc.filters缓存更少的脚本
apc优点：
1.使用spinlocks（自旋）锁机制，能够达到最佳性能
2.apc提供apc.php，用于监控和管理apc缓存。（注：修改管理员名和密码）
3.apc默认通过mmap匿名映射创建共享内存，缓存对象都存放在这块大型的内存空间。由apc自行管理该共享内存
4.调整apc.shm_size、apc.num_files_hints、apc.user_entires_hint的值到最佳
5.php预定义常量，可以使用apc _define——constants()函数。不过apc开发者说pecl hidef性能更加，抛弃define，它是低效的
6.apc_store，对于系统设置等PHP变量，生命周期是整个应用（从httpd守护进程到httpd守护进程关闭），使用apc比memcache更好。（不需要经过网络传输协议）
7.apc不适用于通过函数apc_store()缓存频繁变更用户数据，会出现一些奇异现象。
例：
$constants = array('APC_FILE'=>'apc.php','AUTHOR'=>'tim');
apc_define_constants('memb',$constants );
apc_load_constants('memb');
//echo APC_FILE;
//echo AUTHOR;

if(!apc_fetch('time1')) apc_store('time1',time());
if(!apc_fetch('time2')) apc_store('time2',time(),2);
//echo apc_fetch('time1');
//echo apc_fetch('time2');

class a{
     public function b(){echo 'success';}
}
apc_store('obj',new a());
$a = apc_fetch('obj');
//$a-b();

$ret = apc_exists(array('foo', 'donotexist', 'bar'));
//array(2) { ["foo"]=> bool(true) ["bar"]=> bool(true) }
?>
补充详细配置说明：
apc.cache_by_default = on
;sys
; 是否默认对所有文件启用缓冲。
; 若设为off并与以加号开头的apc.filters指令一起用，则文件仅在匹配过滤器时才被缓存。

apc.enable_cli = off
;sys
; 是否为cli版本启用apc功能，仅用于测试和调试目的才打开此指令。

apc.enabled = on
; 是否启用apc，如果apc被静态编译进php又想禁用它，这是唯一的办法。

apc.file_update_protection = 2
;sys
; 当你在一个运行中的服务器上修改文件时，你应当执行原子操作。
; 也就是先写进一个临时文件，然后将该文件重命名(mv)到最终的名字。
; 文本编辑器以及cp, tar 等程序却并不是这样操作的，从而导致有可能缓冲了残缺的文件。
; 默认值2 表示在访问文件时如果发现修改时间距离访问时间小于2 秒则不做缓冲。
; 那个不幸的访问者可能得到残缺的内容，但是这种坏影响却不会通过缓存扩大化。
; 如果你能确保所有的更新操作都是原子操作，那么可以用0 关闭此特性。
; 如果你的系统由于大量的io操作导致更新缓慢，你就需要增大此值。

apc.filters =
;sys
; 一个以逗号分隔的posix扩展正则表达式列表。
; 如果源文件名与任意一个模式匹配，则该文件不被缓存。
; 注意，用来匹配的文件名是传递给include/require的文件名，而不是绝对路径。
; 如果正则表达式的第一个字符是"+"则意味着任何匹配表达式的文件会被缓存，
; 如果第一个字符是"-"则任何匹配项都不会被缓存。"-"是默认值，可以省略掉。

apc.ttl = 0
;sys
; 缓存条目在缓冲区中允许逗留的秒数。0 表示永不超时。建议值为7200~36000。
; 设为0 意味着缓冲区有可能被旧的缓存条目填满，从而导致无法缓存新条目。

apc.user_ttl = 0
;sys
; 类似于apc.ttl，只是针对每个用户而言，建议值为7200~36000。
; 设为0 意味着缓冲区有可能被旧的缓存条目填满，从而导致无法缓存新条目。

apc.gc_ttl = 3600
;sys
; 缓存条目在垃圾回收表中能够存在的秒数。
; 此值提供了一个安全措施，即使一个服务器进程在执行缓存的源文件时崩溃，
; 而且该源文件已经被修改，为旧版本分配的内存也不会被回收，直到达到此ttl值为止。
; 设为零将禁用此特性。

apc.include_once_override = off
;sys
; 关于该指令目前尚无说明文档，参见：http://pecl.php.net/bugs/bug.php?id=8754
; 请保持为off，否则可能导致意想不到的结果。

apc.max_file_size = 1m
;sys
; 禁止大于此尺寸的文件被缓存。

apc.mmap_file_mask =
;sys
; 如果使用–enable-mmap(默认启用)为apc编译了mmap支持，
; 这里的值就是传递给mmap模块的mktemp风格的文件掩码(建议值为"/tmp/apc.xxxxxx")。
; 该掩码用于决定内存映射区域是否要被file-backed或者shared memory backed。
; 对于直接的file-backed内存映射，要设置成"/tmp/apc.xxxxxx"的样子(恰好6个x)。
; 要使用posix风格的shm_open/mmap就需要设置成"/apc.shm.xxxxxx"的样子。
; 你还可以设为"/dev/zero"来为匿名映射的内存使用内核的"/dev/zero"接口。
; 不定义此指令则表示强制使用匿名映射。

apc.num_files_hint = 1000
;sys
; web服务器上可能被包含或被请求的不同源文件的大致数量(建议值为1024~4096)。
; 如果你不能确定，则设为0 ；此设定主要用于拥有数千个源文件的站点。

apc.optimization = 0
; 优化级别(建议值为0 ) 。
; 正整数值表示启用优化器，值越高则使用越激进的优化。
; 更高的值可能有非常有限的速度提升，但目前尚在试验中。

apc.report_autofilter = off
;sys
; 是否记录所有由于early/late binding原因而自动未被缓存的脚本。

apc.shm_segments = 1
;sys
; 为编译器缓冲区分配的共享内存块数量(建议值为1)。
; 如果apc耗尽了共享内存，并且已将apc.shm_size指令设为系统允许的最大值，
; 你可以尝试增大此值。

apc.shm_size = 30
;sys
; 每个共享内存块的大小(以mb为单位，建议值为128~256)。
; 有些系统(包括大多数bsd变种)默认的共享内存块大小非常少。

apc.slam_defense = 0
;sys(反对使用该指令，建议该用apc.write_lock指令)
; 在非常繁忙的服务器上，无论是启动服务还是修改文件，
; 都可能由于多个进程企图同时缓存一个文件而导致竞争条件。
; 这个指令用于设置进程在处理未被缓存的文件时跳过缓存步骤的百分率。
; 比如设为75表示在遇到未被缓存的文件时有75%的概率不进行缓存，从而减少碰撞几率。
; 鼓励设为0 来禁用这个特性。

apc.stat = on
;sys
; 是否启用脚本更新检查。
; 改变这个指令值要非常小心。
; 默认值on 表示apc在每次请求脚本时都检查脚本是否被更新，
; 如果被更新则自动重新编译和缓存编译后的内容。但这样做对性能有不利影响。
; 如果设为 off 则表示不进行检查，从而使性能得到大幅提高。
; 但是为了使更新的内容生效，你必须重启web服务器。
; 这个指令对于include/require的文件同样有效。但是需要注意的是，
; 如果你使用的是相对路径，apc就必须在每一次include/require时都进行检查以定位文件。
; 而使用绝对路径则可以跳过检查，所以鼓励你使用绝对路径进行include/require操作。

apc.user_entries_hint = 100
;sys
; 类似于num_files_hint指令，只是针对每个不同用户而言。
; 如果你不能确定，则设为0 。

apc.write_lock = on
;sys
; 是否启用写入锁。
; 在非常繁忙的服务器上，无论是启动服务还是修改文件，
; 都可能由于多个进程企图同时缓存一个文件而导致竞争条件。
; 启用该指令可以避免竞争条件的出现。

apc.rfc1867 = off
;sys
; 打开该指令后，对于每个恰好在file字段之前含有apc_upload_progress字段的上传文件，
; apc都将自动创建一个upload_的用户缓存条目(就是apc_upload_progress字段值)。