EasySwoole

Fast-Cache:基础使用

按安装完成主进程注册后,等服务启动且 Socket 就绪,再在控制器或 Service 的 Swoole 协程中调用。各示例均使用 App\Cache\MyCache。

普通值与 TTL

use App\Cache\MyCache;

MyCache::getInstance()->set('home:title', '首页', ttl: 60);
$title = MyCache::getInstance()->get('home:title'); // '首页'
MyCache::getInstance()->del('home:title');

TTL 从写入时起按秒计算,必须是正整数。值过期或不存在时,get() 返回 null。覆盖写入时省略 ttl 或传 null,会清除原有过期时间。业务通过 === null 判断缓存缺失时,应避免把 null 存作有效缓存值。

哈希

用 hset($key, $field, $value) 写入字段,hget() 读取字段,hdel() 删除字段。需要遍历时,按插入顺序分页,使用上次返回的游标继续。

MyCache::getInstance()->hset('app:labels', 'home', '首页');
MyCache::getInstance()->hset('app:labels', 'help', '帮助');

$cursor = null;
do {
    $page = MyCache::getInstance()->hscan('app:labels', $cursor, count: 100);
    foreach ($page['items'] as $item) {
        // $item 包含 field 和 value。
    }
    $cursor = $page['cursor'];
} while ($cursor !== null);

扫描过程中删除任一字段会使已有游标失效。普通值、哈希和队列各自存储,同名键可以共存。TTL 适用于普通值。

内存队列

先用 initQueue() 设置容量,再用 push() 入队和 pop() 出队。初始化同名队列会清空原有消息,因此应由应用在缓存进程就绪后统一初始化。未初始化时,首次入队或出队会创建容量为 PHP_INT_MAX 的队列。

MyCache::getInstance()->initQueue('preview-jobs', 128); // 统一初始化时调用。
$sent = MyCache::getInstance()->push('preview-jobs', ['id' => 42], timeout: 0.5);
$job = MyCache::getInstance()->pop('preview-jobs', timeout: 0.5);

队列满时入队等待空位,超时或队列关闭时返回 false。队列空时出队等待消息,超时或队列关闭时返回 null。消息在回包前就已出队,连接中断时可能丢失。需可靠消费的业务可使用可信队列。

下一章:注意事项。