PHP APC缓存配置、使用详解

一、APC缓存简介

APC，全称是Alternative PHP Cache，官方翻译叫”可选PHP缓存”。它为我们提供了缓存和优化PHP的中间代码的框架。 APC的缓存分两部分:系统缓存和用户数据缓存。

系统缓存

它是指APC把PHP文件源码的编译结果缓存起来，然后在每次调用时先对比时间标记。如果未过期，则使用缓存的中间代码运行。默认缓存

3600s(一小时)。但是这样仍会浪费大量CPU时间。因此可以在php.ini中设置system缓存为永不过期(apc.ttl=0)。不过如果这样设置，改运php代码后需要重启WEB服务器。目前使用较多的是指此类缓存。

用户数据缓存

缓存由用户在编写PHP代码时用apc_store和apc_fetch函数操作读取、写入的。如果数据量不大的话，可以一试。如果数据量大，使用类似memcache此类的更加专著的内存缓存方案会更好

缓存key生成规则

APC的缓存中的每个slot都会有一个key，key是

apc_cache_key_t结构体类型，除了key相关的属性，关键是h字段的生成。 h字段决定了此元素落于slots数组的哪一个位置。对于用户缓存和系统缓存，其生成规则不同。 用户缓存通过apc_cache_make_user_key函数生成key。通过用户传递进来的key字符串，依赖PHP内核中的hash函数（PHP的hashtable所使用的hash函数：zend_inline_hash_func），生成h值。

系统缓存通过apc_cache_make_file_key函数生成key。通过APC的配置项apc.stat的开关来区别对待不同的方案。在打开的情况下，即

apc.stat= On 时，如果被更新则自动重新编译和缓存编译后的内容。此时的h值是文件的device和inode相加所得的值。在关闭的情况下，即apc.stat=off时，当文件被修改后，如果要使更新的内容生效，则必须重启Web服务器。此时h值是根据文件的路径地址生成，并且这里的路径是绝对路径。即使你是使用的相对路径，也会查找PG(include_path)定位文件，以取得绝对路径，所以使用绝对路径会跳过检查，可以提高代码的效率。

添加缓存过程

以用户缓存为例，apc_add函数用于给APC缓存中添加内容。如果key参数为字符串中，APC会根据此字符串生成key，如果key参数为数组，APC会遍历整个数组，生成key。根据这些key，APC会调用_apc_store将值存储到缓存中。由于这是用户缓存，当前使用的缓存为apc_user_cache。执行写入操作的是apc_cache_make_user_entry函数，其最终调用apc_cache_user_insert执行遍历查询和写入操作。与此对应，系统缓存使用apc_cache_insert执行写入操作，其最终都会调用_apc_cache_insert。

不管是用户缓存还是系统缓存，大体的执行过程类似，步骤如下：

通过求余操作，定位当前key的在slots数组中的位置： cache->slots[key.h % cache->num_slots];

在定位到slots数组中的位置后，遍历当前key对应的slot链表，如果存在slot的key和要写入的key匹配或slot过期，清除当前slot。

在最后一个slot的后面插入新的slot。

二、APC模块安装

A.WINDOWS下安装APC

第一步：下载php_apc.dll 在http://pecl.php.net/package/apc 要与php版本对应 将php_apc.dll放入你的ext目录

第二步：让php.ini支持apc扩展模块。 然后打开php.ini 加入：

extension=php_apc.dll
apc.rfc1867 = on
apc.max_file_size = 100M
upload_max_filesize = 100M
post_max_size = 100M
//以上参数可自己定义

第三步：检查是否支持PHP APC apc_store apc_fetch

查看phpinfo中是否有apc相关项

B.LIUNX下安装APC

第一步：下载和安装

wget http://pecl.php.net/get/APC-3.1.8.tgz
tar -zxvf APC-3.1..tgz cd APC-3.1.
/usr/local/php/bin/phpize
./configure --enable-apc --enable-mmap --enable-apc-spinlocks --disable-apc-pthreadmutex --with-php-config=/usr/local/php/bin/php-config
make
sudo make install

第二步：配置APC

在/usr/local/php/etc/php.ini 加入以下配置项：

extension = "apc.so" ;
;APC setting
apc.enabled =
apc.shm_segments =
apc.shm_size = 64M
apc.optimization =
apc.num_files_hint =
apc.ttl =
apc.gc_ttl =
apc.cache_by_default = on

第三步：检查安装是否成功

重启apache 或者 /usr/local/php/sbin/php-fpm restart

查看phpinfo中是否有apc相关项

三、配置参数详解和使用总结

1）.APC模块的参数配置详解

apc.enabled  布尔型

apc.enabled 可以被设成 0 来禁用 APC。这主要是有用的，当 APC 被静态编译入 PHP 时，因为没有其它方法来禁用它（当编译为 DSO 的时候，可以将 php.ini 中的 extension 行注释掉）。

apc.shm_segments  整型

对编译缓存分配共享内存块的数量。如果APC用光了共享内存，而且你已经设置apc.shm_size为系统允许的最大值的情况下，你可以试着去提高这个参数的值。

apc.shm_size  整型

每个共享内存块的大小是以MB为单位的。在默认情况下，一些系统（包括大多数BSD变种系统）的共享内存块的大小限制的很低。

apc.optimization  整型

优化等级。设为0则禁用优化，越高的值使用越强有力的优化。期待有适度的速度上的改进。这个还是实验性质的。

apc.num_files_hint  整型

对在你的Web服务器上被包含和请求的不同的源文件的数量的提示。如果你无法确定，设置为0或者省略；这个设置主要可能用于有成千的源文件的站点。

apc.ttl  整型

当一个缓存条目在缓存区的位置被另一个条目需要时，我们需要考虑的是这个缓存条目在缓存区的位置被允许空闲的秒数。将这个参数设置为0意味着你的缓存可能充满不新鲜的条目，同时导致新的条目无法被缓存。

apc.gc_ttl  整型

缓存条目在垃圾收集列表中存活的秒数。这个值提供了出错保护在执行一个缓存源文件，而同时服务器进程死了的事件中。如果那个源文件被修改，内存分配给旧版本的缓存条目将不会被回收，直到这个参数设定的TTL值到的时候。设置为0就是禁止这个特性。

apc.cache_by_default  布尔型

默认为On，但可以被设置为Off并和以加号开头的apc.filters配合使用，文件仅仅在匹配过滤器时才被缓存。

apc.filters  字符串

一个以逗号分割的POSIX扩展正则表达式的列表。如果任何模式匹配源文件名，这个文件将不会被缓存。注意用来匹配的文件名是传递给 include/require 的文件名，而不是绝对路径。如果正则表达式的第一个字符是 + ，则这个表达式就意味着任何匹配表达式的文件将会被缓存，如果第一个字符是 - 则任何匹配都不会被缓存。 - 是默认值，所以可以被省略。

apc.mmap_file_mask  字符串 （这段实在不太懂，所以没有翻译）

If compiled with MMAP support by using --enable-mmap this is the mktemp-style file_mask to pass to the mmap module for determing whether your mmap'ed memory region is going to be file-backed or shared memory backed. For straight file-backed mmap, set it to something like/tmp/apc.XXXXXX (exactly 6 Xs). To use POSIX-style shm_open/mmap put a .shm somewhere in your mask. e.g. /apc.shm.XXXXXX You can also set it to /dev/zero to use your kernel's/dev/zero interface to anonymous mmap'ed memory. Leaving it undefined will force an anonymous mmap.

apc.slam_defense  整型

在非常繁忙的服务器上，无论你启动服务还是修改文件，你都会导致一种多进程都试图在同一个时间缓存同一个文件的竞争。这个选项设置了进程跳过试图去缓存一个未被缓存的文件的百分比。或者可以把这个想象成一个单独进程跳过缓存的机率。例如，设置apc.slam_defense为75就意味着进程有75%的机率不去缓存未被缓存的文件。所以，设置的越高，越能减少缓存的碰撞机率。设置为0则禁用这个特性。

apc.file_update_protection  整型

当你在一个运行着的服务器上修改文件时，你应该执行原子操作。也就是，先写一个临时文件，当写完后再重命名（mv）这个文件到它的最终位置。许多文本编辑器，cp，tar和其他一些类似程序都不是这样操作的。这就意味着有机会去访问和（缓存）文件，当这个文件还在被写的情况下。apc.file_update_protection的设置使得缓存标记新文件的延迟。默认值是2，意味着如果发现文件的修改时间距离访问时间不到2秒，文件将不会被缓存。访问写到一半的文件的不幸用户将会看到离奇的情况，但至少这种情况不是持续的。如果你确信你经常使用原子操作来更新你的文件，你可以关闭这个保护通过设置这个参数为0。如果你的系统充满io操作，并导致更新程序花费超过2秒，你可能需要去增大这个值。

apc.enable-cli  整型

大多是为了测试和调试。

为CLI版本的PHP开启动APC功能。一般来说，将不会想到为每一个CLI请求创建，移植和放弃APC的缓存，但对于各种测试情况，这是很容易的为了CLI版本开启APC。

2）.使用总结

1,使用Spinlocks锁机制，能够达到最佳性能。

2,APC提供了apc.php，用于监控与管理APC缓存。不要忘记修改管理员名和密码

3,APC默认通过mmap匿名映射创建共享内存，缓存对象都存放在这块”大型”的内存空间。由APC自行管理该共享内存

4,我们需要通过统计调整apc.shm_size、apc.num_files_hints、apc.user_entries_hint的值。直到最佳

5,好吧，我承认apc.stat = 0 可以获得更佳的性能。要我做什么都可以接受.

6,PHP预定义常量，可以使用apc_define_constants()函数。不过据APC开发者介绍说pecl hidef性能更佳，抛异define吧，它是低效的。

7,函数apc_store()，对于系统设置等PHP变量，生命周期是整个应用(从httpd守护进程直到httpd守护进程关闭)，使用APC比Memcached会更好。必竟不要经过网络传输协议tcp。

8,APC不适于通过函数apc_store()缓存频繁变更的用户数据，会出现一些奇异现象。

四、使用实例

引用initphp框架的APC缓存类

<?php
if
class Apc{
    /**
     * Apc缓存-设置缓存
     * 设置缓存key，value和缓存时间
     * @param  string $key   KEY值
     * @param  string $value 值
     * @param  string $time  缓存时间
     */ 脚本学堂 http://www.jbxue.com
    public function set_cache($key, $value, $time = ) {
        if ($time == ) $time = null; //null情况下永久缓存
        return apc_store($key, $value, $time);;
    } 

    /**
     * Apc缓存-获取缓存
     * 通过KEY获取缓存数据
     * @param  string $key   KEY值
     */
    public function get_cache($key) {
        return apc_fetch($key);
    }
    /**
     * Apc缓存-清除一个缓存
     * 从memcache中删除一条缓存
     * @param  string $key   KEY值
     */
    public function clear($key) {
        return apc_delete($key);
    }
    /**
     * Apc缓存-清空所有缓存
     * 不建议使用该功能
     * @return
     */
    public function clear_all() {
        apc_clear_cache('user'); //清除用户缓存
        return apc_clear_cache(); //清楚缓存
    }
    /**
     * 检查APC缓存是否存在
     * @param  string $key   KEY值
     */
    public function exists($key) {
        return apc_exists($key);
    }
    /**
     * 字段自增-用于记数
     * @param string $key  KEY值
     * @param int    $step 新增的step值
     */
    public function inc($key, $step) {
        return apc_inc($key, (int) $step);
    }
    /**
     * 字段自减-用于记数
     * @param string $key  KEY值
     * @param int    $step 新增的step值
     */
    public function dec($key, $step) {
        return apc_dec($key, (int) $step);
    }
    /**
     * 返回APC缓存信息
     */
    public function info() {
        return apc_cache_info();
    }
}