*/ namespace We\Tests; use PHPUnit\Framework\Attributes\CoversClass; use PHPUnit\Framework\TestCase; use Psr\SimpleCache\CacheInterface; use We\Exception\WechatException; use We\Support\FileCacheStore; use We\Support\NullCacheStore; use We\Support\PsrSimpleCacheStore; /** * SDK 缓存存储实现测试用例。 * @internal */ #[CoversClass(FileCacheStore::class)] #[CoversClass(NullCacheStore::class)] #[CoversClass(PsrSimpleCacheStore::class)] final class CacheStoreTest extends TestCase { /** * 测试文件缓存的写入、读取、删除与过期行为。 */ public function testFileCacheStoreSetGetDelAndTtl(): void { $dir = $this->tempDir(); $store = new FileCacheStore($dir); $this->assertSame('missing', $store->get('k1', 'missing')); $store->set('k1', 'value', 3600); $this->assertSame('value', $store->get('k1')); $store->del('k1'); $this->assertSame('missing', $store->get('k1', 'missing')); $store->set('k2', 'expired', -10); sleep(2); $this->assertSame('missing', $store->get('k2', 'missing')); $this->removeDir($dir); } /** * 测试文件缓存锁会执行回调。 */ public function testFileCacheStoreLockExecutesCallback(): void { $dir = $this->tempDir(); $store = new FileCacheStore($dir); $result = $store->lock('lock:k1', 10, static fn (): string => 'locked'); $this->assertSame('locked', $result); $this->removeDir($dir); } /** * 测试空缓存锁会直接执行回调。 */ public function testNullCacheStoreLockExecutesCallback(): void { $store = new NullCacheStore(); $this->assertSame('ok', $store->lock('k', 10, static fn (): string => 'ok')); } /** * 测试 PSR 缓存未配置锁能力时抛出异常。 */ public function testPsrSimpleCacheStoreThrowsWhenLockerMissing(): void { $store = new PsrSimpleCacheStore(new ArraySimpleCache()); $this->expectException(WechatException::class); $this->expectExceptionMessage('锁能力'); $store->lock('k', 10, static fn (): string => 'never'); } /** * 测试 PSR 缓存会使用注入的锁回调。 */ public function testPsrSimpleCacheStoreUsesInjectedLocker(): void { $calls = []; $store = new PsrSimpleCacheStore(new ArraySimpleCache(), static function (string $key, int $ttl, callable $callback) use (&$calls): mixed { $calls[] = [$key, $ttl]; return $callback(); }); $this->assertSame('ok', $store->lock('k', 10, static fn (): string => 'ok')); $this->assertSame([['k', 10]], $calls); } /** * 创建本次测试使用的临时目录路径。 */ private function tempDir(): string { return sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'wechatdev_cache_' . bin2hex(random_bytes(8)); } /** * 递归删除测试临时目录。 */ private function removeDir(string $dir): void { if (!is_dir($dir)) { return; } $iterator = new \RecursiveIteratorIterator( new \RecursiveDirectoryIterator($dir, \FilesystemIterator::SKIP_DOTS), \RecursiveIteratorIterator::CHILD_FIRST, ); foreach ($iterator as $file) { $path = $file->getPathname(); $file->isDir() ? @rmdir($path) : @unlink($path); } @rmdir($dir); } } /** * 测试用 PSR-16 内存缓存实现。 */ final class ArraySimpleCache implements CacheInterface { /** @var array */ private array $values = []; /** * 读取测试缓存值。 */ public function get(string $key, mixed $default = null): mixed { return $this->values[$key] ?? $default; } /** * 写入缓存值。 */ public function set(string $key, mixed $value, \DateInterval|int|null $ttl = null): bool { $this->values[$key] = $value; return true; } /** * 删除测试缓存值。 */ public function delete(string $key): bool { unset($this->values[$key]); return true; } /** * 清空测试缓存。 */ public function clear(): bool { $this->values = []; return true; } /** * 批量读取测试缓存值。 */ public function getMultiple(iterable $keys, mixed $default = null): iterable { foreach ($keys as $key) { yield $key => $this->get((string)$key, $default); } } /** * 批量写入测试缓存值。 */ public function setMultiple(iterable $values, \DateInterval|int|null $ttl = null): bool { foreach ($values as $key => $value) { $this->set((string)$key, $value, $ttl); } return true; } /** * 批量删除测试缓存值。 */ public function deleteMultiple(iterable $keys): bool { foreach ($keys as $key) { $this->delete((string)$key); } return true; } /** * 判断测试缓存键是否存在。 */ public function has(string $key): bool { return array_key_exists($key, $this->values); } }