使用 apcu_store() 前须确认 APCu 已启用且 apcu.enabled=1；缓存前需校验变量可序列化；TTL 为软过期，须检查 apcu_fetch() 返回值；多进程下缓存隔离，应采用带版本号的 key 实现逻辑清除。
用 apcu_store() 缓存变量前先确认 APCu 已启用
PHP 本身不自带用户变量缓存，得靠扩展。现在最常用的是 apcu（APC 的继任者），但不是所有环境默认开启。直接调 apcu_store() 却没装扩展，会报 Fatal error: Uncaught Error: Call to undefined function apcu_store()。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -m | grep apcu或在phpinfo()页面搜apcu，确认已加载 - 若未启用，Debian/Ubuntu 上执行
sudo apt install php-apcu，然后重启 PHP-FPM 或 Apache - 注意：PHP 8.0+ 默认不带
apc扩展，apcu是唯一推荐选项；别再试apc_store()，它已废弃且不兼容 - 开发环境启用了，生产环境还得检查
apcu.enabled=1和apcu.shm_size=64M是否写进apcu.ini—— 否则缓存可能“存进去就消失”
缓存数组或对象时必须注意序列化陷阱
apcu_store() 只支持标量、数组、对象（需可序列化），但不是所有对象都能安全缓存。比如 PDO 实例、Closure、资源句柄（resource）一存就报 Warning: apcu_store(): Unable to store variable。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 缓存前用
is_serializable($var)（PHP 8.3+）或简单serialize($var) !== false做兜底判断 - 数据库查询结果这类数组，直接存没问题；但含
DateTime对象的数组，建议先$arr['updated_at'] = $dt->format('Y-m-d H:i:s')转成字符串再缓存 - 别对整个 Laravel 的
Collection或 Symfony 的Response对象直接apcu_store()—— 它们内部常含闭包或资源，会静默失败或只存空值 - 如果必须缓存复杂对象，显式实现
__sleep()，剔除不可序列化属性
设置过期时间不能只靠 $ttl 参数
apcu_store('key', $val, 300) 看似设了 5 分钟过期，但 APCu 的 TTL 是“软过期”：缓存项不会自动删除，只是下次 apcu_fetch() 时检测是否超时并返回 false。更麻烦的是，APCu 的共享内存满时，会按 LRU 清理——哪怕没超时也会被踢掉。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 永远在
apcu_fetch()后检查返回值是否为false，而不是依赖isset()或!empty() - 对关键数据，加一层“逻辑过期”：缓存值里嵌入时间戳，读取时额外判断业务层面是否仍有效
- 避免把
$ttl设得过大（如 86400），APCu 不擅长长期驻留；高频更新的数据，$ttl设 60–300 更稳 - 用
apcu_cache_info()['num_hits'] / (apcu_cache_info()['num_hits'] + apcu_cache_info()['num_misses'])监控命中率，低于 0.7 就得查是不是 TTL 太短或 key 冲突
多进程下 apcu_clear_cache() 不清其他进程缓存
APCu 的缓存是进程级的（PHP-FPM 每个 worker 独立一份），所以你在 CLI 脚本里调 apcu_clear_cache()，对 Web 请求的 FPM 进程完全没影响。这也是为什么改了配置后刷新页面还是旧数据——你清的不是同一个内存块。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- Web 场景要清缓存，必须在同类型 SAPI 下操作：FPM 请求里清，或用
curl触发一个专清缓存的 HTTP 接口 - 别在部署脚本里写
php -r "apcu_clear_cache();"就以为万事大吉，它只清 CLI 进程的那份 - 需要全局失效时，改用“带版本号的 key”：如
apcu_store("user_123_v2", $data, 300)，通过切换v2→v3实现逻辑清除 - APCu 没有跨进程广播机制，别指望它像 Redis 那样一条命令清全站
真正麻烦的从来不是“怎么存”，而是“什么时候失效”和“在哪一个进程里失效”。APCu 的轻量是优势，也是它的边界——越靠近底层，越得自己扛住一致性问题。
