Initial Commit

dependencies/amphp/cache/lib/SerializedCache.php

@@ -0,0 +1,86 @@
+<?php
+
+namespace WP_Ultimo\Dependencies\Amp\Cache;
+
+use WP_Ultimo\Dependencies\Amp\Failure;
+use WP_Ultimo\Dependencies\Amp\Promise;
+use WP_Ultimo\Dependencies\Amp\Serialization\SerializationException;
+use WP_Ultimo\Dependencies\Amp\Serialization\Serializer;
+use function WP_Ultimo\Dependencies\Amp\call;
+/**
+ * @template TValue
+ */
+final class SerializedCache
+{
+    /** @var Cache */
+    private $cache;
+    /** @var Serializer */
+    private $serializer;
+    public function __construct(Cache $cache, Serializer $serializer)
+    {
+        $this->cache = $cache;
+        $this->serializer = $serializer;
+    }
+    /**
+     * Fetch a value from the cache and unserialize it.
+     *
+     * @param $key string Cache key.
+     *
+     * @return Promise<mixed|null> Resolves to the cached value or `null` if it doesn't exist. Fails with a
+     * CacheException or SerializationException on failure.
+     *
+     * @psalm-return Promise<TValue|null>
+     *
+     * @see Cache::get()
+     */
+    public function get(string $key) : Promise
+    {
+        return call(function () use($key) {
+            $data = (yield $this->cache->get($key));
+            if ($data === null) {
+                return null;
+            }
+            return $this->serializer->unserialize($data);
+        });
+    }
+    /**
+     * Serializes a value and stores its serialization to the cache.
+     *
+     * @param $key   string Cache key.
+     * @param $value mixed Value to cache.
+     * @param $ttl   int Timeout in seconds. The default `null` $ttl value indicates no timeout. Values less than 0 MUST
+     *               throw an \Error.
+     *
+     * @psalm-param TValue $value
+     *
+     * @return Promise<void> Resolves either successfully or fails with a CacheException or SerializationException.
+     *
+     * @see Cache::set()
+     */
+    public function set(string $key, $value, int $ttl = null) : Promise
+    {
+        if ($value === null) {
+            return new Failure(new CacheException('Cannot store NULL in serialized cache'));
+        }
+        try {
+            $value = $this->serializer->serialize($value);
+        } catch (SerializationException $exception) {
+            return new Failure($exception);
+        }
+        return $this->cache->set($key, $value, $ttl);
+    }
+    /**
+     * Deletes a value associated with the given key if it exists.
+     *
+     * @param $key string Cache key.
+     *
+     * @return Promise<bool|null> Resolves to `true` / `false` to indicate whether the key existed or fails with a
+     * CacheException on failure. May also resolve with `null` if that information is not available.
+     *
+     * @see Cache::delete()
+     */
+    public function delete(string $key) : Promise
+    {
+        return $this->cache->delete($key);
+    }
+}