APCu 是 Symfony 中用于单机内存缓存的驱动，读写快但不跨进程/服务器共享；需启用 apcu 扩展、配置 apc.enable_cli=1 和 apc.user_cache=1；须通过 PSR-6 流程（getItem→set→save）操作，键名建议用下划线替代点号，避免超长或不可序列化值。
APCu 是 Symfony 中常用的单机内存缓存驱动，适合开发和轻量生产环境。它不依赖外部服务，读写极快，但仅限当前 PHP 进程或 Web 服务器实例可见——多台服务器或 CLI 与 Web 请求之间无法共享。
启用 APCu 缓存适配器
Symfony 默认在支持 APCu 的环境中自动启用 cache.adapter.apcu，但需确保：
- PHP 已安装并启用
apcu扩展（运行php -m | grep apcu验证） -
apc.enable_cli=1（如需 CLI 环境下也生效，修改php.ini） - 未禁用 APCu 用户缓存：
apc.enabled=1且apc.user_cache=1
配置示例（config/packages/cache.yaml）：
framework:
cache:
app: cache.adapter.apcu
default_apcu_provider: 'apcu' # 显式声明提供者，避免自动探测失败在代码中安全使用 APCu 缓存
必须通过 PSR-6 流程操作：先 getItem()，再 set()，最后 save()。不能直调 $cache->set('key', 'value')（该方法不存在）。
推荐写法（带自动回源与过期控制）：
$value = $this->cache->get('user_profile_123', function (ItemInterface $item) {
$item->expiresAfter(3600); // 1 小时 TTL，语义清晰、无时区风险
return $this->userRepository->findProfile(123);
});手动写入示例：
$item = $this->cache->getItem('stats.total');
$item->set(42)->expiresAfter(600);
$this->cache->save($item); // save() 是真正落盘的关键一步键名与兼容性注意事项
APCu 本身对键名较宽松，但为保持与 PSR-6 兼容（尤其切换后端时），仍需注意：
- 避免键中含
.或/，建议统一替换为_（如user.profile.123→user_profile_123） - 键名长度不宜过长（APCu 默认限制约 4K，超长可能被截断或静默失败）
- 值必须可序列化；含闭包、资源或不可序列化对象会报错
调试与验证技巧
APCu 缓存不落磁盘，无法查文件，但可通过以下方式确认是否生效：
- 用
apcu_info()查总命中/未命中数：var_dump(apcu_info()['num_hits'], apcu_info()['num_misses']); - 在控制器中加日志：首次访问打“MISS”，后续打“HIT”
- 用 Web Profiler 查看 “Cache” 面板的命中率统计（需开启 debug 模式）
- 临时改 TTL 为 1 秒，观察是否准时失效
APCu 不支持标签（tag）失效，如需批量清除，请改用 TagAwareAdapter 包裹，或接受全量清空（apcu_clear_cache('user_cache')）。
