SymfonyAPCu缓存怎么用_Symfony内存缓存【详解】-php教程-PHP中文网

apcu 是 symfony 中用于单机内存缓存的驱动，读写快但不跨进程/服务器共享；需启用 apcu 扩展、配置 apc.enable_cli=1 和 apc.user_cache=1；须通过 psr-6 流程（getitem→set→save）操作，键名建议用下划线替代点号，避免超长或不可序列化值。

symfonyapcu缓存怎么用_symfony内存缓存【详解】

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')（该方法不存在）。

推荐写法（带自动回源与过期控制）：

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

$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')）。