PHP没有内置“文件夹缓存”功能，所谓“文件夹缓存”实为开发者基于APCu、OPcache等工具实现的应用层方案，如用APCu缓存scandir结果或配置OPcache加速PHP脚本加载。
PHP本身不提供“文件夹缓存”这个功能
这是个常见误解。PHP没有内置的、类似Redis或APCu那种针对“整个文件夹”的缓存机制。所谓“文件夹缓存”，实际是开发者用PHP代码+外部存储（如OPcache、APCu、文件系统、Redis）来缓存“某个目录下文件内容”或“目录结构”的结果，属于应用层设计，不是PHP语言特性。
如果你看到教程说“开启PHP文件夹缓存”，大概率是指以下之一：
- 启用OPcache（只缓存PHP脚本字节码，跟文件夹无关）
- 用
scandir()+apcu_store()缓存某目录的文件列表 - 把整个目录打包成.phar并让OPcache加载（间接提升读取性能）
- Web服务器（如Nginx）配置了对特定路径的静态资源缓存，被误认为是PHP行为
想缓存某个文件夹下的文件列表？用APCu最直接
比如你频繁调用scandir('/var/www/uploads')查上传文件，每次IO开销大，可以用APCu暂存结果。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确保APCu已启用：
extension=apcu.so（Linux）或extension=php_apcu.dll（Windows），且apc.enabled=1 - 加唯一键名，避免键冲突：
'dir_list_' . md5('/var/www/uploads') - 设置合理过期时间，别用
0（永不过期），否则目录变更后无法自动刷新 - 注意权限：PHP进程需有读取目标目录的权限，否则
scandir()会失败并触发警告
示例片段：
$dir = '/var/www/uploads';
$key = 'dir_list_' . md5($dir);
$list = apcu_fetch($key);
if ($list === false) {
$list = array_values(array_filter(scandir($dir), function($f) {
return !in_array($f, ['.', '..']);
}));
apcu_store($key, $list, 60); // 缓存60秒
}
想加速PHP脚本自身加载？配好OPcache才是关键
很多人混淆“缓存文件夹”和“缓存PHP文件”。真正影响执行速度的是OPcache——它把编译后的字节码存在共享内存里，跳过重复解析和编译。
必须检查的配置项（php.ini）：
-
opcache.enable=1（CLI模式默认关闭，Web模式通常开） -
opcache.memory_consumption=128（单位MB，小站点64够用，大项目建议128+） -
opcache.max_accelerated_files=4000（若项目PHP文件超此数，会触发哈希冲突降级） -
opcache.revalidate_freq=2（每2秒检查一次文件修改，设0表示永不检查→开发时慎用） -
opcache.validate_timestamps=1（生产环境可设0+配合opcache_reset()手动刷新）
验证是否生效：opcache_get_status()返回数组中opcache_enabled为true，且opcache_statistics里num_cached_scripts > 0。
别踩这些坑
几个高频翻车点：
- 在Docker里启用了OPcache但没挂载
/tmp为tmpfs，导致共享内存失效 → 改用opcache.file_cache落盘（性能略低但稳定） - 用
file_get_contents()反复读同一配置文件，却没加APCu缓存，误以为“PHP慢” → 先测IO耗时，再决定是否缓存 - 缓存目录结构时忽略符号链接或权限变化，导致
scandir()返回空或报错 → 加@抑制警告，并用is_readable()预检 - 在CLI脚本里用APCu，却忘了它默认不启用（
apc.enable_cli=0）→ 开发调试时记得设为1
缓存逻辑越靠近具体使用场景，越容易出边界问题。与其追求“整个文件夹缓存”，不如明确问自己：我到底在反复读什么？是文件名？文件内容？还是文件mtime？答案不同，方案就完全不同。
