如何正確設置realpath_cache_size 函數來有效優化PHP 文件路徑解析速度？

M66 2025-07-28

1. realpath_cache_size 的作用

在 PHP 中，realpath() 函数用于解析给定文件路径并返回该路径的绝对路径。在多次调用 realpath() 时，PHP 默认会缓存解析过的文件路径，以避免每次都重复计算，进而提升性能。realpath_cache_size 就是用来控制这个缓存的大小。

当文件路径解析的缓存被填满时，PHP 会清空缓存并重新计算文件路径。如果文件路径非常频繁地被调用，适当增加缓存的大小可以减少缓存清空的频率，从而减少文件系统操作的次数，提升应用程序的整体性能。

2. 如何设置 realpath_cache_size

要配置 realpath_cache_size，你可以在 PHP 的 php.ini 配置文件中进行设置。默认情况下，realpath_cache_size 的值为 16KB，这对于大多数应用程序来说足够使用。然而，在一些需要频繁解析文件路径的应用中，增大缓存的大小可以显著改善性能。

在 php.ini 文件中设置 realpath_cache_size，例如：

<span><span><span class="hljs-attr">realpath_cache_size</span></span><span> = </span><span><span class="hljs-number">64</span></span><span>k
</span></span>

这将把缓存大小设置为 64KB。如果你需要更大的缓存，可以设置为更高的值，如：

<span><span><span class="hljs-attr">realpath_cache_size</span></span><span> = </span><span><span class="hljs-number">128</span></span><span>k
</span></span>

3. 如何查看当前 realpath_cache_size 的值

如果你不确定当前的 realpath_cache_size 值，可以通过 phpinfo() 或者 ini_get() 函数来查看。例如：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">ini_get</span></span><span>(</span><span><span class="hljs-string">'realpath_cache_size'</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

这将返回当前配置的缓存大小。

4. 设置 realpath_cache_ttl 配合优化

除了 realpath_cache_size 外，realpath_cache_ttl 也是一个与文件路径缓存相关的重要配置。realpath_cache_ttl 定义了缓存中路径数据的有效时间，单位为秒。默认情况下，TTL 为 120 秒，即缓存的路径数据将在 120 秒后失效。

你可以根据需要调整这个参数的值。如果你的文件路径变化不频繁，可以增加 TTL 的时间，使缓存数据能够保持更长时间，从而减少缓存清空和重新计算的频率：

<span><span><span class="hljs-attr">realpath_cache_ttl</span></span><span> = </span><span><span class="hljs-number">3600</span></span><span>
</span></span>

这将使路径缓存的有效期为 3600 秒（即 1 小时）。

5. 何时需要调整 realpath_cache_size？

增大 realpath_cache_size 并不是总是最佳选择，只有在以下情况下才有必要：

高频文件路径解析：如果你的应用程序涉及大量的文件路径解析（如文件系统扫描、大量的 include 和 require 调用等），增加缓存大小可以显著提高性能。
大型应用程序：对于包含大量文件或目录的大型项目，合理配置 realpath_cache_size 可以减少文件路径解析的开销。
高负载环境：在高负载的生产环境中，增大 realpath_cache_size 可以减少文件系统访问，提高响应速度。

6. 注意事项

增加 realpath_cache_size 时，需要确保服务器的内存足够，因为过大的缓存会占用更多的内存。
在一些极端情况下，过大的缓存可能导致 PHP 内存使用量过高，因此需要根据实际情况进行调整。
频繁的缓存清空可能会导致性能问题，因此尽量根据应用需求平衡缓存大小和 TTL 设置。