Struct MemcachedCacheDriver 

pub struct MemcachedCacheDriver { /* private fields */ }

Memcached 缓存驱动（对齐 PHP think\cache\driver\Memcached）

实现 CacheDriver trait，通过 MemcachedBackend 抽象层操作 Memcached。

标签模拟

由于 Memcached 不支持 Set 数据结构，标签功能通过 JSON 序列化模拟：

• tag_append(name, value)：读取 tag:<md5(tag)> 的 JSON 数组 → 追加 → 写回
• tag_items(tag)：读取 tag:<md5(tag)> 的 JSON 数组
• tag_clear(keys)：逐个删除 key

用法

use sz_rust_cache_facade::{Cache, MemcachedCacheDriver, MemcachedConfig, MockMemcachedBackend};

let cache = Cache::new();
cache.register_default(
    MemcachedCacheDriver::with_backend(
        MemcachedConfig::default(),
        Box::new(MockMemcachedBackend::new()),
    )
);

cache.set("key", "value", None).unwrap();
assert_eq!(cache.get::<String>("key").unwrap(), Some("value".to_string()));

Implementations

impl MemcachedCacheDriver

pub fn new(config: MemcachedConfig) -> Self

创建 Memcached 缓存驱动（用 Mock backend）

对齐 PHP new \think\cache\driver\Memcached($options)。

pub fn with_backend( config: MemcachedConfig, backend: Box<dyn MemcachedBackend>, ) -> Self

创建 Memcached 缓存驱动（自定义 backend）

应用层可注入真实 Memcached backend（如 memcache::Client 包装）。

pub fn config(&self) -> &MemcachedConfig

获取配置引用

pub fn append(&self, name: &str, value: &str) -> Result<(), CacheError>

追加 TagSet 数据（模拟 PHP Driver::append）

Memcached 不支持 Set，通过 JSON 序列化模拟：

1. 读取 tag:<md5(tag)> 的 JSON 数组（若不存在则为空数组）
2. 追加新 value（去重）
3. 写回

pub fn get_tag_items(&self, tag: &str) -> Result<Vec<String>, CacheError>

获取标签包含的缓存标识（模拟 PHP getTagItems）

pub fn clear_tag(&self, keys: &[&str]) -> Result<(), CacheError>

删除缓存标签（模拟 PHP clearTag）

Memcached 不支持批量 DEL，逐个删除。

Trait Implementations

impl CacheDriver for MemcachedCacheDriver

fn get_raw(&self, key: &str) -> Result<Option<Vec<u8>>, CacheError>

读取缓存原始字节

fn set_raw( &self, key: &str, value: Vec<u8>, ttl: Option<Duration>, ) -> Result<(), CacheError>

写入缓存原始字节

fn delete(&self, key: &str) -> Result<(), CacheError>

删除缓存

fn has(&self, key: &str) -> Result<bool, CacheError>

判断键是否存在（对齐 PHP has，含 TTL 过期检查）

fn inc(&self, key: &str, step: i64) -> Result<i64, CacheError>

自增（对齐 PHP inc，不经序列化层）

fn dec(&self, key: &str, step: i64) -> Result<i64, CacheError>

自减（对齐 PHP dec，不经序列化层）

fn clear(&self) -> Result<(), CacheError>

清空所有缓存（对齐 PHP clear）

fn get_cache_key(&self, name: &str) -> String

构造缓存 key（对齐 PHP Driver::getCacheKey）

fn get_tag_key(&self, tag: &str) -> String

构造 tag key（对齐 PHP Driver::getTagKey）

fn tag_append(&self, tag_key: &str, cache_key: &str) -> Result<(), CacheError>

追加 cache_key 到标签集合（对齐 PHP Driver::append / Driver::push）

fn tag_items(&self, tag: &str) -> Result<Vec<String>, CacheError>

获取标签包含的所有缓存 key（对齐 PHP Driver::getTagItems）

fn tag_clear(&self, keys: &[String]) -> Result<(), CacheError>

批量删除缓存 key（对齐 PHP Redis::clearTag）