开发环境用FilesystemAdapter，生产环境优先选RedisAdapter（分布式场景）或ApcuAdapter（单机高频元数据）；禁用生产文件缓存，避免I/O瓶颈与并发丢数据。
缓存后端选型：Filesystem vs Redis vs APCu 怎么选
直接说结论：开发环境用 FilesystemAdapter，生产环境优先选 RedisAdapter 或 ApcuAdapter（取决于是否共享内存）。别在生产用文件缓存，I/O 拖慢响应且并发写入容易丢数据。
常见错误现象：Cache::getItem() 返回空、缓存命中率始终为 0、多台 Web 服务器间缓存不一致——基本都是后端选错或配置没生效。
-
ApcuAdapter仅限单机 PHP-FPM 进程内共享，重启 PHP 就清空，适合高频读、低敏感度的元数据（如路由映射） -
RedisAdapter支持分布式、过期自动清理、原子操作，适合会话、用户权限、API 响应等跨请求/跨机器场景 -
FilesystemAdapter不依赖扩展，但必须确保cache_dir可写且路径不暴露在 Web 根目录下（如避免放在public/cache）
如何正确初始化 Symfony Cache 实例
别手写 new Adapter —— Symfony Cache 组件设计上鼓励用工厂模式统一管理实例。直接 new 会导致无法复用连接池、序列化配置丢失、TagAware 缓存失效等问题。
正确做法是调用 CacheManager::getCachePool() 或使用 PSR-6 兼容的工厂类。例如：
立即学习“PHP免费学习笔记（深入）”；
$pool = new \Symfony\Component\Cache\Adapter\RedisAdapter(
\Symfony\Component\Cache\Adapter\RedisAdapter::createConnection('redis://127.0.0.1')
);
但更推荐用 SimpleCacheFactory 或容器注入方式，尤其在 Symfony 应用里，应通过 cache.app 服务获取，避免手动构造连接对象。
- Redis 连接字符串必须带协议（
redis://或rediss://），否则抛InvalidArgumentException - APCu 需确认
apcu.enabled=1且apc.enable_cli=0（CLI 下默认关闭） - FilesystemAdapter 的
$directory参数若为空，会 fallback 到系统临时目录，可能被定时清理
TagAwareAdapter 不生效？标签写入和清除逻辑容易错在哪
Tag 功能不是自动附加的，必须显式用 TagAwareAdapter 包裹底层适配器，且所有写入必须通过 TagAwareAdapter::save()，不能混用原始 Adapter::save()。
典型错误：用 RedisAdapter 存数据，再单独用 TagAwareAdapter 调 invalidateTags()——标签根本没写进去，清除当然无效。
- 初始化必须两层嵌套：
new TagAwareAdapter(new RedisAdapter(...)) -
CacheItem::tag(['user', 'profile'])后，必须调$pool->save($item)，不是$pool->getItem()->set() - Redis 后端需启用
redis.use_lua=1（PHP Redis 扩展配置），否则批量删 tag 可能失败或漏删 - APCu 不支持 TagAware，强行用会静默降级为普通缓存，无报错但
invalidateTags()不起作用
缓存键名冲突和序列化陷阱
Symfony Cache 默认对键名做哈希处理（防止非法字符或超长键），但开发者常误以为传什么进 getItem('user_123') 就真存成那个字符串——实际底层可能是 sf_cache_user_123_abc456。这导致手动查 Redis 或调试时找不到对应 key。
更隐蔽的问题是序列化：如果缓存对象含闭包、资源句柄或 Doctrine Proxy 实例，serialize() 会失败或产生不可预测行为，抛 Exception 而非警告。
- 调试键名用
$pool->getAdapter()->createCacheKey('user_123')查真实存储 key - 避免缓存未实现
__serialize()的复杂对象；优先缓存数组或 DTO - RedisAdapter 默认用 PHP serializer，若要 JSON，得传
new PhpFilesAdapter()或自定义SerializerInterface实现 - FilesystemAdapter 对键名长度敏感，过长会截断，建议控制在 128 字符内
缓存不是万能胶，键设计、生命周期、失效策略比“怎么存”更重要；尤其是 TagAware 和多后端混用时，一个配置项写错，整条链路就静默失效。
