PHP require_once 过多导致 IO 等待时间过长该怎么优化？

优化 PHP require_once 导致的 IO 等待，最推荐的做法是启用 OPcache 扩展并配合 Composer 自动加载机制，适用场景为 PHP 5.5 及以上版本的生产环境，风险边界在于移除 require_once 前需确保文件不会重复声明。

先说结论：require_once 频繁调用会触发文件系统 stat 检查和已加载文件列表比对，启用 OPcache 可消除大部分开销。

先定位：使用性能分析工具确认 include/require 调用次数和耗时占比。
先做：开启 OPcache 扩展，优化 realpath_cache 大小，改用自动加载。
再验证：通过 opcache_get_status 和请求耗时对比确认 IO 等待下降。

命令速用版

以下命令和配置用于快速检查当前 PHP 环境状态及开启关键优化项。

# 检查 OPcache 是否启用
php -m | grep -i opcache

# 查看当前 include 路径配置
php -r "echo get_include_path();"

# 临时测试脚本加载耗时（需结合 xhprof 或 blackfire 使用）
php -r "time(); require_once 'test.php'; time();"

php.ini 关键配置建议：

opcache.enable=1
opcache.memory_consumption=128
opcache.max_accelerated_files=10000
opcache.validate_timestamps=0

为什么会这样

require_once 性能瓶颈主要源于每次调用都需要查询内部已加载文件列表并执行文件系统 stat 操作。PHP 官方文档指出 require_once 会检查文件是否已被包含，避免重复声明，但这个检查过程涉及 IO 操作。

在没有 OPcache 的情况下，每次请求都需要读取磁盘文件、解析语法并编译成 opcode。即使有 OPcache，require_once 仍需维护 included_files 数组。当项目文件数量巨大且调用链复杂时，累积的 stat 系统调用和数组查找会导致 CPU 和 IO 等待时间显著增加。

分步处理

按顺序执行以下操作，每步完成后检查配置是否生效。

步骤 1：启用并配置 OPcache

OPcache 将预编译脚本存储到共享内存，避免重复读取和解析。编辑 php.ini，确保 opcache.enable 设置为 1。生产环境建议将 opcache.validate_timestamps 设为 0，避免每次请求检查文件修改时间，但发布代码后需手动重启 PHP-FPM 或清除缓存。

步骤 2：优化 realpath_cache

PHP 缓存文件路径解析结果以减少 stat 调用。在 php.ini 中增加 realpath_cache_size 和 realpath_cache_ttl。

realpath_cache_size=16M
realpath_cache_ttl=7200

步骤 3：迁移至自动加载机制

使用 Composer 的 PSR-4 自动加载替代手动 require_once。自动加载仅在类被实例化时加载文件，减少不必要的包含操作。修改代码移除显式的 require_once，确保类名与文件路径符合规范。

步骤 4：清理冗余包含

扫描代码库，查找被多次调用的 require_once。如果确认文件无副作用且不会重复声明函数，可改为 require，但需谨慎评估风险。

怎么验证是否生效

通过以下方法确认优化措施是否降低了 IO 等待和脚本执行时间。

检查 OPcache 状态

使用 PHP 内置函数查看缓存命中率和使用情况。

<?php
print_r(opcache_get_status());
?>

关注 memory_usage 和 hit_rate 指标，命中率接近 100% 表示配置有效。

对比请求耗时

使用 ab 或 wrk 工具进行压力测试，对比优化前后的 Request per Second 和平均响应时间。公开资料中没有看到可靠的量化数据表明具体提升百分比，但通常能观察到响应时间波动减小。

监控系统 IO

使用 top 或 iostat 命令观察服务器 wa (IO wait) 值。优化后 wa 值应有所下降，表明磁盘读取压力减轻。

常见坑

实施优化时需注意以下风险点，避免引发生产故障。

函数重声明错误：盲目将 require_once 改为 require 可能导致 Fatal Error: Cannot redeclare function。必须确保文件只被加载一次。
配置文件失效：设置 opcache.validate_timestamps=0 后，代码更新不会立即生效，需制定重启 PHP-FPM 或清除 OPcache 的发布流程。
路径解析差异： realpath_cache 优化依赖于绝对路径，代码中混用相对路径可能导致缓存命中率低。
内存不足： opcache.memory_consumption 设置过大可能占用过多服务器内存，需根据实际脚本数量调整。

常见问题

require 和 require_once 性能差多少？

require_once 比 require 多一次文件存在性和已加载状态检查。在 OPcache 开启且缓存命中情况下，两者差异较小，但在高并发冷启动场景下 require_once 开销更明显。

开启 OPcache 后还需要优化 require_once 吗？

需要。OPcache 解决了脚本解析开销，但 require_once 的逻辑检查仍然存在。减少不必要的包含调用仍能降低 CPU 周期消耗。

realpath_cache 大小设置多少合适？

默认值通常较小。对于大型项目，建议设置为 16M 或更高，具体数值需根据项目文件数量和目录深度通过监控调整。

参考来源

PHP Manual - require_once: https://www.php.net/manual/en/function.require-once.php
PHP Manual - OPcache Configuration: https://www.php.net/manual/en/opcache.configuration.php