Zend Opcache 的最佳设置

开发模式下推荐，直接禁用 opcache 扩展更好：

opcache.revalidate_freq=0
opcache.validate_timestamps=1
opcache.max_accelerated_files=3000
opcache.memory_consumption=192
opcache.interned_strings_buffer=16
opcache.fast_shutdown=1

多台机器集群模式或者代码更新频繁时推荐，可以兼顾性能，方便代码更新：

opcache.revalidate_freq=300
opcache.validate_timestamps=1
opcache.max_accelerated_files=7963
opcache.memory_consumption=192
opcache.interned_strings_buffer=16
opcache.fast_shutdown=1

稳定项目推荐，性能最好：

opcache.revalidate_freq=0
opcache.validate_timestamps=0
opcache.max_accelerated_files=7963
opcache.memory_consumption=192
opcache.interned_strings_buffer=16
opcache.fast_shutdown=1

下面将是配置指令的简短说明。

opcache.enable boolean

启用操作码缓存。如果禁用此选项，则不会优化和缓存代码。 在运行期使用 ini_set() 函数只能禁用 opcache.enable 设置，不可以启用此设置。 如果在脚本中尝试启用此设置项会产生警告。

opcache.enable_cli boolean

仅针对 CLI 版本的 PHP 启用操作码缓存。 通常被用来测试和调试。

opcache.revalidate_freq integer

这个选项用于设置缓存的过期时间（单位是秒），当这个时间达到后，opcache 会检查你的代码是否改变，如果改变了 PHP 会重新编译它，生成新的 opcode，并且更新缓存。值为 0 表示每次请求都会检查你的 PHP 代码是否更新（这意味着会增加很多次 stat 系统调用，译注：stat 系统调用是读取文件的状态，这里主要是获取最近修改时间，这个系统调用会发生磁盘 I/O，所以必然会消耗一些 CPU 时间，当然系统调用本身也会消耗一些 CPU 时间）。可以在开发环境中把它设置为 0，生产环境下不用管，因为下面会介绍另外一个设置选项。

opcache.validate_timestamps boolean

当这个选项被启用（设置为 1），PHP 会在 opcache.revalidate_freq 设置的时间到达后检测文件的时间戳（timestamp）。

如果这个选项被禁用（设置为 0），opcache.revalidate_freq 会被忽略，PHP 文件永远不会被检查。这意味着如果你修改了你的代码，然后你把它更新到服务器上，再在浏览器上请求更新的代码对应的功能，你会看不到更新的效果，你必须得重新加载你的 PHP（使用 kill -SIGUSR2 强制重新加载）。

这个设定是不是有些蛋疼，但是我强烈建议你在生产环境中使用，why？因为当你在更新服务器代码的时候，如果代码较多，更新操作是有些延迟的，在这个延迟的过程中必然出现老代码和新代码混合的情况，这个时候对用户请求的处理必然存在不确定性。

opcache.max_accelerated_files integer

这个选项用于控制内存中最多可以缓存多少个 PHP 文件。这个选项必须得设置得足够大，大于你的项目中的所有 PHP 文件的总和。我的代码库大概有 6000 个 PHP 文件，所以我把这个值设置为一个素数 7963。

OPcache 哈希表中可存储的脚本文件数量上限。 真实的取值是在质数集合 { 223, 463, 983, 1979, 3907, 7963, 16229, 32531, 65407, 130987 } 中找到的第一个大于等于设置值的质数。 设置值取值范围最小值是 200，最大值在 PHP 5.5.6 之前是 100000，PHP 5.5.6 及之后是 1000000。

你可以运行 find . -type f -print | grep php | wc -l 这个命令来快速计算你的代码库中的 PHP 文件数。

opcache.memory_consumption integer

这个选项的默认值为 64MB，我把它设置为 192MB，因为我的代码很大。你可以通过调用 opcachegetstatus() 来获取 opcache 使用的内存的总量，如果这个值很大，你可以把这个选项设置得更大一些。

opcache.interned_strings_buffer integer

这是一个很有用的选项，但是似乎完全没有文档说明。PHP 使用了一种叫做字符串驻留（string interning）的技术来改善性能。例如，如果你在代码中使用了 1000 次字符串“foobar”，在 PHP 内部只会在第一使用这个字符串的时候分配一个不可变的内存区域来存储这个字符串，其他的 999 次使用都会直接指向这个内存区域。这个选项则会把这个特性提升一个层次——默认情况下这个不可变的内存区域只会存在于单个 php-fpm 的进程中，如果设置了这个选项，那么它将会在所有的 php-fpm 进程中共享。在比较大的应用中，这可以非常有效地节约内存，提高应用的性能。

这个选项的值是以兆字节（megabytes）作为单位，如果把它设置为 16，则表示 16MB，默认是 4MB，这是一个比较低的值。

opcache.max_wasted_percentage integer

浪费内存的上限，以百分比计。 如果达到此上限，那么 OPcache 将产生重新启动续发事件。

opcache.use_cwd boolean

如果启用，OPcache 将在哈希表的脚本键之后附加改脚本的工作目录， 以避免同名脚本冲突的问题。 禁用此选项可以提高性能，但是可能会导致应用崩溃。

opcache.revalidate_path boolean

如果禁用此选项，在同一个 include_path 已存在的缓存文件会被重用。 因此，将无法找到不在包含路径下的同名文件。

opcache.save_comments boolean

如果禁用，脚本文件中的注释内容将不会被包含到操作码缓存文件， 这样可以有效减小优化后的文件体积。 禁用此配置指令可能会导致一些依赖注释或注解的 应用或框架无法正常工作， 比如： Doctrine， Zend Framework 2 以及 PHPUnit。

opcache.load_comments boolean

如果禁用，则即使文件中包含注释，也不会加载这些注释内容。 本选项可以和 opcache.save_comments 一起使用，以实现按需加载注释内容。

opcache.fast_shutdown boolean

如果启用，则会使用快速停止续发事件。 所谓快速停止续发事件是指依赖 Zend 引擎的内存管理模块 一次释放全部请求变量的内存，而不是依次释放每一个已分配的内存块。

从 PHP 7.2.0 开始，此配置指令被移除。 快速停止的续发事件的处理已经集成到 PHP 中， 只要有可能，PHP 会自动处理这些续发事件。

opcache.enable_file_override boolean

如果启用，则在调用函数 file_exists()， is_file() 以及 is_readable() 的时候， 都会检查操作码缓存，无论文件是否已经被缓存。 如果应用中包含检查 PHP 脚本存在性和可读性的功能，这样可以提升性能。 但是如果禁用了 opcache.validate_timestamps 选项， 可能存在返回过时数据的风险。

opcache.optimization_level integer

控制优化级别的二进制位掩码。

opcache.inherited_hack boolean

在 PHP 5.3 之前的版本，OPcache 会存储代码中使用 DECLARE_CLASS 操作码 来实现继承的位置。当文件被加载之后，OPcache 会尝试使用当前环境来绑定被继承的类。 由于当前脚本中可能并不需要 DECLARE_CLASS 操作码，如果这样的脚本需要对应的操作码被定义时， 可能无法运行。

在 PHP 5.3 及后续版本中，此配置指令会被忽略。

opcache.dups_fix boolean

仅作为针对 “不可重定义类”错误的一种解决方案。

opcache.blacklist_filename string

OPcache 黑名单文件位置。 黑名单文件为文本文件，包含了不进行预编译优化的文件名，每行一个文件名。 黑名单中的文件名可以使用通配符，也可以使用前缀。 此文件中以分号（;）开头的行将被视为注释。

简单的黑名单文件可能如下所示：

; 将特定文件加入到黑名单
/var/www/broken.php
; 以字符 x 文件打头的文件
/var/www/x
; 通配符匹配
/var/www/*-broken.php

opcache.max_file_size integer

以字节为单位的缓存的文件大小上限。设置为 0 表示缓存全部文件。

opcache.consistency_checks integer

如果是非 0 值，OPcache 将会每隔 N 次请求检查缓存校验和。 N 即为此配置指令的设置值。 由于此选项对于性能有较大影响，请尽在调试环境使用。

opcache.force_restart_timeout integer

如果缓存处于非激活状态，等待多少秒之后计划重启。 如果超出了设定时间，则 OPcache 模块将杀除持有缓存锁的进程， 并进行重启。

如果选项 opcache.log_verbosity_level 设置为 2 或者 2 以上的数值，当发生重启时将在日志中记录一条警告信息。

opcache.error_log string

OPcache 模块的错误日志文件。 如果留空，则视为 stderr， 错误日志将被送往标准错误输出 （通常情况下是 Web 服务器的错误日志文件）。

opcache.log_verbosity_level integer

OPcache 模块的日志级别。 默认情况下，仅有致命级别（0）及错误级别（1）的日志会被记录。 其他可用的级别有：警告（2），信息（3）和调试（4）。

opcache.preferred_memory_model string

OPcache 首选的内存模块。 如果留空，OPcache 会选择适用的模块， 通常情况下，自动选择就可以满足需求。

可选值包括： mmap，shm, posix 以及 win32。

opcache.protect_memory boolean

保护共享内存，以避免执行脚本时发生非预期的写入。 仅用于内部调试。

opcache.mmap_base string

在 Windows 平台上共享内存段的基地址。 所有的 PHP 进程都将共享内存映射到同样的地址空间。 使用此配置指令避免“无法重新附加到基地址”的错误。

opcache.restrict_api string

仅允许路径是以指定字符串开始的 PHP 脚本调用 OPcache API 函数。 默认值为空字符串 ""，表示不做限制。

opcache.file_update_protection string

如果文件的最后修改时间距现在不足此项配置指令所设定的秒数，那么这个文件不会进入到缓存中。 这是为了防止尚未完全修改完毕的文件进入到缓存。 如果你的应用中不存在部分修改文件的情况，把此项设置为 0 可以提高性能。

opcache.huge_code_pages string

启用或者禁用将 PHP 代码（文本段）拷贝到 HUGE PAGES 中。 此项配置指令可以提高性能，但是需要在 OS 层面进行对应的配置。

opcache.lockfile_path string

用来存储共享锁文件的绝对路径（仅适用于 *nix 操作系统）。

__ string

出于对不同阶段的优化情况进行调试的目的，生成操作码转储。 设置为 0x10000 会在进行优化之前输出编译器编译后的操作码， 设置为 0x20000 会输出优化后的操作码。

opcache.file_cache string

配置二级缓存目录并启用二级缓存。 启用二级缓存可以在 SHM 内存满了、服务器重启或者重置 SHM 的时候提高性能。 默认值为空字符串 ""，表示禁用基于文件的缓存。

opcache.file_cache_only boolean

启用或禁用在共享内存中的 opcode 缓存。

opcache.file_cache_consistency_checks boolean

当从文件缓存中加载脚本的时候，是否对文件的校验和进行验证。

opcache.file_cache_fallback boolean

在 Windows 平台上，当一个进程无法附加到共享内存的时候， 使用基于文件的缓存，也即：opcache.file_cache_only=1。 需要显示的启用文件缓存。

Caution 不鼓励禁用此配置项， 禁用它可能会导致进程无法启动。

opcache.validate_permission boolean

针对当前用户，验证缓存文件的访问权限。

opcache.validate_root boolean

在 chroot 的环境中避免命名冲突。 为了防止进程访问到 chroot 环境之外的文件，应该在 chroot 的情况下启用这个选项。

opcache.preload string

指定要在服务器启动时期进行编译和缓存的 PHP 脚本文件， 这些文件也可能通过 include 或者 opcache_compile_file() 函数 来预加载其他文件。 所有这些文件中包含的实体，包括函数、类等，在服务器启动的时候就被加载和缓存， 对于用户代码来讲是“开箱可用”的。

附录：OPcache 配置选项