PHP APC 配置详解

APC是Alternative PHP Cache的简称，是 PHP 的一个免费公开的优化代码缓存。它用来提供免费，公开并且强健的架构来缓存和优化 PHP 的中间代码。

APC模块的参数配置

Name Default Changeable Changelog
apc.enabled 1 PHP_INI_ALL
apc.shm_segments 1 PHP_INI_SYSTEM
apc.shm_size 30 PHP_INI_SYSTEM
apc.optimization 0 PHP_INI_ALL
apc.num_files_hint 1000 PHP_INI_SYSTEM
apc.ttl 0 PHP_INI_SYSTEM
apc.gc_ttl 3600 PHP_INI_SYSTEM
apc.cache_by_default On PHP_INI_SYSTEM
apc.filters "" PHP_INI_SYSTEM
apc.mmap_file_mask "" PHP_INI_SYSTEM
apc.slam_defense 0 PHP_INI_SYSTEM
apc.file_update_protection 2 PHP_INI_SYSTEM
apc.enable_cli 0 PHP_INI_SYSTEM > APC 3.0.6

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。

APC的安装:

一般是从下载源代码，然后phpize来编译安装,安装完以后在加上php.ini里加上：

extension=apc.so

同时，记得要在PHP.ini中打开opcode cache的开关：

apc.cache_by_default = on

同时也可以通过apc.filters让APC只对特定范围的动态程序进行opcode缓存。

使用php apc模块需要注意的几点

在maillist中看到Rasmus的一段对于 APC模块的发言。作为APC的作者，他的见解应该是很有参考价值的：

APC will probably be 20-30% faster, but if you are writing to it frequently it can cause problems. The APC cache is best for things that change very rarely. And by very rarely I mean days, not hours or minutes.

Because of the way APC does an anonymous file-backed mmap where I unlink the file at startup to get process-death protection, it isn’t easy to get at the cache from a separate standalone command line script. That can be solved by mmap’ing slightly differently, but in the default config your approach won’t work.

-- Rasmus

就是说APC不适合用于频繁写的场合，你最好只用它来保存那种几天都不会更改的内容。否则出了莫名其妙的问题就不好怎么解释了。

在以前的应用中，我确实有将apc用在频繁写的场合，偶尔会出现内存耗尽，进而引起所有http请求卡死，形式一发不可收拾整个服务器当掉。所以现在我仅仅用apc来缓存opcode的php代码，不在程序中显式的调用它，算是相安无事。