Struct RedisCacheDriver 

pub struct RedisCacheDriver { /* private fields */ }

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

基于 RedisBackend trait，提供 PHP think-orm Redis 驱动的等价实现。

PHP 行为对齐

1. set 行为（PHP 第 133-152 行）：

   • expire > 0 → SETEX(key, expire, value)
   • expire = 0 → SET(key, value)

2. inc/dec 行为（PHP 第 161-182 行）：

   • 直接 INCRBY/DECRBY，不经 serialize
   • key 不存在时 Redis 初始化为 0
   • 返回新值（i64）

3. has 行为（PHP 第 100-103 行）：

   • EXISTS(key) ? true : false

4. delete 行为（PHP 第 190-197 行）：

   • DEL(key) > 0 返回 true

5. clear 行为（PHP 第 204-209 行）：

   • FLUSHDB()

6. append（tag）行为（PHP 第 230-234 行）：

   • SADD(key, value) — 用 Set 存储 tag 成员

7. getTagItems 行为（PHP 第 242-247 行）：

   • SMEMBERS(key) — 返回 Set 全部成员

8. clearTag 行为（PHP 第 217-221 行）：

   • DEL(keys...) — 批量删除

key 构造

• getCacheKey(name) = prefix + name（对齐 PHP Driver::getCacheKey）
• getTagKey(tag) = tag_prefix + md5(tag)（对齐 PHP Driver::getTagKey）

使用示例

use sz_rust_cache_facade::{RedisCacheDriver, RedisConfig, Cache};

let driver = RedisCacheDriver::new(RedisConfig::default());
let cache = Cache::new();
cache.register_store("redis", Box::new(driver));
cache.set_default_store("redis").unwrap();

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

Implementations

impl RedisCacheDriver

pub fn new(config: RedisConfig) -> Self

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

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

pub fn with_backend(config: RedisConfig, backend: Box<dyn RedisBackend>) -> Self

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

应用层可注入真实 Redis backend（如 redis::Connection 包装）。

pub fn config(&self) -> &RedisConfig

获取配置引用

pub fn backend(&self) -> &dyn RedisBackend

获取 backend 引用（用于高级操作）

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

追加 TagSet 数据（对齐 PHP Redis::append）

PHP Redis::append(name, value) 第 230-234 行：

public function append(string $name, $value): void
{
    $key = $this->getCacheKey($name);
    $this->handler->sAdd($key, $value);
}

注意：PHP think\cache\driver\Redis 重写了父类 Driver::append （父类用 push，Redis 驱动用 SADD）。

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

获取标签包含的缓存标识（对齐 PHP Redis::getTagItems）

PHP Redis::getTagItems(tag) 第 242-247 行：

public function getTagItems(string $tag): array
{
    $name = $this->getTagKey($tag);
    $key  = $this->getCacheKey($name);
    return $this->handler->sMembers($key);
}

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

删除缓存标签（对齐 PHP Redis::clearTag）

PHP Redis::clearTag(keys) 第 217-221 行：

public function clearTag(array $keys): void
{
    $this->handler->del($keys);
}

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

获取 tag key（公开接口，用于测试和调试）

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

获取 cache key（公开接口，用于测试和调试）

Trait Implementations

impl CacheDriver for RedisCacheDriver

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

重写 inc（对齐 PHP Redis::inc，直接 INCRBY，不经 serialize）

PHP Redis::inc(name, step) 第 161-167 行：

public function inc(string $name, int $step = 1)
{
    $this->writeTimes++;
    $key = $this->getCacheKey($name);
    return $this->handler->incrby($key, $step);
}

关键差异：File 驱动读取 → 加减 → 写回（经 serialize 层）； Redis 驱动直接 INCRBY（不经 serialize）。Redis 自身处理 key 不存在 的情况（初始化为 0）。

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

重写 dec（对齐 PHP Redis::dec，直接 DECRBY，不经 serialize）

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

重写 getCacheKey（对齐 PHP Driver::getCacheKey）

PHP: return $this->options['prefix'] . $name;

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

重写 getTagKey（对齐 PHP Driver::getTagKey）

PHP: return $this->options['tag_prefix'] . md5($tag);

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

重写 tag_append（对齐 PHP Redis::append，使用 sAdd 而非 push）

PHP Redis::append(name, value) 第 230-234 行：

public function append(string $name, $value): void
{
    $key = $this->getCacheKey($name);
    $this->handler->sAdd($key, $value);
}

关键差异：PHP think\cache\driver\Redis 重写了父类 Driver::append （父类用 push = get→append→set，Redis 驱动用 SADD = 原子 Set 操作）。

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

重写 tag_items（对齐 PHP Redis::getTagItems，使用 sMembers）

PHP Redis::getTagItems(tag) 第 242-247 行：

public function getTagItems(string $tag): array
{
    $name = $this->getTagKey($tag);
    $key  = $this->getCacheKey($name);
    return $this->handler->sMembers($key);
}

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

重写 tag_clear（对齐 PHP Redis::clearTag，raw del 不应用前缀）

PHP Redis::clearTag(keys) 第 217-221 行：

public function clearTag(array $keys): void
{
    $this->handler->del($keys);
}

关键：keys 已是 prefix + name 格式（来自 tag_items 返回值）， 因此直接 del_many，不得再次应用 getCacheKey。

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 clear(&self) -> Result<(), CacheError>

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