-
opcache.enable
boolean
-
启用操作码缓存。如果禁用此选项,则不会优化和缓存代码。
在运行期使用 ini_set() 函数只能禁用
opcache.enable 设置,不可以启用此设置。
如果在脚本中尝试启用此设置项会产生警告。
-
opcache.enable_cli
boolean
-
仅针对 CLI 版本的 PHP 启用操作码缓存。
通常被用来测试和调试。
-
opcache.memory_consumption
integer
-
OPcache 的共享内存大小,以兆字节为单位。
-
opcache.interned_strings_buffer
integer
-
用来存储临时字符串的内存大小,以兆字节为单位。
PHP 5.3.0 之前的版本会忽略此配置指令。
-
opcache.max_accelerated_files
integer
-
OPcache 哈希表中可存储的脚本文件数量上限。
真实的取值是在质数集合
{ 223, 463, 983, 1979, 3907, 7963, 16229, 32531, 65407, 130987 }
中找到的第一个大于等于设置值的质数。
设置值取值范围最小值是 200,最大值在 PHP 5.5.6 之前是 100000,PHP 5.5.6 及之后是 1000000。
-
opcache.max_wasted_percentage
integer
-
浪费内存的上限,以百分比计。
如果达到此上限,那么 OPcache 将产生重新启动续发事件。
-
opcache.use_cwd
boolean
-
如果启用,OPcache 将在哈希表的脚本键之后附加改脚本的工作目录,
以避免同名脚本冲突的问题。
禁用此选项可以提高性能,但是可能会导致应用崩溃。
-
opcache.validate_timestamps
boolean
-
如果启用,那么 OPcache 会每隔 opcache.revalidate_freq 设定的秒数
检查脚本是否更新。
如果禁用此选项,你必须使用 opcache_reset() 或者
opcache_invalidate() 函数来手动重置 OPcache,也可以
通过重启 Web 服务器来使文件系统更改生效。
-
opcache.revalidate_freq
integer
-
检查脚本时间戳是否有更新的周期,以秒为单位。
设置为 0 会导致针对每个请求, OPcache 都会检查脚本更新。
如果
opcache.validate_timestamps
配置指令设置为禁用,那么此设置项将会被忽略。
-
opcache.revalidate_path
boolean
-
如果禁用此选项,在同一个 include_path
已存在的缓存文件会被重用。
因此,将无法找到不在包含路径下的同名文件。
-
如果禁用,脚本文件中的注释内容将不会被包含到操作码缓存文件,
这样可以有效减小优化后的文件体积。
禁用此配置指令可能会导致一些依赖注释或注解的
应用或框架无法正常工作,
比如: Doctrine, Zend Framework 2 以及 PHPUnit。
-
如果禁用,则即使文件中包含注释,也不会加载这些注释内容。
本选项可以和 opcache.save_comments
一起使用,以实现按需加载注释内容。
-
opcache.fast_shutdown
boolean
-
如果启用,则会使用快速停止续发事件。
所谓快速停止续发事件是指依赖 Zend 引擎的内存管理模块
一次释放全部请求变量的内存,而不是依次释放每一个已分配的内存块。
-
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 黑名单文件位置。
黑名单文件为文本文件,包含了不进行预编译优化的文件名,每行一个文件名。
黑名单中的文件名可以使用通配符,也可以使用前缀。
此文件中以分号(;)开头的行将被视为注释。
简单的黑名单文件可能如下所示:
-
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_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。
需要显示的启用文件缓存。
-
opcache.validate_permission
boolean
-
针对当前用户,验证缓存文件的访问权限。
-
opcache.validate_root
boolean
-
在 chroot 的环境中避免命名冲突。
为了防止进程访问到 chroot 环境之外的文件,应该在 chroot 的情况下启用这个选项。