Added extended JSON methods to ItemPool API

Author: Geolim4

src/phpFastCache/Cache/ExtendedCacheItemPoolInterface.php

@@ -74,6 +74,22 @@ public function getItem($key);
      */
     public function getItems(array $keys = []);
 
+    /**
+     * Returns A json string that represents an array of items.
+     *
+     * @param array $keys
+     * An indexed array of keys of items to retrieve.
+     * @param int $option json_encode() options
+     * @param int $depth json_encode() depth
+     *
+     * @throws InvalidArgumentException
+     *   If any of the keys in $keys are not a legal value a \Psr\Cache\InvalidArgumentException
+     *   MUST be thrown.
+     *
+     * @return string
+     */
+    public function getItemsAsJsonString(array $keys = [], $option = 0, $depth = 512);
+
     /**
      * @param \Psr\Cache\CacheItemInterface $item
      * @return mixed
@@ -121,6 +137,22 @@ public function getItemsByTag($tagName);
      */
     public function getItemsByTags(array $tagNames);
 
+    /**
+     * Returns A json string that represents an array of items by tags-based.
+     *
+     * @param array $tagNames
+     * An indexed array of keys of items to retrieve.
+     * @param int $option json_encode() options
+     * @param int $depth json_encode() depth
+     *
+     * @throws InvalidArgumentException
+     *   If any of the keys in $keys are not a legal value a \Psr\Cache\InvalidArgumentException
+     *   MUST be thrown.
+     *
+     * @return string
+     */
+    public function getItemsByTagsAsJsonString(array $tagNames, $option = 0, $depth = 512);
+
     /**
      * Removes the item from the pool by tag.
      *

src/phpFastCache/Core/ExtendedCacheItemPoolTrait.php

@@ -18,6 +18,19 @@
 
 trait ExtendedCacheItemPoolTrait
 {
+    /**
+     * @param array $keys
+     * An indexed array of keys of items to retrieve.
+     * @param int $option json_encode() options
+     * @param int $depth json_encode() depth
+     * @return string
+     * @throws \InvalidArgumentException
+     */
+    public function getItemsAsJsonString(array $keys = [], $option = 0, $depth = 512)
+    {
+        return json_encode(array_values($this->getItems($keys)), $option, $depth);
+    }
+
     /**
      * @param string $tagName
      * @return \phpFastCache\Cache\ExtendedCacheItemInterface[]
@@ -54,6 +67,25 @@ public function getItemsByTags(array $tagNames)
         return $items;
     }
 
+    /**
+     * Returns A json string that represents an array of items by tags-based.
+     *
+     * @param array $tagNames
+     * An indexed array of keys of items to retrieve.
+     * @param int $option json_encode() options
+     * @param int $depth json_encode() depth
+     *
+     * @throws InvalidArgumentException
+     *   If any of the keys in $keys are not a legal value a \Psr\Cache\InvalidArgumentException
+     *   MUST be thrown.
+     *
+     * @return string
+     */
+    public function getItemsByTagsAsJsonString(array $tagNames, $option = 0, $depth = 512)
+    {
+        return json_encode(array_values($this->getItemsByTags($tagNames)), $option, $depth);
+    }
+
     /**
      * @param string $tagName
      * @return bool|null