[原创]APC 3.1.9 编译安装使用

2011年6月28日 | 标签: apache, apc, cache, nginx, php

APC(Alternative PHP Cache)是一种对PHP有效的开放源高速缓冲储存器工具,它能够缓存opcode的php中间码。APC是一种php的缓存解决方案,目前以pecl方式发布,有消息说将会出现在php6版本的内核。

著名的facebook也在使用APC,据说facebook优化的APC,可以加速php达到未使用任何缓存的12倍。效果相当惊人。

注意:

1.APC与ZendOptimizer、ea是不兼容得,安装apc之前请在php.ini里面注释掉这两个。

2.APC不支持分布式。

 

一.安装方法

修改php.ini,加载编译生成的apc.so及配置apc(注意extension_dir的设置)。在php.ini最后添加以下代码:

[apc]
extension="apc.so"
apc.enabled = 1
apc.cache_by_default = on
apc.shm_segments = 1
apc.shm_size = 64M
apc.ttl = 7200
apc.user_ttl = 7200
apc.num_files_hint = 0
apc.write_lock = On

1.apache+php+apc中apc的编译安装

wget http://pecl.php.net/get/APC-3.1.9.tgz
tar zxf APC-3.1.9.tgz
cd APC-3.1.9
/usr/local/php/bin/phpize
/configure --enable-apc --enable-apc-mmap --with-apxs=path-to-apache/bin/apxs \
--with-php-config=path-to-php/bin/php-config
make
make install
cd ../
service httpd restart

2.nginx+php-fpm+apc

wget http://pecl.php.net/get/APC-3.1.9.tgz
tar zxf APC-3.1.9.tgz
cd APC-3.1.9
/usr/local/php/bin/phpize
./configure --enable-apc --enable-apc-mmap \
--with-php-config=/usr/local/php/bin/php-config \
--prefix=/usr/local/apc
make
make install
cd ../
service php-fpm reload

 

二.用法

列举几个常用的APC函数(详细请查询php手册apc函数):

apc_clear_cache() 清除apc缓存内容,默认(无参数)时,只清除系统缓存,要清除用户缓存,需用’user’参数
apc_define_constants ( string key, array constants [, bool case_sensitive] ) 将数组constants以常量加入缓存
apc_load_constants (string Key) 取出常量缓存
apc_store ( string key, mixed var [, int ttl] ) 在缓存中保存数据,ttl为过期时间,store基于key,当key相同时,会覆盖原本数据
apc_fetch ( string key ) 获得apc_store保存的缓存内容
apc_delete ( string key ) 删除apc_store保存的内容
apc_cache_info() retrieves cached information (and meta-data) from apc’s data store
apc_sma_info()  retrieves apc’s shared memory allocation information

apc缓存利用举例:

$sql = "select a from b where tid=$tid";
$row = json_decode(apc_fetch('lnmpblog_'.md5($sql)), TURE);
if(empty($row)) {
    $query = mysql_query($sql);
    $row = mysql_fetch_first($query);
    $row = apc_store('lnmpblog_'.md5($sql), json_encode($row), 3600);
}

php的APC缓存类,请看本博文:

强大的PHP缓存类(支持基于文件缓存和eaccelerator、apc、xcache、memcache模块缓存)

 

三.php.ini配置项[APC]段详解

; alternative php cache 用于缓存和优化php中间代码

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字段值)。

 

四.apc的管理

到pecl.php.net下载apc源码包有个apc.php,copy到你的web server可以访问到的地方,浏览即可访问。

重视第四小节这个工具,非常有用。修改apc.php,设置用户名密码,登陆后可显示缓存的web详细目录的php文件。不登陆只显示文件名,无路径。

管理界面功能有:
1. refresh data
2. view host stats
3. system cache entries
4. user cache entries
5. version check

 


相关博文

  1. seedvirus
    2011年6月29日11:48

    不错,很详细

    • 菜菜
      2011年6月29日13:54

      最近针对此文还会补充更新

  2. 菜菜
    2011年6月29日13:51

    最近还会不断修改这篇文章

  3. 2012年4月21日16:32

    开了两个Wordpress,就吃满64M的APC缓存,PHP执行出错了

WordPress SEO fine-tune by Meta SEO Pack from Poradnik Webmastera