初始化本地仓库

backend/core/jwt/interfaces/BlacklistStorageInterface.php

@@ -0,0 +1,70 @@
+<?php
+declare(strict_types=1);
+
+namespace core\jwt\interfaces;
+
+/**
+ * 黑名单存储接口
+ *
+ * 可实现此接口以支持不同的存储后端（Redis、MySQL、Memcached 等）
+ */
+interface BlacklistStorageInterface
+{
+    /**
+     * 添加 Token 到黑名单
+     *
+     * @param string $jti Token 唯一标识
+     * @param int $ttl 有效期（秒）
+     * @return bool
+     */
+    public function add(string $jti, int $ttl): bool;
+
+    /**
+     * 检查 Token 是否在黑名单
+     *
+     * @param string $jti
+     * @return bool
+     */
+    public function has(string $jti): bool;
+
+    /**
+     * 移除 Token 从黑名单
+     *
+     * @param string $jti
+     * @return bool
+     */
+    public function remove(string $jti): bool;
+
+    /**
+     * 添加用户到黑名单
+     *
+     * @param string $id 用户ID（雪花ID）
+     * @param int $ttl 有效期（秒）
+     * @return bool
+     */
+    public function addUser(string $id, int $ttl): bool;
+
+    /**
+     * 检查用户是否在黑名单
+     *
+     * @param string $id 用户ID（雪花ID）
+     * @return bool
+     */
+    public function hasUser(string $id): bool;
+
+    /**
+     * 移除用户从黑名单
+     *
+     * @param string $id 用户ID（雪花ID）
+     * @return bool
+     */
+    public function removeUser(string $id): bool;
+
+    /**
+     * 获取黑名单剩余 TTL
+     *
+     * @param string $jti
+     * @return int -1 表示不存在，-2 表示已过期
+     */
+    public function getTtl(string $jti): int;
+}

backend/core/jwt/interfaces/TokenStorageInterface.php

@@ -0,0 +1,116 @@
+<?php
+declare(strict_types=1);
+
+namespace core\jwt\interfaces;
+
+/**
+ * Token 存储接口
+ *
+ * 可实现此接口以支持不同的存储后端（Redis、MySQL、Memcached 等）
+ */
+interface TokenStorageInterface
+{
+    /**
+     * 保存 Token 信息
+     *
+     * @param string $jti Token 唯一标识
+     * @param array $data Token 数据
+     * @param int $ttl 有效期（秒）
+     * @return bool
+     */
+    public function save(string $jti, array $data, int $ttl): bool;
+
+    /**
+     * 获取 Token 信息
+     *
+     * @param string $jti
+     * @return array|null
+     */
+    public function get(string $jti): ?array;
+
+    /**
+     * 删除 Token 信息
+     *
+     * @param string $jti
+     * @return bool
+     */
+    public function delete(string $jti): bool;
+
+    /**
+     * 验证 Token 是否存在
+     *
+     * @param string $jti
+     * @return bool
+     */
+    public function exists(string $jti): bool;
+
+    /**
+     * 根据用户删除所有 Token
+     *
+     * @param string $id 用户ID（雪花ID）
+     * @param string|null $clientType
+     * @param string|null $exceptJti 保留的 JTI
+     * @return int 删除数量
+     */
+    public function deleteByUser(string $id, ?string $clientType = null, ?string $exceptJti = null): int;
+
+    /**
+     * 删除最早的 Token
+     *
+     * @param string $id 用户ID（雪花ID）
+     * @return bool
+     */
+    public function deleteOldest(string $id): bool;
+
+    /**
+     * 获取用户的所有 Token 数量
+     *
+     * @param string $id 用户ID（雪花ID）
+     * @param string|null $clientType
+     * @return int
+     */
+    public function countByUser(string $id, ?string $clientType = null): int;
+
+    /**
+     * 获取用户的所有 Token
+     *
+     * @param string $id 用户ID（雪花ID）
+     * @return array
+     */
+    public function getByUser(string $id): array;
+
+    /**
+     * 获取用户的所有 Token 信息（包含索引信息）
+     *
+     * @param string $id 用户ID（雪花ID）
+     * @param string|null $clientType 客户端类型
+     * @return array
+     */
+    public function getUserTokens(string $id, ?string $clientType = null): array;
+
+    /**
+     * 获取所有在线 Token 信息
+     *
+     * @param string|null $clientType 客户端类型
+     * @return array
+     */
+    public function getAllTokens(?string $clientType = null): array;
+
+    /**
+     * 更新 Token 最后活跃时间
+     *
+     * @param string $jti Token 唯一标识
+     * @param int|null $timestamp 活跃时间戳
+     * @return bool
+     */
+    public function touch(string $jti, ?int $timestamp = null): bool;
+
+    /**
+     * 标记 Token 会话离线
+     *
+     * @param string $jti Token 唯一标识
+     * @param int|null $timestamp 离线时间戳
+     * @return bool
+     */
+    public function markOffline(string $jti, ?int $timestamp = null): bool;
+}