如何在PHP环境中配置OPcache？提升PHP性能的OPcache配置方法

爱谁谁

发布时间：2025-08-26 14:49:01

375人浏览过

来源于php中文网

原创

配置OPcache可显著提升PHP性能，核心是启用并调优php.ini中的OPcache参数，确保生产环境缓存高效稳定。

如何在php环境中配置opcache？提升php性能的opcache配置方法

在PHP环境中配置OPcache，核心目的就是通过缓存预编译的PHP脚本字节码，来显著减少每次请求时的解析和编译开销。这就像给PHP代码加了个“记忆体”，让它跑得更快、更省力。自PHP 5.5版本起，OPcache就已经内置了，通常情况下，你只需要在

php.ini

里简单地启用它，然后根据实际应用场景进行一些关键参数的微调，就能立竿见影地看到性能提升。这不仅仅是优化，对于高并发的生产环境来说，它几乎是不可或缺的。

解决方案

要配置OPcache，我们首先需要找到并编辑PHP的配置文件

php.ini

。这个文件通常位于你的PHP安装路径下，或者你可以通过

phpinfo()

函数来查找它的位置。

启用OPcache: 在
```
php.ini
```
文件中找到或添加以下两行：
```
opcache.enable=1
opcache.enable_cli=1
```
```
opcache.enable=1
```
是为Web请求启用OPcache，而
```
opcache.enable_cli=1
```
则是为PHP命令行脚本启用，这对于使用Composer、Artisan（Laravel）或Symfony Console等工具的项目来说非常重要。我个人在开发环境里经常会忘记开
```
enable_cli
```
，结果跑命令行脚本的时候发现还是慢吞吞的，后来才发现是这个小细节没注意到。
核心配置参数： 接下来，我们需要根据服务器资源和应用特点来调整一些关键参数。这些参数直接影响OPcache的效率和稳定性。
- ```
opcache.memory_consumption
```
  ：分配给OPcache的共享内存大小，单位是MB。例如：
```
opcache.memory_consumption=128
```
  这个值很关键。如果太小，缓存空间很快就会被填满，导致旧文件被频繁踢出，命中率下降；如果太大，又会浪费服务器内存。我的经验是，对于中小型应用，128MB或256MB是个不错的起点，大型应用可能需要更多。
- ```
opcache.interned_strings_buffer
```
  ：用于存储PHP内部字符串（如类名、方法名、常量等）的内存大小，单位是MB。例如：
```
opcache.interned_strings_buffer=8
```
  这有助于减少内存重复使用，提高性能。特别是在使用大型框架时，这个值稍微大一点会更有益。
- ```
opcache.max_accelerated_files
```
  ：OPcache可以缓存的最大脚本文件数量。例如：
```
opcache.max_accelerated_files=10000
```
  如果你的项目文件很多（包括框架、库和自己的业务代码），确保这个值足够大，否则一些文件可能无法被缓存。我一般会设置一个比较大的值，比如10000甚至20000，以防万一。
- ```
opcache.revalidate_freq
```
  ：检查脚本文件更新的频率，单位是秒。例如：
```
opcache.revalidate_freq=0
```
  在开发环境，你可能希望它频繁检查（比如
```
60
```
  秒），这样修改代码后能更快看到效果。但在生产环境，为了极致性能，我强烈建议设为
```
0
```
  。这意味着OPcache不会自动检查文件更新，你需要手动清理缓存。
- ```
opcache.validate_timestamps
```
  ：是否验证文件时间戳。例如：
```
opcache.validate_timestamps=0
```
  当
```
revalidate_freq=0
```
  时，这个参数通常也设为
```
0
```
  。它告诉OPcache完全信任缓存，不再检查文件的修改时间。这能带来微小的性能提升，但代价是，代码更新后必须手动重置OPcache才能生效。
- ```
opcache.fast_shutdown
```
  ：启用快速关闭序列，这可以减少请求结束时的内存清理开销。例如：
```
opcache.fast_shutdown=1
```
  通常建议开启。
- ```
opcache.enable_file_override
```
  ：是否允许OPcache在运行时覆盖文件。例如：
```
opcache.enable_file_override=0
```
  这个参数比较特殊，通常保持
```
0
```
  即可。在某些特定场景下，比如使用某些老旧的PHP框架或CMS，可能需要设置为
```
1
```
  来解决兼容性问题，但一般不推荐。
- ```
opcache.optimization_level
```
  ：位掩码，用于控制OPcache执行的优化级别。例如：
```
opcache.optimization_level=0xffffffff
```
  这个值控制了OPcache对字节码进行优化的程度。
```
0xffffffff
```
  表示启用所有优化，这是推荐的设置。

完整示例配置（

php.ini

片段）：

立即学习“PHP免费学习笔记（深入）”；

[opcache]
opcache.enable=1
opcache.enable_cli=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=10000
opcache.revalidate_freq=0
opcache.validate_timestamps=0
opcache.fast_shutdown=1
opcache.enable_file_override=0
opcache.optimization_level=0xffffffff
; opcache.blacklist_filename=/path/to/your/opcache_blacklist.txt ; 如果需要，可以指定黑名单文件

重启Web服务器/PHP-FPM： 修改
```
php.ini
```
后，务必重启你的Web服务器（如Apache）或PHP-FPM服务，这样新的配置才能生效。这是最容易被遗忘的一步，我见过太多人改了配置却没重启服务，然后抱怨OPcache没生效的例子。

如何判断OPcache是否已启用并有效工作？

配置完OPcache之后，最关键的一步就是确认它是否真的在运行，并且工作状态良好。这不仅仅是看一眼配置，更是要了解它的“健康状况”。

最直接的方法就是通过PHP的

phpinfo()

函数。创建一个简单的PHP文件（例如

info.php

），内容如下：

在浏览器中访问这个文件，然后搜索“OPcache”。如果你能看到一个独立的OPcache区块，并且其中

opcache.enable

的值是

On

，那就说明它已经成功启用了。

不过，

phpinfo()

只能告诉你OPcache是否启用，却不能提供详细的运行数据。要深入了解OPcache的工作状态，我个人更倾向于使用

opcache_get_status()

函数。这个函数会返回一个包含大量有用信息的数组，比如缓存命中率、内存使用情况、缓存的文件数量等等。

你可以创建一个更专业的OPcache状态监控脚本，例如：

知元AI

AI智能语音聊天对讲问答 AI绘画 AI写作 AI创作助手工具

下载

';
    print_r(opcache_get_status(false)); // 设置为false可以不显示脚本列表，让输出更简洁
    echo '

'; } else { echo 'OPcache extension is not loaded.'; } ?>

访问这个脚本，你会在输出中看到：

opcache_enabled
: 是否启用。
cache_full
: 缓存是否已满。
opcache_hit_rate
: 缓存命中率，这个值越高越好，理想情况下应该接近100%。
misses
: 未命中缓存的请求次数。
blacklist_misses
: 因在黑名单中而未被缓存的请求次数。
used_memory
, free_memory
, wasted_memory
: 内存使用情况。如果
```
wasted_memory
```
很高，可能意味着
```
memory_consumption
```
设置不合理或缓存策略有问题。
num_cached_scripts
: 当前缓存的脚本文件数量。
start_time
, last_restart_time
: OPcache服务的启动和最后重启时间。

通过这些数据，你就能清晰地判断OPcache是否在高效工作。如果命中率很低，或者内存经常爆满，那就说明你的配置可能需要进一步优化了。我发现这个小工具在日常运维中特别有用，一眼就能看出缓存是不是快满了，或者命中率是不是低得可怜，省去了很多盲目猜测的时间。

在命令行环境下，你也可以简单地运行

php -v

，如果看到输出中有“with Zend OPcache vX.X.X”，也说明OPcache已启用。或者使用

php -i | grep opcache

来快速查看OPcache相关的配置项。

生产环境中OPcache的最佳实践有哪些？

在生产环境中，OPcache的配置和管理需要更加谨慎和精细，以确保它能发挥最大效能，同时不引入新的问题。我的经验是，以下几点是构建高性能、高可用PHP应用的关键。

激进的缓存策略：
```
opcache.revalidate_freq=0
```
和
opcache.validate_timestamps=0
这几乎是生产环境的标配。将这两个参数都设置为
```
0
```
，意味着OPcache会完全信任其内部缓存，不再去检查文件系统上的脚本是否更新。这消除了文件I/O的开销，带来了极致的性能。 但是， 这也意味着你的代码更新后，OPcache不会自动感知到。你必须手动清除OPcache，否则用户看到的将是旧版本的代码。我见过不少团队因为部署后忘了清缓存，结果新代码没生效，用户还在用旧版本，场面一度很尴尬。
完善的部署流程与缓存清理机制 既然OPcache不会自动更新，那么在每次代码部署后，清除OPcache就成了部署流程中不可或缺的一环。有几种常见的清理方法：
- 重启PHP-FPM服务： 这是最彻底、最简单的方法。重启PHP-FPM会清空所有OPcache内容。在自动化部署脚本中加入
```
sudo service php-fpm restart
```
  （或
```
systemctl restart php-fpm
```
  ）是常见的做法。
- 通过Web请求调用
  opcache_reset()
  ：创建一个只有内部网络或特定IP才能访问的PHP脚本，其中包含
```
opcache_reset();
```
  。部署后访问这个URL，即可清除缓存。
- 使用命令行工具： 某些框架（如Laravel）提供了清除OPcache的命令，或者你可以直接通过CLI调用
```
opcache_reset()
```
  。我个人更偏爱在部署脚本中重启PHP-FPM，因为它简单粗暴，而且能确保所有缓存都得到刷新，避免了潜在的遗漏。
合理的内存分配 (
```
opcache.memory_consumption
```
) 通过监控
```
opcache_get_status()
```
的输出，特别是
```
used_memory
```
和
```
free_memory
```
，来动态调整
```
opcache.memory_consumption
```
。如果
```
used_memory
```
总是接近
```
memory_consumption
```
，并且
```
cache_full
```
经常为
```
true
```
，那么就需要增加内存。如果你的应用文件多，或者框架复杂，别吝啬这点内存，它能换来实打实的性能提升。通常，我会从256MB开始，然后根据实际负载和缓存文件数量进行调整。
优化
```
opcache.interned_strings_buffer
```
对于大量使用字符串操作、或者依赖大型框架（如Symfony、Laravel）的应用，
```
opcache.interned_strings_buffer
```
也需要适当调大。这些框架在运行时会生成和使用大量的内部字符串，一个足够大的缓冲区可以有效减少内存碎片和提高性能。我通常会设置到16MB甚至32MB。
利用
```
opcache.blacklist_filename
```
排除不必要的缓存 有些文件你可能不希望被OPcache缓存，比如开发或测试工具、一次性脚本、或者频繁变动的配置文件。你可以创建一个黑名单文件（例如
```
opcache_blacklist.txt
```
），每行一个正则表达式或文件路径，然后将
```
opcache.blacklist_filename
```
指向这个文件。例如，
```
opcache_blacklist.txt
```
内容：
```
/var/www/html/dev-tools/*
/var/www/html/temp/*.php
```
这样可以避免缓存那些不常访问或不应该缓存的文件，节省宝贵的OPcache内存空间。比如我的一些本地开发工具脚本，就不希望它被缓存，避免不必要的麻烦。
监控与告警 将OPcache的状态（特别是命中率、内存使用率）纳入你的服务器监控体系。当命中率异常下降、内存接近耗尽时，能够及时收到告警，这样你就能在问题影响用户之前采取行动。

遇到OPcache配置问题或性能不佳时如何排查？

即使是经验丰富的开发者，在OPcache配置或优化过程中也可能遇到一些意想不到的问题。排查这些问题，需要一套系统性的方法。

确认OPcache是否真的启用并生效 这是最基础也是最容易出错的一步。回到我们之前提到的方法，通过
```
phpinfo()
```
或
```
opcache_get_status()
```
脚本，确认
```
opcache.enable
```
为
```
On
```
，并且
```
opcache_enabled
```
为
```
true
```
。同时，检查
```
opcache_get_status()
```
输出中的
```
num_cached_scripts
```
是否在持续增长，
```
opcache_hit_rate
```
是否健康。如果
```
num_cached_scripts
```
一直是0，或者命中率极低，那么OPcache可能根本没工作，或者工作不正常。
检查
```
php.ini
```
路径和Web服务器/PHP-FPM是否重启
- php.ini
  路径：运行
```
php --ini
```
  命令，确认你修改的是当前PHP版本实际加载的
```
php.ini
```
  文件。在一些复杂的服务器环境中，可能存在多个
```
php.ini
```
  文件，导致你修改的不是生效的那个。
- 重启服务： 再次强调，修改
```
php.ini
```
  后，Web服务器（如Apache）或PHP-FPM服务必须重启才能使配置生效。有时候，你可能只重启了Web服务器，但没有重启PHP-FPM，导致OPcache配置没有更新。
内存不足或文件数量超限
- 内存： 查看
```
opcache_get_status()
```
  中的
```
used_memory
```
  和
```
free_memory
```
  。如果
```
used_memory
```
  接近
```
opcache.memory_consumption
```
  ，并且
```
cache_full
```
  为
```
true
```
  ，那么就需要增加
```
opcache.memory_consumption
```
  的值。
- 文件数量： 检查
```
num_cached_scripts
```
  是否接近
```
opcache.max_accelerated_files
```
  。如果是，增加
```
opcache.max_accelerated_files
```
  。如果文件数量已满，新的脚本就无法被缓存，导致性能下降。
文件变更未生效（最常见的问题） 如果你在生产环境设置了
```
opcache.revalidate_freq=0
```
和
```
opcache.validate_timestamps=0
```
，那么代码更新后必须手动清除OPcache。如果新代码没有生效，首先要检查部署脚本是否正确执行了
```
opcache_reset()
```
或重启了PHP-FPM。此外，还要检查文件权限。PHP进程是否有权限读取最新的文件？如果PHP进程无法读取新