简体中文
简体中文
在 PHP 中，每当你调用类似 include、require、file_exists 或 is_file 等文件操作函数时，PHP 都需要解析给定路径的真实绝对路径（real path）。这个解析过程涉及到文件系统的查询，特别是在使用符号链接（symlinks）或相对路径时。
为了减少系统调用的开销，PHP 引入了一个“realpath 缓存”，用于缓存路径解析的结果。realpath_cache_size 就是这个缓存的大小限制，单位是字节。默认值通常为 16K，在小型项目中可能已经足够，但在大型项目中则容易迅速被占满。
PHP 的 realpath 缓存是一种内存中的哈希表，用来存储路径解析的结果。每次 PHP 脚本需要解析路径时，都会先查找缓存：
如果缓存命中，直接返回缓存值，节省系统调用；
如果缓存未命中，则进行系统调用，解析路径，并将结果放入缓存中；
如果缓存已满，则会淘汰旧的缓存项。
这个机制虽然简单，但在文件结构复杂、依赖众多的项目中意义重大。例如，一个使用自动加载（如Composer autoloader）的项目可能在一次请求中加载上百个文件，每一个 require 都会触发路径解析。如果缓存不足，则可能每个请求都在重复进行相同的解析，带来不必要的性能损耗。
假设有如下代码片段：
<code> <?php for ($i = 0; $i < 1000; $i++) { require '/var/www/gitbox.net/project/lib/module' . ($i % 10) . '/Class.php'; } </code>在这个例子中，尽管只有10个不同的路径，但如果 realpath 缓存过小，PHP 会在每次 require 时都重新解析路径，导致额外的I/O开销。而一旦缓存命中率高，就能显著减少解析次数，从而提高整体执行效率。
可以通过 PHP 的 phpinfo() 页面查看当前的 realpath 缓存配置和使用情况，也可以使用如下代码片段动态查看缓存的使用情况：
<code> <?php print_r(realpath_cache_get()); </code>要调整缓存大小，只需在 php.ini 文件中增加或修改以下配置：
<code> realpath_cache_size = 128k </code>对于大型框架（如 Laravel、Symfony 等）或运行在高并发环境中的 PHP-FPM 项目，推荐设置为 128k 或更高，以保障缓存不会频繁失效。
除了缓存大小，realpath_cache_ttl 也是一个相关参数，它指定缓存条目的存活时间，单位为秒。默认值为 120 秒。
<code> realpath_cache_ttl = 300 </code>在部署频繁、文件结构变化较多的开发环境中，可以适当缩短这个值；在生产环境中，为了提高性能，通常可以设得更高。
