PHP 7.0 的 Realpath Cache 需调大以提升性能，因默认值过小（16K/4K）且 TTL 过短（120秒或0），导致频繁磁盘I/O；建议设为 realpath_cache_size = 4096K、realpath_cache_ttl = 3600，并验证生效。
PHP 7.0 的 Realpath Cache 是一个容易被忽略但影响显著的性能开关。它不处理业务逻辑，却默默决定每次 include、require、file_exists 等路径操作是否要反复解析相对路径、访问磁盘、检查文件是否存在——尤其在大量加载类文件（如 Composer 自动加载）时，效果立竿见影。
为什么需要调大 Realpath Cache？
PHP 默认的 Realpath Cache 很小（通常仅 16K 或 4K），且 TTL（缓存有效期）极短（默认 120 秒或 0）。这意味着：
- 频繁的
__DIR__.'/../vendor/autoload.php'类路径计算会被重复执行； - 文件存在性判断（如框架自动探测配置文件）可能绕过缓存，直击磁盘；
- 在机械硬盘或高并发场景下，I/O 延迟会急剧放大，单请求多出几十毫秒开销。
如何正确配置（php.ini）
打开你的 php.ini 文件，添加或修改以下两项（推荐值适用于中等规模项目）：
- realpath_cache_size = 4096K（即 4MB）：足够缓存数千个常用路径，避免频繁淘汰；
- realpath_cache_ttl = 3600（即 1 小时）：平衡“代码更新及时性”与“缓存稳定性”，比默认 120 秒更实用。
注意：数值单位必须带 K（如 4096K），不能写成 4M 或数字 4096000；若设为 0，表示禁用缓存，切勿这么做。
立即学习“PHP免费学习笔记（深入）”；
验证是否生效
写一段测试脚本确认配置已加载：
<?php
var_dump([
'realpath_cache_size' => ini_get('realpath_cache_size'),
'realpath_cache_ttl' => ini_get('realpath_cache_ttl'),
'realpath_cache' => realpath_cache_get()
]);
执行后能看到当前缓存大小、TTL 值，以及已缓存的路径条目数（非空即表示启用成功）。
配套建议：避免缓存失效陷阱
Realpath Cache 不是“一劳永逸”的银弹，需配合运维习惯：
- 上线新代码后，若发现旧文件仍被加载（幽灵文件问题），可临时执行
opcache_reset()+ 清理 realpath 缓存（重启 PHP-FPM 最彻底）； - 开发阶段可将
realpath_cache_ttl设为5～30，方便调试；生产环境再调高； - 不要把
session.save_path或upload_tmp_dir指向 C:\Windows\Temp 这类系统路径——Win7 老机上会因权限和磁盘性能双重拖累，抵消 Realpath Cache 的收益。
