如何设置PHP7.0真实路径缓存大小提升性能-php教程-PHP中文网

php 7.0 的 realpath cache 需调大以提升性能，因默认值过小（16k/4k）且 ttl 过短（120秒或0），导致频繁磁盘i/o；建议设为 realpath_cache_size = 4096k、realpath_cache_ttl = 3600，并验证生效。

如何设置php7.0真实路径缓存大小提升性能

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，表示禁用缓存，切勿这么做。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

验证是否生效

写一段测试脚本确认配置已加载：

<?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 的收益。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！