新秀建站教程

宝塔面板内存缓存器Opcache配置优化修改及常见配置选项详解

教程简介

起因还是因为 Opcache 内存使用超过了缓存器的默认值,所以要去修改其配置。虽然馒头侠发现 PHP 官网有 Opcache 所有配置参数的解释(戳我进入传送门),却发现居然"404"了,所以就复制过来,并注释几个常用的配置,以便小伙伴们可以了解一下。

宝塔修改OPcache内存大小

根据下面的说明,只需要修改[php.ini](https://www.dujin.org/tag/php-ini/ "View all posts in php.ini")[opcache](https://www.dujin.org/tag/opcache/ "View all posts in opcache").memory_consumption一项即可,此参数的值代表占用内存的大小,单位是 MB,PHP7.0 之前默认值为64,PHP7.0 之后默认值为128。建议根据服务器内存情况来设置,比如馒头侠的博客服务器的内存是 2G,使用发现 Opcache 内存占用超过默认值不多,我将此参数的值设置为192-256左右,为后期的增长预留一部分。

opcache.png

讲讲最常见的几点,上面内存已经说过了,再说3个:

  • opcache.enable此参数的值为 1 代表开启 Opcache,值为 0 代表关闭 Opcache,默认值为 1
  • opcache.interned_strings_buffer此参数为[临时字符串](https://www.dujin.org/tag/%e4%b8%b4%e6%97%b6%e5%ad%97%e7%ac%a6%e4%b8%b2/ "View all posts in 临时字符串")存储内存,值的单位是 MB,默认值为 8,建议根据自己需求设置即可,至少馒头侠目前8M还够用。
  • opcache.max_accelerated_filesZend 引擎在第一次执行某 PHP 文件后,会将该文件的 OPcode 存储在哈希表中,之后的请求直接从哈希表中找到相应文件的 OPcode,从而达到性能优化,而此配置选项决定了可以存储的 PHP 文件数量上限。这个有点奇怪,不是默认值,而馒头侠并未修改。

OPcache 配置选项

这些函数的行为受 php.ini 中的设置影响。

名字默认可修改范围更新日志
opcache.enable"1"PHP_INI_ALL
opcache.enable_cli"0"PHP_INI_SYSTEM在 PHP 7.1.2 至 7.1.6 (含)的版本,默认值是"1"
opcache.memory_consumption"128"PHP_INI_SYSTEM在 PHP 7.0.0 之前,默认值是 "64"
opcache.interned_strings_buffer"8"PHP_INI_SYSTEM在 PHP 7.0.0 之前,默认值是 "4"
opcache.max_accelerated_files"10000"PHP_INI_SYSTEM在 PHP 7.0.0 之前,默认值是 "2000"
opcache.max_wasted_percentage"5"PHP_INI_SYSTEM
opcache.use_cwd"1"PHP_INI_SYSTEM
opcache.validate_timestamps"1"PHP_INI_ALL
opcache.revalidate_freq"2"PHP_INI_ALL
opcache.revalidate_path"0"PHP_INI_ALL
opcache.save_comments"1"PHP_INI_SYSTEM
opcache.load_comments"1"PHP_INI_ALL从 PHP 7.0.0 开始被移除
opcache.fast_shutdown"0"PHP_INI_SYSTEM从 PHP 7.2.0 开始被移除
opcache.enable_file_override"0"PHP_INI_SYSTEM
opcache.optimization_level"0x7FFFBFFF"PHP_INI_SYSTEM从 PHP 5.6.18 开始,默认值从 0xFFFFFFFF 修改为 0x7FFFBFFF
opcache.inherited_hack"1"PHP_INI_SYSTEM自 PHP 7.3.0 被移除
opcache.dups_fix"0"PHP_INI_ALL
opcache.blacklist_filename""PHP_INI_SYSTEM
opcache.max_file_size"0"PHP_INI_SYSTEM
opcache.consistency_checks"0"PHP_INI_ALL
opcache.force_restart_timeout"180"PHP_INI_SYSTEM
opcache.error_log""PHP_INI_SYSTEM
opcache.log_verbosity_level"1"PHP_INI_SYSTEM
opcache.preferred_memory_model""PHP_INI_SYSTEM
opcache.protect_memory"0"PHP_INI_SYSTEM
opcache.mmap_baseNULLPHP_INI_SYSTEM
opcache.restrict_api""PHP_INI_SYSTEM
opcache.file_update_protection"2"PHP_INI_ALL
opcache.huge_code_pages"0"PHP_INI_SYSTEM
opcache.lockfile_path"/tmp"PHP_INI_SYSTEM
opcache.opt_debug_level"0"PHP_INI_SYSTEM
opcache.file_cacheNULLPHP_INI_SYSTEM从 PHP 7.0.0 开始支持
opcache.file_cache_only"0"PHP_INI_SYSTEM从 PHP 7.0.0 开始支持
opcache.file_cache_consistency_checks"1"PHP_INI_SYSTEM从 PHP 7.0.0 开始支持
opcache.file_cache_fallback"1"PHP_INI_SYSTEM从 PHP 7.0.0 开始支持,仅适用于 Windows 平台
opcache.validate_permission"0"PHP_INI_SYSTEM从 PHP 7.0.14 开始支持
opcache.validate_root"0"PHP_INI_SYSTEM从 PHP 7.0.14 开始支持
opcache.preload""PHP_INI_SYSTEM从 PHP 7.4.0 开始支持
opcache.preload_user""PHP_INI_SYSTEM从 PHP 7.4.0 开始支持

OPcache配置常见函数注释

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 已存在的缓存文件会被重用。 因此,将无法找到不在包含路径下的同名文件。

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.phpOPcache 配置

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 会选择适用的模块, 通常情况下,自动选择就可以满足需求。

可选值包括: mmapshmposix 以及 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 操作系统)。

opcache.opt_debug_level 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.preload_user string

考虑到安全因素,禁止以 root 用户预加载代码。该指令方便以其他用户预加载。

原创文章,作者:馒头侠,如若转载,请注明出处:https://www.mantouxia.com/1206.html
pacificrack新上架最便宜洛杉矶VPS,1核512M内存4元/月,QN机房,1Gbps大带宽
« 上一篇 03-06
WordPress胖鼠采集插件自动采集和发布微信公众号,简书,知乎等任意网站详细图文教程
下一篇 » 03-06

发表评论

作者信息

热门文章

标签TAG

热评文章