高并发下include变慢主因是路径解析、stat()和realpath()调用频繁及opcache配置不当；应使用绝对路径、禁用不必要的_once、预热关键文件并调优opcache参数。
为什么 include 在高并发下会变慢
PHP 的 include 和 require 不是简单“读文件”，每次调用都会触发完整路径解析、open() 系统调用、stat() 检查、opcode 缓存（OPcache）查找，甚至可能触发 realpath cache 刷新。当多个请求同时包含大量相同文件（比如框架的 vendor/autoload.php 或配置文件），磁盘 I/O 和 realpath 查找会成为瓶颈，尤其在 NFS 或容器挂载卷上更明显。
常见错误现象：strace 显示大量 stat("/path/to/file.php") 调用；opcache_get_status()['opcache_statistics']['opcache_hit_rate'] 低于 95%；lsof -p $PID | grep php | wc -l 持续飙升。
- 确保 OPcache 启用且
opcache.enable=1、opcache.enable_cli=0（Web SAPI 下必须为 1） - 关闭
opcache.revalidate_freq=0（开发环境可设为 2，生产必须为 0） - 增大
opcache.max_accelerated_files（默认 4000 不够，建议 20000+） - 避免在循环里动态拼接路径调用
include，如include $dir . '/'. $name . '.php'
include_once 和 require_once 的真实开销在哪
它们比 include 多一层“已加载文件列表”全局哈希查找，看似省事，实则在高并发下因锁竞争（尤其是 PHP 7.4 之前）和字符串哈希计算反而更慢。不是“用一次就安全”，而是“多一次判断就多一次成本”。
使用场景：仅在确实存在重复包含风险时（如插件系统、条件加载）才用；绝大多数框架入口、类自动加载、配置加载都应改用单次 include 或直接由 autoloader 处理。
立即学习“PHP免费学习笔记（深入）”；
- 删除所有非必要的
include_once，换成include并确保加载顺序可控 - 检查 Composer autoloader 是否已覆盖该文件——如果是，直接删掉手写的
include_once 'vendor/autoload.php' - 若必须用
_once，确保路径是绝对路径（相对路径会触发多次 realpath 计算） - PHP 8.0+ 中
include_once锁优化明显，但仍有额外哈希开销，不推荐盲目替换
用 opcache_compile_file() 预热关键文件
OPcache 默认只在首次请求时编译文件，冷启动或部署后第一批请求必然卡顿。手动预热可把编译阶段前置到部署脚本中，让首请求直接命中缓存。
注意：该函数不执行代码，只编译并存入共享内存；它不会触发 __autoload 或副作用逻辑，适合纯类/函数定义文件。
- 在部署后执行：
php -r "opcache_compile_file('/var/www/app/config/database.php');" - 批量预热：用
find /var/www/app -name '*.php' -not -path '*/tests/*' | xargs -I{} php -r "opcache_compile_file('{}');" - 避免预热路由文件、控制器或含
echo/header()的脚本——它们不该进 OPcache - 确认
opcache.preload已启用（PHP 7.4+），它比手动opcache_compile_file()更高效，但需 preload 脚本统一管理
路径写法对性能的影响远超想象
PHP 解析 include 'foo.php' 时，会按 include_path 逐个目录查找，每轮都做 stat()。而 include __DIR__ . '/foo.php' 是绝对路径，跳过查找，快一个数量级。
常见错误：用 dirname(__FILE__)（兼容性差）、拼接字符串未加 / 导致路径错乱、在循环中重复计算 __DIR__。
- 统一用
__DIR__（PHP 5.3+），不用dirname(__FILE__) - 路径结尾不加斜杠，拼接时显式补上：
include __DIR__ . '/lib/helper.php'; - 避免
include '../config/db.php'这类相对路径——它强制每次重新解析当前工作目录 - 若项目结构固定，考虑将常用路径提前定义为常量：
define('CONFIG_DIR', __DIR__ . '/config');
真正卡住高并发的，往往不是代码逻辑，而是那一连串 stat() 和 realpath() 调用。路径写死、OPcache 配置拉满、_once 去掉、关键文件预热——这四件事做完，include 就不再是个瓶颈。别信“自动优化”，每个路径、每次 once、每行配置，都要亲手看过才作数。
