APCu扩展需手动安装并启用，配置正确后仍需注意内存限制、无精确TTL、多进程缓存隔离等问题；它仅适用于单进程内高速临时缓存，不支持跨进程同步或持久化。
APCu 扩展没装好，apcu_store() 直接报 Call to undefined function apcu_store()
PHP 8.5 默认不带 APCu，得手动装扩展。光 pecl install apcu 不够，还得确认 extension=apcu.so（Linux/macOS）或 extension=php_apcu.dll（Windows）已写进 php.ini，且不在 ;extension=... 注释行里。
装完重启 PHP 服务（不是 Apache/Nginx），再跑 php -m | grep apcu 或 phpinfo() 页面搜 “APCu” 确认加载成功。常见坑是：装了但没启用、启用了但用的是 CLI 的 php.ini 而不是 FPM 的、或者系统有多个 PHP 版本，改错了配置文件。
apcu_store() 存不了大数组，一存就返回 false 且没报错
APCu 默认共享内存只有 32MB（apc.shm_size=32M），且单个值不能超过 apc.max_file_size（默认 1MB）。存一个含图片 Base64 的数组？大概率静默失败。
检查和调优建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
apcu_sma_info()查剩余内存和碎片情况 - 在
php.ini中调大apc.shm_size（如128M），注意这是进程级共享内存，别设太高挤占系统资源 - 避免直接缓存大对象；先
json_encode()压缩再存，或改用apcu_add()避免覆盖时的竞态 - 存之前加判断：
if (apcu_store($key, $data) === false) { error_log("APCu store failed for $key"); }
用户数据缓存失效快，apcu_fetch() 经常返回 false
APCu 没内置 TTL 过期机制——它靠“内存淘汰”和“手动清理”维持，不是 Redis 那种精确过期。你没设过期时间，它也可能被新数据挤掉；设了 $ttl 参数，也只是“最多保留多久”，不保证一定活到那时。
实际用法要点：
-
apcu_store($key, $value, $ttl)的$ttl单位是秒，设0表示永不过期（但依然可能被内存回收） - 高频读写场景下，别依赖
$ttl做业务逻辑判断；用apcu_exists($key)+apcu_fetch()组合更稳妥 - 用户登录态这类关键数据，建议加一层“逻辑过期”：缓存值里自带
expires_at时间戳，取出来先校验再用 - 别把 APCu 当持久化存储用——进程重启、OPcache 清理、或内存满都会丢数据
FPM 多 worker 下，apcu_clear_cache() 清不掉其他进程的数据
APCu 的共享内存是 per-process 的，不是全局。你在一个 FPM worker 里调 apcu_clear_cache()，只清掉当前 worker 的缓存，其他 worker 还拿着旧数据。这会导致“明明清了缓存，页面还是旧的”这种迷惑现象。
应对方式很实际：
- 除非调试，否则别用
apcu_clear_cache()；它清的是整个缓存池，影响太大 - 按 key 清：用
apcu_delete($key)或apcu_delete(['key1', 'key2']) - 批量 key 管理：给用户数据加统一前缀，比如
user_123_profile，删时用apcu_delete(apcu_get_keys('user_123_')) - 如果真要全量刷新（如部署后），得配合外部信号或文件锁，让所有 worker 主动 reload 或重置自己的缓存区
APCu 的边界很清晰：它是 PHP 进程内的高速暂存，不是分布式缓存。想跨进程同步、精确过期、大容量存储，它扛不住——这时候该换 Redis 或 Memcached 了。
