最简文件缓存用file_put_contents和file_get_contents实现：先写含时间戳的JSON数据，读取时用filemtime校验TTL是否过期，路径用sys_get_temp_dir()统一管理，并通过crc32分目录避免单目录文件过多。
用 file_put_contents + file_get_contents 实现最简文件缓存
PHP 没装 Redis 或 APCu？又不想引入复杂库？直接用文件系统是最轻量、最可控的缓存起点。核心逻辑就两步：写缓存时加时间戳，读缓存时先校验过期。
关键不是“能不能存”，而是“怎么避免读到脏数据”——所以每次读取前必须检查 mtime 和预设的 TTL（比如 300 秒）。
-
file_put_contents($cacheFile, json_encode(['data' => $value, 'time' => time()]))，别漏了时间戳 - 读取后必须用
filemtime($cacheFile)判断是否超时，不能只靠文件存在与否 - 缓存路径建议统一放在
sys_get_temp_dir() . '/myapp_cache/'，避免权限问题 - 注意
json_encode失败会返回false，要判断再写入，否则缓存文件内容为空但不报错
为什么不用 apcu_store 而选文件？看这三点
APCu 确实快，但它在 CLI 模式下默认不共享缓存（每个进程独立），FPM 下也受 apc.enable_cli 配置限制；而文件缓存天然跨进程、跨请求、跨 PHP-FPM worker，对调试和一致性更友好。
- CLI 脚本跑定时任务时，
apcu_store写的缓存很可能在下一次请求里读不到 - 开发环境没开 APCu 扩展？文件缓存自动降级，代码不用改
- 调试时直接
cat缓存文件就能看到原始值和写入时间，比apcu_fetch后var_dump直观得多
serialize vs json_encode：选哪个存 PHP 变量？
如果只缓存数组、字符串、数字这些简单类型，json_encode 更安全；一旦涉及对象、资源或闭包，必须用 serialize，但代价是反序列化可能触发 __wakeup 或执行任意代码（尤其缓存内容不可信时）。
立即学习“PHP免费学习笔记（深入）”；
- 推荐默认用
json_encode+json_decode($str, true)，兼容性好，无反序列化风险 - 若需缓存对象且确定可信，用
serialize，但务必配对使用unserialize，且禁用unserialize_callback_func - 注意
json_encode会丢掉空数组的键名（如['a' => []]变成{'a':[]}），不影响大多数场景，但若依赖键顺序或类型严格匹配，得测清楚
缓存失效难维护？加一层“键名哈希”和“目录分级”
直接把用户 ID 当文件名（如 "user_123"）会导致单目录下文件爆炸，Linux ext4 对单目录 >10 万文件性能明显下降。简单方案：取键名的 crc32 前两位做子目录。
- 缓存路径生成示例：
$dir = sprintf('%s/%02x', $baseDir, crc32($key) & 0xff); - 写之前确保目录存在：
mkdir($dir, 0755, true) - 清理旧缓存别用
glob()扫全量，改成按时间轮询scandir($dir)+filemtime判断，避免阻塞 - 不要在高并发写同一键时不做锁——两个进程同时写同一个缓存文件，可能产生竞态，用
fopen(..., 'c')+flock包一层更稳妥
真正麻烦的从来不是“怎么存”，而是“什么时候删”和“删不干净怎么办”。哪怕只是个简单文件缓存，TTL 校验、目录结构、并发写保护这三块漏掉任一，上线后都容易变成定时抖动源。
