grommunio / grommunio-web

plugins/files/php/vendor/phpfastcache/phpfastcache/lib/Phpfastcache/Core/Item/CacheItemTrait.php

Indentation +119 added lines, -119 removed lines

@@ -27,123 +27,123 @@
 
 trait CacheItemTrait
 {
-    use EventManagerDispatcherTrait;
-    use ClassNamespaceResolverTrait;
-
-    protected string $key;
-
-    protected mixed $data;
-
-    protected DateTimeInterface $expirationDate;
-
-    protected DateTimeInterface $creationDate;
-
-    protected DateTimeInterface $modificationDate;
-
-    protected bool $isHit = false;
-
-    public function getKey(): string
-    {
-        return $this->key;
-    }
-
-    public function get(): mixed
-    {
-        if (!$this->isHit()) {
-            return null;
-        }
-
-        return $this->data;
-    }
-
-    /**
-     * @throws PhpfastcacheInvalidArgumentException
-     */
-    public function set(mixed $value): static
-    {
-        if ($value instanceof \Closure) {
-            throw new PhpfastcacheInvalidArgumentException('The value set cannot be an instance of \\Closure.');
-        }
-
-        if (\is_resource($value)) {
-            throw new PhpfastcacheInvalidArgumentException('The value set cannot be a resource');
-        }
-
-        $this->eventManager->dispatch(Event::CACHE_ITEM_SET, $this, new EventReferenceParameter($value, true));
-
-        $this->data = $value;
-
-        return $this;
-    }
-
-    /**
-     * @return bool
-     */
-    public function isHit(): bool
-    {
-        return $this->isHit;
-    }
-
-    /**
-     * @param bool $isHit
-     * @return ExtendedCacheItemInterface
-     */
-    public function setHit(bool $isHit): ExtendedCacheItemInterface
-    {
-        $this->isHit = $isHit;
-
-        return $this;
-    }
-
-    /**
-     * @throws PhpfastcacheInvalidArgumentException
-     */
-    public function expiresAt(?\DateTimeInterface $expiration): static
-    {
-        if ($expiration instanceof DateTimeInterface) {
-            $this->eventManager->dispatch(Event::CACHE_ITEM_EXPIRE_AT, $this, $expiration);
-            $this->expirationDate = $this->demutateDatetime($expiration);
-        } else {
-            throw new PhpfastcacheInvalidArgumentException('$expiration must be an object implementing the DateTimeInterface got: ' . \gettype($expiration));
-        }
-
-        return $this;
-    }
-
-    /**
-     * @return $this
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws \Exception
-     */
-    public function expiresAfter(int|\DateInterval|null $time): static
-    {
-        if (\is_numeric($time)) {
-            if ($time <= 0) {
-                /**
-                 * 5 months, however memcached or memory cached will be gone when u restart it
-                 * just recommended for sqlite. files
-                 */
-                $time = 30 * 24 * 3600 * 5;
-            }
-
-            $this->eventManager->dispatch(Event::CACHE_ITEM_EXPIRE_AFTER, $this, $time);
-
-            $this->expirationDate = (new DateTime())->add(new DateInterval(\sprintf('PT%dS', $time)));
-        } elseif ($time instanceof DateInterval) {
-            $this->eventManager->dispatch(Event::CACHE_ITEM_EXPIRE_AFTER, $this, $time);
-
-            $this->expirationDate = (new DateTime())->add($time);
-        } else {
-            throw new PhpfastcacheInvalidArgumentException(\sprintf('Invalid date format, got "%s"', \gettype($time)));
-        }
-
-        return $this;
-    }
-
-    protected function demutateDatetime(\DateTimeInterface $dateTime): \DateTimeInterface
-    {
-        return $dateTime instanceof \DateTimeImmutable
-            ? \DateTime::createFromImmutable($dateTime)
-            : $dateTime;
-    }
+	use EventManagerDispatcherTrait;
+	use ClassNamespaceResolverTrait;
+
+	protected string $key;
+
+	protected mixed $data;
+
+	protected DateTimeInterface $expirationDate;
+
+	protected DateTimeInterface $creationDate;
+
+	protected DateTimeInterface $modificationDate;
+
+	protected bool $isHit = false;
+
+	public function getKey(): string
+	{
+		return $this->key;
+	}
+
+	public function get(): mixed
+	{
+		if (!$this->isHit()) {
+			return null;
+		}
+
+		return $this->data;
+	}
+
+	/**
+	 * @throws PhpfastcacheInvalidArgumentException
+	 */
+	public function set(mixed $value): static
+	{
+		if ($value instanceof \Closure) {
+			throw new PhpfastcacheInvalidArgumentException('The value set cannot be an instance of \\Closure.');
+		}
+
+		if (\is_resource($value)) {
+			throw new PhpfastcacheInvalidArgumentException('The value set cannot be a resource');
+		}
+
+		$this->eventManager->dispatch(Event::CACHE_ITEM_SET, $this, new EventReferenceParameter($value, true));
+
+		$this->data = $value;
+
+		return $this;
+	}
+
+	/**
+	 * @return bool
+	 */
+	public function isHit(): bool
+	{
+		return $this->isHit;
+	}
+
+	/**
+	 * @param bool $isHit
+	 * @return ExtendedCacheItemInterface
+	 */
+	public function setHit(bool $isHit): ExtendedCacheItemInterface
+	{
+		$this->isHit = $isHit;
+
+		return $this;
+	}
+
+	/**
+	 * @throws PhpfastcacheInvalidArgumentException
+	 */
+	public function expiresAt(?\DateTimeInterface $expiration): static
+	{
+		if ($expiration instanceof DateTimeInterface) {
+			$this->eventManager->dispatch(Event::CACHE_ITEM_EXPIRE_AT, $this, $expiration);
+			$this->expirationDate = $this->demutateDatetime($expiration);
+		} else {
+			throw new PhpfastcacheInvalidArgumentException('$expiration must be an object implementing the DateTimeInterface got: ' . \gettype($expiration));
+		}
+
+		return $this;
+	}
+
+	/**
+	 * @return $this
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws \Exception
+	 */
+	public function expiresAfter(int|\DateInterval|null $time): static
+	{
+		if (\is_numeric($time)) {
+			if ($time <= 0) {
+				/**
+				 * 5 months, however memcached or memory cached will be gone when u restart it
+				 * just recommended for sqlite. files
+				 */
+				$time = 30 * 24 * 3600 * 5;
+			}
+
+			$this->eventManager->dispatch(Event::CACHE_ITEM_EXPIRE_AFTER, $this, $time);
+
+			$this->expirationDate = (new DateTime())->add(new DateInterval(\sprintf('PT%dS', $time)));
+		} elseif ($time instanceof DateInterval) {
+			$this->eventManager->dispatch(Event::CACHE_ITEM_EXPIRE_AFTER, $this, $time);
+
+			$this->expirationDate = (new DateTime())->add($time);
+		} else {
+			throw new PhpfastcacheInvalidArgumentException(\sprintf('Invalid date format, got "%s"', \gettype($time)));
+		}
+
+		return $this;
+	}
+
+	protected function demutateDatetime(\DateTimeInterface $dateTime): \DateTimeInterface
+	{
+		return $dateTime instanceof \DateTimeImmutable
+			? \DateTime::createFromImmutable($dateTime)
+			: $dateTime;
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -115,7 +115,7 @@
      * @throws PhpfastcacheInvalidArgumentException
      * @throws \Exception
      */
-    public function expiresAfter(int|\DateInterval|null $time): static
+    public function expiresAfter(int | \DateInterval | null $time): static
     {
         if (\is_numeric($time)) {
             if ($time <= 0) {

Braces +6 added lines, -3 removed lines

@@ -103,7 +103,8 @@ 
         if ($expiration instanceof DateTimeInterface) {
             $this->eventManager->dispatch(Event::CACHE_ITEM_EXPIRE_AT, $this, $expiration);
             $this->expirationDate = $this->demutateDatetime($expiration);
-        } else {
+        }
+        else {
             throw new PhpfastcacheInvalidArgumentException('$expiration must be an object implementing the DateTimeInterface got: ' . \gettype($expiration));
         }
 
@@ -129,11 +130,13 @@ 
             $this->eventManager->dispatch(Event::CACHE_ITEM_EXPIRE_AFTER, $this, $time);
 
             $this->expirationDate = (new DateTime())->add(new DateInterval(\sprintf('PT%dS', $time)));
-        } elseif ($time instanceof DateInterval) {
+        }
+        elseif ($time instanceof DateInterval) {
             $this->eventManager->dispatch(Event::CACHE_ITEM_EXPIRE_AFTER, $this, $time);
 
             $this->expirationDate = (new DateTime())->add($time);
-        } else {
+        }
+        else {
             throw new PhpfastcacheInvalidArgumentException(\sprintf('Invalid date format, got "%s"', \gettype($time)));
         }
 

plugins/files/php/vendor/phpfastcache/phpfastcache/lib/Phpfastcache/Core/Pool/ExtendedCacheItemPoolTrait.php

Indentation +105 added lines, -105 removed lines

@@ -27,109 +27,109 @@
 
 trait ExtendedCacheItemPoolTrait
 {
-    use CacheItemPoolTrait;
-    use AggregatablePoolTrait;
-
-    /**
-     * @inheritDoc
-     * @param string $pattern
-     * @return array<string, mixed>
-     */
-    public function getAllItems(string $pattern = ''): iterable
-    {
-        $driverReadAllKeysCallback = fn (string $pattern): iterable => $this->driverReadAllKeys($pattern);
-
-        /**
-         * This event allow you to customize the callback and wrap it to an invoker
-         * like SebastianBergmann\Invoke\Invoke, so you can set up custom timeouts.
-         */
-        $this->eventManager->dispatch(Event::CACHE_GET_ALL_ITEMS, $this, new EventReferenceParameter($driverReadAllKeysCallback));
-        $keys = $driverReadAllKeysCallback($pattern);
-
-        if (count($keys) > 0) {
-            return $this->getItems($keys instanceof \Traversable ? iterator_to_array($keys) : $keys);
-        }
-
-        return [];
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function getItemsAsJsonString(array $keys = [], int $options = \JSON_THROW_ON_ERROR, int $depth = 512): string
-    {
-        return \json_encode(
-            \array_map(
-                static fn(CacheItemInterface $item) => $item->get(),
-                \array_values($this->getItems($keys))
-            ),
-            $options,
-            $depth
-        );
-    }
-
-    public function detachAllItems(): static
-    {
-        foreach ($this->itemInstances as $item) {
-            $this->detachItem($item);
-        }
-
-        return $this;
-    }
-
-    public function detachItem(CacheItemInterface $item): static
-    {
-        if (isset($this->itemInstances[$item->getKey()])) {
-            $this->deregisterItem($item->getKey());
-        }
-
-        return $this;
-    }
-
-    /**
-     * @param ExtendedCacheItemInterface ...$items
-     * @return bool
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function saveMultiple(ExtendedCacheItemInterface ...$items): bool
-    {
-        $this->eventManager->dispatch(Event::CACHE_SAVE_MULTIPLE_ITEMS, $this, new EventReferenceParameter($items));
-
-        if (\count($items)) {
-            foreach ($items as $item) {
-                $this->save($item);
-            }
-            return true;
-        }
-        return false;
-    }
-
-    /**
-     * @return string
-     */
-    public function getHelp(): string
-    {
-        return '';
-    }
-
-    /**
-     * @throws PhpfastcacheInvalidArgumentException
-     */
-    public function throwUnsupportedDriverReadAllPattern(string $linkReference = ''): void
-    {
-        throw new PhpfastcacheInvalidArgumentException(
-            sprintf(
-                '%s does not support a pattern argument.%s',
-                $this->getDriverName(),
-                $linkReference ? " See $linkReference" : ''
-            )
-        );
-    }
+	use CacheItemPoolTrait;
+	use AggregatablePoolTrait;
+
+	/**
+	 * @inheritDoc
+	 * @param string $pattern
+	 * @return array<string, mixed>
+	 */
+	public function getAllItems(string $pattern = ''): iterable
+	{
+		$driverReadAllKeysCallback = fn (string $pattern): iterable => $this->driverReadAllKeys($pattern);
+
+		/**
+		 * This event allow you to customize the callback and wrap it to an invoker
+		 * like SebastianBergmann\Invoke\Invoke, so you can set up custom timeouts.
+		 */
+		$this->eventManager->dispatch(Event::CACHE_GET_ALL_ITEMS, $this, new EventReferenceParameter($driverReadAllKeysCallback));
+		$keys = $driverReadAllKeysCallback($pattern);
+
+		if (count($keys) > 0) {
+			return $this->getItems($keys instanceof \Traversable ? iterator_to_array($keys) : $keys);
+		}
+
+		return [];
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function getItemsAsJsonString(array $keys = [], int $options = \JSON_THROW_ON_ERROR, int $depth = 512): string
+	{
+		return \json_encode(
+			\array_map(
+				static fn(CacheItemInterface $item) => $item->get(),
+				\array_values($this->getItems($keys))
+			),
+			$options,
+			$depth
+		);
+	}
+
+	public function detachAllItems(): static
+	{
+		foreach ($this->itemInstances as $item) {
+			$this->detachItem($item);
+		}
+
+		return $this;
+	}
+
+	public function detachItem(CacheItemInterface $item): static
+	{
+		if (isset($this->itemInstances[$item->getKey()])) {
+			$this->deregisterItem($item->getKey());
+		}
+
+		return $this;
+	}
+
+	/**
+	 * @param ExtendedCacheItemInterface ...$items
+	 * @return bool
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function saveMultiple(ExtendedCacheItemInterface ...$items): bool
+	{
+		$this->eventManager->dispatch(Event::CACHE_SAVE_MULTIPLE_ITEMS, $this, new EventReferenceParameter($items));
+
+		if (\count($items)) {
+			foreach ($items as $item) {
+				$this->save($item);
+			}
+			return true;
+		}
+		return false;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getHelp(): string
+	{
+		return '';
+	}
+
+	/**
+	 * @throws PhpfastcacheInvalidArgumentException
+	 */
+	public function throwUnsupportedDriverReadAllPattern(string $linkReference = ''): void
+	{
+		throw new PhpfastcacheInvalidArgumentException(
+			sprintf(
+				'%s does not support a pattern argument.%s',
+				$this->getDriverName(),
+				$linkReference ? " See $linkReference" : ''
+			)
+		);
+	}
 }

plugins/files/php/vendor/phpfastcache/phpfastcache/lib/Phpfastcache/Core/Pool/CacheItemPoolTrait.php

Indentation +584 added lines, -584 removed lines

@@ -41,590 +41,590 @@
  */
 trait CacheItemPoolTrait
 {
-    use DriverBaseTrait {
-        DriverBaseTrait::__construct as __driverBaseConstruct;
-    }
-
-    /**
-     * @var string
-     */
-    protected static string $unsupportedKeyChars = '{}()/\@:';
-
-    /**
-     * @var ExtendedCacheItemInterface[]|CacheItemInterface[]
-     */
-    protected array $deferredList = [];
-
-    /**
-     * @var ExtendedCacheItemInterface[]|CacheItemInterface[]
-     */
-    protected array $itemInstances = [];
-
-    protected DriverIO $IO;
-
-    public function __construct(#[\SensitiveParameter] ConfigurationOptionInterface $config, string $instanceId, EventManagerInterface $em)
-    {
-        $this->IO = new DriverIO();
-        $this->__driverBaseConstruct($config, $instanceId, $em);
-    }
-
-    /**
-     * @throws PhpfastcacheLogicException
-     * @throws PhpfastcacheInvalidArgumentException
-     */
-    public function setItem(CacheItemInterface $item): static
-    {
-        if (self::getItemClass() === $item::class) {
-            if (!$this->getConfig()->isUseStaticItemCaching()) {
-                throw new PhpfastcacheLogicException(
-                    'The static item caching option (useStaticItemCaching) is disabled so you cannot attach an item.'
-                );
-            }
-
-            $this->itemInstances[$item->getKey()] = $item;
-
-            return $this;
-        }
-        throw new PhpfastcacheInvalidArgumentException(
-            \sprintf(
-                'Invalid cache item class "%s" for driver "%s".',
-                get_class($item),
-                get_class($this)
-            )
-        );
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function getItems(array $keys = []): iterable
-    {
-        $items = [];
-
-        /**
-         * Usually, drivers that are able to enable cache slams
-         * does not benefit of driverReadMultiple() call.
-         */
-        if (!$this->getConfig()->isPreventCacheSlams()) {
-            $this->validateCacheKeys(...$keys);
-
-            /**
-             * Check for local item instances first.
-             */
-            foreach ($keys as $index => $key) {
-                if (isset($this->itemInstances[$key]) && $this->getConfig()->isUseStaticItemCaching()) {
-                    $items[$key] = $this->itemInstances[$key];
-                    // Key already exists in local item instances, no need to fetch it again.
-                    unset($keys[$index]);
-                }
-            }
-            $keys = array_values($keys);
-
-            /**
-             * If there's still keys to fetch, let's choose the right method (if supported).
-             */
-            if (count($keys) > 1) {
-                $items = array_merge(
-                    array_combine($keys, array_map(fn($key) => new (self::getItemClass())($this, $key, $this->eventManager), $keys)),
-                    $items
-                );
-
-                try {
-                    $driverArrays = $this->driverReadMultiple(...$items);
-                } catch (PhpfastcacheUnsupportedMethodException) {
-                    /**
-                     * Fallback for drivers that does not yet implement driverReadMultiple() method.
-                     */
-                    $driverArrays = array_combine(
-                        array_map(fn($item) => $item->getKey(), $items),
-                        array_map(fn($item) => $this->driverRead($item), $items)
-                    );
-                } finally {
-                    foreach ($items as $item) {
-                        $driverArray = $driverArrays[$item->getKey()] ?? null;
-                        if ($driverArray !== null) {
-                            $item->set($this->driverUnwrapData($driverArray));
-                            $item->expiresAt($this->driverUnwrapEdate($driverArray));
-                            if ($this->getConfig()->isItemDetailedDate()) {
-                                /**
-                                 * If the itemDetailedDate has been
-                                 * set after caching, we MUST inject
-                                 * a new DateTime object on the fly
-                                 */
-                                $item->setCreationDate($this->driverUnwrapCdate($driverArray) ?: new DateTime());
-                                $item->setModificationDate($this->driverUnwrapMdate($driverArray) ?: new DateTime());
-                            }
-                            $item->setTags($this->driverUnwrapTags($driverArray));
-                            $this->handleExpiredCacheItem($item);
-                        } else {
-                            $item->expiresAfter((int) abs($this->getConfig()->getDefaultTtl()));
-                        }
-                        $item->isHit() ? $this->getIO()->incReadHit() : $this->getIO()->incReadMiss();
-                    }
-                }
-            } else {
-                $index = array_key_first($keys);
-                if ($index !== null) {
-                    $items[$keys[$index]] = $this->getItem($keys[$index]);
-                }
-            }
-        } else {
-            $collection = [];
-
-            foreach ($keys as $key) {
-                $collection[$key] = $this->getItem($key);
-            }
-
-            return $collection;
-        }
-
-        $this->eventManager->dispatch(Event::CACHE_GET_ITEMS, $this, $items);
-
-        return $items;
-    }
-
-    /**
-     * @param string $key
-     * @return ExtendedCacheItemInterface
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws PhpfastcacheDriverException
-     *
-     * @SuppressWarnings(PHPMD.NPathComplexity)
-     * @SuppressWarnings(PHPMD.GotoStatement)
-     */
-    public function getItem(string $key): ExtendedCacheItemInterface
-    {
-        /**
-         * Replace array_key_exists by isset
-         * due to performance issue on huge
-         * loop dispatching operations
-         */
-        if (!isset($this->itemInstances[$key]) || !$this->getConfig()->isUseStaticItemCaching()) {
-            $this->validateCacheKeys($key);
-
-            /** @var $item ExtendedCacheItemInterface */
-            $item = new (self::getItemClass())($this, $key, $this->eventManager);
-
-            $getItemDriverRead = function (float $cacheSlamsSpendSeconds = 0) use (&$getItemDriverRead, $item): void {
-                $config = $this->getConfig();
-
-                $driverArray = $this->driverRead($item);
-
-                if ($driverArray) {
-                    $driverData = $this->driverUnwrapData($driverArray);
-
-                    if ($config instanceof IOConfigurationOptionInterface && $config->isPreventCacheSlams()) {
-                        while ($driverData instanceof ItemBatch) {
-                            if ($driverData->getItemDate()->getTimestamp() + $config->getCacheSlamsTimeout() < \time()) {
-                                /**
-                                 * The timeout has been reached
-                                 * Consider that the batch has
-                                 * failed and serve an empty item
-                                 * to avoid get stuck with a
-                                 * batch item stored in driver
-                                 */
-                                $this->handleExpiredCacheItem($item);
-                                return;
-                            }
-
-                            $this->eventManager->dispatch(Event::CACHE_GET_ITEM_IN_SLAM_BATCH, $this, $driverData, $cacheSlamsSpendSeconds);
-
-                            /**
-                             * Wait for a second before
-                             * attempting to get exit
-                             * the current batch process
-                             */
-                            \usleep(100000);
-
-                            $getItemDriverRead($cacheSlamsSpendSeconds + 0.1);
-                        }
-                    }
-
-                    $item->set($driverData);
-                    $item->expiresAt($this->driverUnwrapEdate($driverArray));
-
-                    if ($this->getConfig()->isItemDetailedDate()) {
-                        /**
-                         * If the itemDetailedDate has been
-                         * set after caching, we MUST inject
-                         * a new DateTime object on the fly
-                         */
-                        $item->setCreationDate($this->driverUnwrapCdate($driverArray) ?: new DateTime());
-                        $item->setModificationDate($this->driverUnwrapMdate($driverArray) ?: new DateTime());
-                    }
-
-                    $item->setTags($this->driverUnwrapTags($driverArray));
-                    $this->handleExpiredCacheItem($item);
-                } else {
-                    $item->expiresAfter((int) abs($this->getConfig()->getDefaultTtl()));
-                }
-            };
-            $getItemDriverRead();
-        } else {
-            $item = $this->itemInstances[$key];
-        }
-
-        $this->eventManager->dispatch(Event::CACHE_GET_ITEM, $this, $item);
-
-        $item->isHit() ? $this->getIO()->incReadHit() : $this->getIO()->incReadMiss();
-
-        return $item;
-    }
-
-    /**
-     * @param string $key
-     * @return bool
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function hasItem(string $key): bool
-    {
-        return $this->getItem($key)->isHit();
-    }
-
-    /**
-     * @return bool
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheLogicException
-     * @throws PhpfastcacheIOException
-     */
-    public function clear(): bool
-    {
-        $this->eventManager->dispatch(Event::CACHE_CLEAR_ITEM, $this, $this->itemInstances);
-
-        $this->getIO()->incWriteHit();
-        // Faster than detachAllItems()
-        $this->itemInstances = [];
-
-        return $this->driverClear();
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function deleteItems(array $keys): bool
-    {
-        if (count($keys) > 1) {
-            $return = true;
-            try {
-                $items = $this->getItems($keys);
-                $return = $this->driverDeleteMultiple($keys);
-                foreach ($items as $item) {
-                    $item->setHit(false);
-
-                    if (!\str_starts_with($item->getKey(), TaggableCacheItemPoolInterface::DRIVER_TAGS_KEY_PREFIX)) {
-                        $this->cleanItemTags($item);
-                    }
-                }
-                $this->getIO()->incWriteHit();
-                $this->eventManager->dispatch(Event::CACHE_DELETE_ITEMS, $this, $items);
-                $this->deregisterItems($keys);
-            } catch (PhpfastcacheUnsupportedMethodException) {
-                foreach ($keys as $key) {
-                    $result = $this->deleteItem($key);
-                    if ($result !== true) {
-                        $return = false;
-                    }
-                }
-            }
-
-            return $return;
-        }
-
-        $index = array_key_first($keys);
-        if ($index !== null) {
-            return $this->deleteItem($keys[$index]);
-        }
-
-        return false;
-    }
-
-    /**
-     * @param string $key
-     * @return bool
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function deleteItem(string $key): bool
-    {
-        $item = $this->getItem($key);
-        if ($item->isHit()) {
-            $result = $this->driverDelete($item->getKey(), $item->getEncodedKey());
-            $item->setHit(false);
-            $this->getIO()->incWriteHit();
-
-            $this->eventManager->dispatch(Event::CACHE_DELETE_ITEM, $this, $item);
-
-            /**
-             * De-register the item instance
-             * then collect gc cycles
-             */
-            $this->deregisterItem($key);
-
-            /**
-             * Perform a tag cleanup to avoid memory leaks
-             */
-            if (!\str_starts_with($key, TaggableCacheItemPoolInterface::DRIVER_TAGS_KEY_PREFIX)) {
-                $this->cleanItemTags($item);
-            }
-
-            return $result;
-        }
-
-        return false;
-    }
-
-    /**
-     * @param CacheItemInterface $item
-     * @return bool
-     */
-    public function saveDeferred(CacheItemInterface $item): bool
-    {
-        $this->assertCacheItemType($item, self::getItemClass());
-        if (!\array_key_exists($item->getKey(), $this->itemInstances)) {
-            $this->itemInstances[$item->getKey()] = $item;
-        } elseif (\spl_object_hash($item) !== \spl_object_hash($this->itemInstances[$item->getKey()])) {
-            throw new RuntimeException('Spl object hash mismatches ! You probably tried to save a detached item which has been already retrieved from cache.');
-        }
-
-        $this->eventManager->dispatch(Event::CACHE_SAVE_DEFERRED_ITEM, $this, $item);
-        $this->deferredList[$item->getKey()] = $item;
-
-        return true;
-    }
-
-    /**
-     * @return bool
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function commit(): bool
-    {
-        $this->eventManager->dispatch(Event::CACHE_COMMIT_ITEM, $this, new EventReferenceParameter($this->deferredList));
-
-        if (\count($this->deferredList)) {
-            $return = true;
-            foreach ($this->deferredList as $key => $item) {
-                $result = $this->save($item);
-                unset($this->deferredList[$key]);
-                if ($result !== true) {
-                    $return = $result;
-                }
-            }
-
-            return $return;
-        }
-        return false;
-    }
-
-    /**
-     * @param CacheItemInterface $item
-     * @return bool
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheIOException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function save(CacheItemInterface $item): bool
-    {
-        $this->assertCacheItemType($item, self::getItemClass());
-        /**
-         * @var ExtendedCacheItemInterface $item
-         *
-         * Replace array_key_exists by isset
-         * due to performance issue on huge
-         * loop dispatching operations
-         */
-        if (!isset($this->itemInstances[$item->getKey()])) {
-            if ($this->getConfig()->isUseStaticItemCaching()) {
-                $this->itemInstances[$item->getKey()] = $item;
-            }
-        } elseif (\spl_object_hash($item) !== \spl_object_hash($this->itemInstances[$item->getKey()])) {
-            throw new RuntimeException('Spl object hash mismatches ! You probably tried to save a detached item which has been already retrieved from cache.');
-        }
-
-        $this->assertCacheItemType($item, self::getItemClass());
-        $this->eventManager->dispatch(Event::CACHE_SAVE_ITEM, $this, $item);
-
-        if ($this->getConfig() instanceof IOConfigurationOptionInterface && $this->getConfig()->isPreventCacheSlams()) {
-            /**
-             * @var $itemBatch ExtendedCacheItemInterface
-             */
-            $itemClassName = self::getItemClass();
-            $itemBatch = new $itemClassName($this, $item->getKey(), $this->eventManager);
-            $itemBatch->set(new ItemBatch($item->getKey(), new DateTime()))
-                ->expiresAfter($this->getConfig()->getCacheSlamsTimeout());
-
-            /**
-             * To avoid SPL mismatches
-             * we have to re-attach the
-             * original item to the pool
-             */
-            $this->driverWrite($itemBatch);
-            $this->detachItem($itemBatch);
-            $this->attachItem($item);
-        }
-
-
-        if ($this->driverWrite($item) && $this->driverWriteTags($item)) {
-            $item->setHit(true)
-                ->clearRemovedTags();
-
-            if ($this->getConfig()->isItemDetailedDate()) {
-                $item->setModificationDate(new \DateTime());
-            }
-
-            $this->getIO()->incWriteHit();
-
-            return true;
-        }
-
-        return false;
-    }
-
-    /**
-     * @return DriverIO
-     */
-    public function getIO(): DriverIO
-    {
-        return $this->IO;
-    }
-
-    /**
-     * @internal This method de-register an item from $this->itemInstances
-     */
-    protected function deregisterItem(string $itemKey): static
-    {
-        unset($this->itemInstances[$itemKey]);
-
-        if (\gc_enabled()) {
-            \gc_collect_cycles();
-        }
-
-        return $this;
-    }
-
-    /**
-     * @param string[] $itemKeys
-     * @internal This method de-register multiple items from $this->itemInstances
-     */
-    protected function deregisterItems(array $itemKeys): static
-    {
-        $this->itemInstances = array_diff_key($this->itemInstances, array_flip($itemKeys));
-
-        if (\gc_enabled()) {
-            \gc_collect_cycles();
-        }
-
-        return $this;
-    }
-
-    /**
-     * @throws PhpfastcacheLogicException
-     */
-    public function attachItem(CacheItemInterface $item): static
-    {
-        if (isset($this->itemInstances[$item->getKey()]) && \spl_object_hash($item) !== \spl_object_hash($this->itemInstances[$item->getKey()])) {
-            throw new PhpfastcacheLogicException(
-                'The item already exists and cannot be overwritten because the Spl object hash mismatches ! 
+	use DriverBaseTrait {
+		DriverBaseTrait::__construct as __driverBaseConstruct;
+	}
+
+	/**
+	 * @var string
+	 */
+	protected static string $unsupportedKeyChars = '{}()/\@:';
+
+	/**
+	 * @var ExtendedCacheItemInterface[]|CacheItemInterface[]
+	 */
+	protected array $deferredList = [];
+
+	/**
+	 * @var ExtendedCacheItemInterface[]|CacheItemInterface[]
+	 */
+	protected array $itemInstances = [];
+
+	protected DriverIO $IO;
+
+	public function __construct(#[\SensitiveParameter] ConfigurationOptionInterface $config, string $instanceId, EventManagerInterface $em)
+	{
+		$this->IO = new DriverIO();
+		$this->__driverBaseConstruct($config, $instanceId, $em);
+	}
+
+	/**
+	 * @throws PhpfastcacheLogicException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 */
+	public function setItem(CacheItemInterface $item): static
+	{
+		if (self::getItemClass() === $item::class) {
+			if (!$this->getConfig()->isUseStaticItemCaching()) {
+				throw new PhpfastcacheLogicException(
+					'The static item caching option (useStaticItemCaching) is disabled so you cannot attach an item.'
+				);
+			}
+
+			$this->itemInstances[$item->getKey()] = $item;
+
+			return $this;
+		}
+		throw new PhpfastcacheInvalidArgumentException(
+			\sprintf(
+				'Invalid cache item class "%s" for driver "%s".',
+				get_class($item),
+				get_class($this)
+			)
+		);
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function getItems(array $keys = []): iterable
+	{
+		$items = [];
+
+		/**
+		 * Usually, drivers that are able to enable cache slams
+		 * does not benefit of driverReadMultiple() call.
+		 */
+		if (!$this->getConfig()->isPreventCacheSlams()) {
+			$this->validateCacheKeys(...$keys);
+
+			/**
+			 * Check for local item instances first.
+			 */
+			foreach ($keys as $index => $key) {
+				if (isset($this->itemInstances[$key]) && $this->getConfig()->isUseStaticItemCaching()) {
+					$items[$key] = $this->itemInstances[$key];
+					// Key already exists in local item instances, no need to fetch it again.
+					unset($keys[$index]);
+				}
+			}
+			$keys = array_values($keys);
+
+			/**
+			 * If there's still keys to fetch, let's choose the right method (if supported).
+			 */
+			if (count($keys) > 1) {
+				$items = array_merge(
+					array_combine($keys, array_map(fn($key) => new (self::getItemClass())($this, $key, $this->eventManager), $keys)),
+					$items
+				);
+
+				try {
+					$driverArrays = $this->driverReadMultiple(...$items);
+				} catch (PhpfastcacheUnsupportedMethodException) {
+					/**
+					 * Fallback for drivers that does not yet implement driverReadMultiple() method.
+					 */
+					$driverArrays = array_combine(
+						array_map(fn($item) => $item->getKey(), $items),
+						array_map(fn($item) => $this->driverRead($item), $items)
+					);
+				} finally {
+					foreach ($items as $item) {
+						$driverArray = $driverArrays[$item->getKey()] ?? null;
+						if ($driverArray !== null) {
+							$item->set($this->driverUnwrapData($driverArray));
+							$item->expiresAt($this->driverUnwrapEdate($driverArray));
+							if ($this->getConfig()->isItemDetailedDate()) {
+								/**
+								 * If the itemDetailedDate has been
+								 * set after caching, we MUST inject
+								 * a new DateTime object on the fly
+								 */
+								$item->setCreationDate($this->driverUnwrapCdate($driverArray) ?: new DateTime());
+								$item->setModificationDate($this->driverUnwrapMdate($driverArray) ?: new DateTime());
+							}
+							$item->setTags($this->driverUnwrapTags($driverArray));
+							$this->handleExpiredCacheItem($item);
+						} else {
+							$item->expiresAfter((int) abs($this->getConfig()->getDefaultTtl()));
+						}
+						$item->isHit() ? $this->getIO()->incReadHit() : $this->getIO()->incReadMiss();
+					}
+				}
+			} else {
+				$index = array_key_first($keys);
+				if ($index !== null) {
+					$items[$keys[$index]] = $this->getItem($keys[$index]);
+				}
+			}
+		} else {
+			$collection = [];
+
+			foreach ($keys as $key) {
+				$collection[$key] = $this->getItem($key);
+			}
+
+			return $collection;
+		}
+
+		$this->eventManager->dispatch(Event::CACHE_GET_ITEMS, $this, $items);
+
+		return $items;
+	}
+
+	/**
+	 * @param string $key
+	 * @return ExtendedCacheItemInterface
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws PhpfastcacheDriverException
+	 *
+	 * @SuppressWarnings(PHPMD.NPathComplexity)
+	 * @SuppressWarnings(PHPMD.GotoStatement)
+	 */
+	public function getItem(string $key): ExtendedCacheItemInterface
+	{
+		/**
+		 * Replace array_key_exists by isset
+		 * due to performance issue on huge
+		 * loop dispatching operations
+		 */
+		if (!isset($this->itemInstances[$key]) || !$this->getConfig()->isUseStaticItemCaching()) {
+			$this->validateCacheKeys($key);
+
+			/** @var $item ExtendedCacheItemInterface */
+			$item = new (self::getItemClass())($this, $key, $this->eventManager);
+
+			$getItemDriverRead = function (float $cacheSlamsSpendSeconds = 0) use (&$getItemDriverRead, $item): void {
+				$config = $this->getConfig();
+
+				$driverArray = $this->driverRead($item);
+
+				if ($driverArray) {
+					$driverData = $this->driverUnwrapData($driverArray);
+
+					if ($config instanceof IOConfigurationOptionInterface && $config->isPreventCacheSlams()) {
+						while ($driverData instanceof ItemBatch) {
+							if ($driverData->getItemDate()->getTimestamp() + $config->getCacheSlamsTimeout() < \time()) {
+								/**
+								 * The timeout has been reached
+								 * Consider that the batch has
+								 * failed and serve an empty item
+								 * to avoid get stuck with a
+								 * batch item stored in driver
+								 */
+								$this->handleExpiredCacheItem($item);
+								return;
+							}
+
+							$this->eventManager->dispatch(Event::CACHE_GET_ITEM_IN_SLAM_BATCH, $this, $driverData, $cacheSlamsSpendSeconds);
+
+							/**
+							 * Wait for a second before
+							 * attempting to get exit
+							 * the current batch process
+							 */
+							\usleep(100000);
+
+							$getItemDriverRead($cacheSlamsSpendSeconds + 0.1);
+						}
+					}
+
+					$item->set($driverData);
+					$item->expiresAt($this->driverUnwrapEdate($driverArray));
+
+					if ($this->getConfig()->isItemDetailedDate()) {
+						/**
+						 * If the itemDetailedDate has been
+						 * set after caching, we MUST inject
+						 * a new DateTime object on the fly
+						 */
+						$item->setCreationDate($this->driverUnwrapCdate($driverArray) ?: new DateTime());
+						$item->setModificationDate($this->driverUnwrapMdate($driverArray) ?: new DateTime());
+					}
+
+					$item->setTags($this->driverUnwrapTags($driverArray));
+					$this->handleExpiredCacheItem($item);
+				} else {
+					$item->expiresAfter((int) abs($this->getConfig()->getDefaultTtl()));
+				}
+			};
+			$getItemDriverRead();
+		} else {
+			$item = $this->itemInstances[$key];
+		}
+
+		$this->eventManager->dispatch(Event::CACHE_GET_ITEM, $this, $item);
+
+		$item->isHit() ? $this->getIO()->incReadHit() : $this->getIO()->incReadMiss();
+
+		return $item;
+	}
+
+	/**
+	 * @param string $key
+	 * @return bool
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function hasItem(string $key): bool
+	{
+		return $this->getItem($key)->isHit();
+	}
+
+	/**
+	 * @return bool
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheLogicException
+	 * @throws PhpfastcacheIOException
+	 */
+	public function clear(): bool
+	{
+		$this->eventManager->dispatch(Event::CACHE_CLEAR_ITEM, $this, $this->itemInstances);
+
+		$this->getIO()->incWriteHit();
+		// Faster than detachAllItems()
+		$this->itemInstances = [];
+
+		return $this->driverClear();
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function deleteItems(array $keys): bool
+	{
+		if (count($keys) > 1) {
+			$return = true;
+			try {
+				$items = $this->getItems($keys);
+				$return = $this->driverDeleteMultiple($keys);
+				foreach ($items as $item) {
+					$item->setHit(false);
+
+					if (!\str_starts_with($item->getKey(), TaggableCacheItemPoolInterface::DRIVER_TAGS_KEY_PREFIX)) {
+						$this->cleanItemTags($item);
+					}
+				}
+				$this->getIO()->incWriteHit();
+				$this->eventManager->dispatch(Event::CACHE_DELETE_ITEMS, $this, $items);
+				$this->deregisterItems($keys);
+			} catch (PhpfastcacheUnsupportedMethodException) {
+				foreach ($keys as $key) {
+					$result = $this->deleteItem($key);
+					if ($result !== true) {
+						$return = false;
+					}
+				}
+			}
+
+			return $return;
+		}
+
+		$index = array_key_first($keys);
+		if ($index !== null) {
+			return $this->deleteItem($keys[$index]);
+		}
+
+		return false;
+	}
+
+	/**
+	 * @param string $key
+	 * @return bool
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function deleteItem(string $key): bool
+	{
+		$item = $this->getItem($key);
+		if ($item->isHit()) {
+			$result = $this->driverDelete($item->getKey(), $item->getEncodedKey());
+			$item->setHit(false);
+			$this->getIO()->incWriteHit();
+
+			$this->eventManager->dispatch(Event::CACHE_DELETE_ITEM, $this, $item);
+
+			/**
+			 * De-register the item instance
+			 * then collect gc cycles
+			 */
+			$this->deregisterItem($key);
+
+			/**
+			 * Perform a tag cleanup to avoid memory leaks
+			 */
+			if (!\str_starts_with($key, TaggableCacheItemPoolInterface::DRIVER_TAGS_KEY_PREFIX)) {
+				$this->cleanItemTags($item);
+			}
+
+			return $result;
+		}
+
+		return false;
+	}
+
+	/**
+	 * @param CacheItemInterface $item
+	 * @return bool
+	 */
+	public function saveDeferred(CacheItemInterface $item): bool
+	{
+		$this->assertCacheItemType($item, self::getItemClass());
+		if (!\array_key_exists($item->getKey(), $this->itemInstances)) {
+			$this->itemInstances[$item->getKey()] = $item;
+		} elseif (\spl_object_hash($item) !== \spl_object_hash($this->itemInstances[$item->getKey()])) {
+			throw new RuntimeException('Spl object hash mismatches ! You probably tried to save a detached item which has been already retrieved from cache.');
+		}
+
+		$this->eventManager->dispatch(Event::CACHE_SAVE_DEFERRED_ITEM, $this, $item);
+		$this->deferredList[$item->getKey()] = $item;
+
+		return true;
+	}
+
+	/**
+	 * @return bool
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function commit(): bool
+	{
+		$this->eventManager->dispatch(Event::CACHE_COMMIT_ITEM, $this, new EventReferenceParameter($this->deferredList));
+
+		if (\count($this->deferredList)) {
+			$return = true;
+			foreach ($this->deferredList as $key => $item) {
+				$result = $this->save($item);
+				unset($this->deferredList[$key]);
+				if ($result !== true) {
+					$return = $result;
+				}
+			}
+
+			return $return;
+		}
+		return false;
+	}
+
+	/**
+	 * @param CacheItemInterface $item
+	 * @return bool
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheIOException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function save(CacheItemInterface $item): bool
+	{
+		$this->assertCacheItemType($item, self::getItemClass());
+		/**
+		 * @var ExtendedCacheItemInterface $item
+		 *
+		 * Replace array_key_exists by isset
+		 * due to performance issue on huge
+		 * loop dispatching operations
+		 */
+		if (!isset($this->itemInstances[$item->getKey()])) {
+			if ($this->getConfig()->isUseStaticItemCaching()) {
+				$this->itemInstances[$item->getKey()] = $item;
+			}
+		} elseif (\spl_object_hash($item) !== \spl_object_hash($this->itemInstances[$item->getKey()])) {
+			throw new RuntimeException('Spl object hash mismatches ! You probably tried to save a detached item which has been already retrieved from cache.');
+		}
+
+		$this->assertCacheItemType($item, self::getItemClass());
+		$this->eventManager->dispatch(Event::CACHE_SAVE_ITEM, $this, $item);
+
+		if ($this->getConfig() instanceof IOConfigurationOptionInterface && $this->getConfig()->isPreventCacheSlams()) {
+			/**
+			 * @var $itemBatch ExtendedCacheItemInterface
+			 */
+			$itemClassName = self::getItemClass();
+			$itemBatch = new $itemClassName($this, $item->getKey(), $this->eventManager);
+			$itemBatch->set(new ItemBatch($item->getKey(), new DateTime()))
+				->expiresAfter($this->getConfig()->getCacheSlamsTimeout());
+
+			/**
+			 * To avoid SPL mismatches
+			 * we have to re-attach the
+			 * original item to the pool
+			 */
+			$this->driverWrite($itemBatch);
+			$this->detachItem($itemBatch);
+			$this->attachItem($item);
+		}
+
+
+		if ($this->driverWrite($item) && $this->driverWriteTags($item)) {
+			$item->setHit(true)
+				->clearRemovedTags();
+
+			if ($this->getConfig()->isItemDetailedDate()) {
+				$item->setModificationDate(new \DateTime());
+			}
+
+			$this->getIO()->incWriteHit();
+
+			return true;
+		}
+
+		return false;
+	}
+
+	/**
+	 * @return DriverIO
+	 */
+	public function getIO(): DriverIO
+	{
+		return $this->IO;
+	}
+
+	/**
+	 * @internal This method de-register an item from $this->itemInstances
+	 */
+	protected function deregisterItem(string $itemKey): static
+	{
+		unset($this->itemInstances[$itemKey]);
+
+		if (\gc_enabled()) {
+			\gc_collect_cycles();
+		}
+
+		return $this;
+	}
+
+	/**
+	 * @param string[] $itemKeys
+	 * @internal This method de-register multiple items from $this->itemInstances
+	 */
+	protected function deregisterItems(array $itemKeys): static
+	{
+		$this->itemInstances = array_diff_key($this->itemInstances, array_flip($itemKeys));
+
+		if (\gc_enabled()) {
+			\gc_collect_cycles();
+		}
+
+		return $this;
+	}
+
+	/**
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function attachItem(CacheItemInterface $item): static
+	{
+		if (isset($this->itemInstances[$item->getKey()]) && \spl_object_hash($item) !== \spl_object_hash($this->itemInstances[$item->getKey()])) {
+			throw new PhpfastcacheLogicException(
+				'The item already exists and cannot be overwritten because the Spl object hash mismatches ! 
                 You probably tried to re-attach a detached item which has been already retrieved from cache.'
-            );
-        }
-
-        if (!$this->getConfig()->isUseStaticItemCaching()) {
-            throw new PhpfastcacheLogicException(
-                'The static item caching option (useStaticItemCaching) is disabled so you cannot attach an item.'
-            );
-        }
-
-        $this->itemInstances[$item->getKey()] = $item;
-
-        return $this;
-    }
-
-    public function isAttached(CacheItemInterface $item): bool
-    {
-        if (isset($this->itemInstances[$item->getKey()])) {
-            return \spl_object_hash($item) === \spl_object_hash($this->itemInstances[$item->getKey()]);
-        }
-        return false;
-    }
-
-    protected function validateCacheKeys(string ...$keys): void
-    {
-        foreach ($keys as $key) {
-            if (\preg_match('~([' . \preg_quote(self::$unsupportedKeyChars, '~') . ']+)~', $key, $matches)) {
-                throw new PhpfastcacheInvalidArgumentException(
-                    'Unsupported key character detected: "' . $matches[1] . '". 
+			);
+		}
+
+		if (!$this->getConfig()->isUseStaticItemCaching()) {
+			throw new PhpfastcacheLogicException(
+				'The static item caching option (useStaticItemCaching) is disabled so you cannot attach an item.'
+			);
+		}
+
+		$this->itemInstances[$item->getKey()] = $item;
+
+		return $this;
+	}
+
+	public function isAttached(CacheItemInterface $item): bool
+	{
+		if (isset($this->itemInstances[$item->getKey()])) {
+			return \spl_object_hash($item) === \spl_object_hash($this->itemInstances[$item->getKey()]);
+		}
+		return false;
+	}
+
+	protected function validateCacheKeys(string ...$keys): void
+	{
+		foreach ($keys as $key) {
+			if (\preg_match('~([' . \preg_quote(self::$unsupportedKeyChars, '~') . ']+)~', $key, $matches)) {
+				throw new PhpfastcacheInvalidArgumentException(
+					'Unsupported key character detected: "' . $matches[1] . '". 
                     Please check: https://github.com/PHPSocialNetwork/phpfastcache/wiki/%5BV6%5D-Unsupported-characters-in-key-identifiers'
-                );
-            }
-        }
-    }
-
-    protected function handleExpiredCacheItem(ExtendedCacheItemInterface $item): void
-    {
-        if ($item->isExpired()) {
-            /**
-             * Using driverDelete() instead of delete()
-             * to avoid infinite loop caused by
-             * getItem() call in delete() method
-             * As we MUST return an item in any
-             * way, we do not de-register here
-             */
-            $this->driverDelete($item->getKey(), $item->getEncodedKey());
-
-            /**
-             * Reset the Item
-             */
-            $item->set(null)
-                ->expiresAfter((int) abs($this->getConfig()->getDefaultTtl()))
-                ->setHit(false)
-                ->setTags([]);
-
-            if ($this->getConfig()->isItemDetailedDate()) {
-                /**
-                 * If the itemDetailedDate has been
-                 * set after caching, we MUST inject
-                 * a new DateTime object on the fly
-                 */
-                $item->setCreationDate(new DateTime());
-                $item->setModificationDate(new DateTime());
-            }
-        } else {
-            $item->setHit(true);
-        }
-    }
-
-    /**
-     * @param ExtendedCacheItemInterface[] $items
-     * @param bool $encoded
-     * @param string $keyPrefix
-     * @return string[]
-     */
-    protected function getKeys(array $items, bool $encoded = false, string $keyPrefix = ''): array
-    {
-        return array_map(
-            static fn(ExtendedCacheItemInterface $item) => $keyPrefix . ($encoded ? $item->getEncodedKey() : $item->getKey()),
-            $items
-        );
-    }
+				);
+			}
+		}
+	}
+
+	protected function handleExpiredCacheItem(ExtendedCacheItemInterface $item): void
+	{
+		if ($item->isExpired()) {
+			/**
+			 * Using driverDelete() instead of delete()
+			 * to avoid infinite loop caused by
+			 * getItem() call in delete() method
+			 * As we MUST return an item in any
+			 * way, we do not de-register here
+			 */
+			$this->driverDelete($item->getKey(), $item->getEncodedKey());
+
+			/**
+			 * Reset the Item
+			 */
+			$item->set(null)
+				->expiresAfter((int) abs($this->getConfig()->getDefaultTtl()))
+				->setHit(false)
+				->setTags([]);
+
+			if ($this->getConfig()->isItemDetailedDate()) {
+				/**
+				 * If the itemDetailedDate has been
+				 * set after caching, we MUST inject
+				 * a new DateTime object on the fly
+				 */
+				$item->setCreationDate(new DateTime());
+				$item->setModificationDate(new DateTime());
+			}
+		} else {
+			$item->setHit(true);
+		}
+	}
+
+	/**
+	 * @param ExtendedCacheItemInterface[] $items
+	 * @param bool $encoded
+	 * @param string $keyPrefix
+	 * @return string[]
+	 */
+	protected function getKeys(array $items, bool $encoded = false, string $keyPrefix = ''): array
+	{
+		return array_map(
+			static fn(ExtendedCacheItemInterface $item) => $keyPrefix . ($encoded ? $item->getEncodedKey() : $item->getKey()),
+			$items
+		);
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -211,7 +211,7 @@
             /** @var $item ExtendedCacheItemInterface */
             $item = new (self::getItemClass())($this, $key, $this->eventManager);
 
-            $getItemDriverRead = function (float $cacheSlamsSpendSeconds = 0) use (&$getItemDriverRead, $item): void {
+            $getItemDriverRead = function(float $cacheSlamsSpendSeconds = 0) use (&$getItemDriverRead, $item): void {
                 $config = $this->getConfig();
 
                 $driverArray = $this->driverRead($item);

Braces +23 added lines, -13 removed lines

@@ -62,8 +62,7 @@ 
 
     protected DriverIO $IO;
 
-    public function __construct(#[\SensitiveParameter] ConfigurationOptionInterface $config, string $instanceId, EventManagerInterface $em)
-    {
+    public function __construct(#[\SensitiveParameter] ConfigurationOptionInterface $config, string $instanceId, EventManagerInterface $em) {
         $this->IO = new DriverIO();
         $this->__driverBaseConstruct($config, $instanceId, $em);
     }
@@ -135,7 +134,8 @@ 
 
                 try {
                     $driverArrays = $this->driverReadMultiple(...$items);
-                } catch (PhpfastcacheUnsupportedMethodException) {
+                }
+                catch (PhpfastcacheUnsupportedMethodException) {
                     /**
                      * Fallback for drivers that does not yet implement driverReadMultiple() method.
                      */
@@ -143,7 +143,8 @@ 
                         array_map(fn($item) => $item->getKey(), $items),
                         array_map(fn($item) => $this->driverRead($item), $items)
                     );
-                } finally {
+                }
+                finally {
                     foreach ($items as $item) {
                         $driverArray = $driverArrays[$item->getKey()] ?? null;
                         if ($driverArray !== null) {
@@ -160,19 +161,22 @@ 
                             }
                             $item->setTags($this->driverUnwrapTags($driverArray));
                             $this->handleExpiredCacheItem($item);
-                        } else {
+                        }
+                        else {
                             $item->expiresAfter((int) abs($this->getConfig()->getDefaultTtl()));
                         }
                         $item->isHit() ? $this->getIO()->incReadHit() : $this->getIO()->incReadMiss();
                     }
                 }
-            } else {
+            }
+            else {
                 $index = array_key_first($keys);
                 if ($index !== null) {
                     $items[$keys[$index]] = $this->getItem($keys[$index]);
                 }
             }
-        } else {
+        }
+        else {
             $collection = [];
 
             foreach ($keys as $key) {
@@ -261,12 +265,14 @@ 
 
                     $item->setTags($this->driverUnwrapTags($driverArray));
                     $this->handleExpiredCacheItem($item);
-                } else {
+                }
+                else {
                     $item->expiresAfter((int) abs($this->getConfig()->getDefaultTtl()));
                 }
             };
             $getItemDriverRead();
-        } else {
+        }
+        else {
             $item = $this->itemInstances[$key];
         }
 
@@ -332,7 +338,8 @@ 
                 $this->getIO()->incWriteHit();
                 $this->eventManager->dispatch(Event::CACHE_DELETE_ITEMS, $this, $items);
                 $this->deregisterItems($keys);
-            } catch (PhpfastcacheUnsupportedMethodException) {
+            }
+            catch (PhpfastcacheUnsupportedMethodException) {
                 foreach ($keys as $key) {
                     $result = $this->deleteItem($key);
                     if ($result !== true) {
@@ -398,7 +405,8 @@ 
         $this->assertCacheItemType($item, self::getItemClass());
         if (!\array_key_exists($item->getKey(), $this->itemInstances)) {
             $this->itemInstances[$item->getKey()] = $item;
-        } elseif (\spl_object_hash($item) !== \spl_object_hash($this->itemInstances[$item->getKey()])) {
+        }
+        elseif (\spl_object_hash($item) !== \spl_object_hash($this->itemInstances[$item->getKey()])) {
             throw new RuntimeException('Spl object hash mismatches ! You probably tried to save a detached item which has been already retrieved from cache.');
         }
 
@@ -457,7 +465,8 @@ 
             if ($this->getConfig()->isUseStaticItemCaching()) {
                 $this->itemInstances[$item->getKey()] = $item;
             }
-        } elseif (\spl_object_hash($item) !== \spl_object_hash($this->itemInstances[$item->getKey()])) {
+        }
+        elseif (\spl_object_hash($item) !== \spl_object_hash($this->itemInstances[$item->getKey()])) {
             throw new RuntimeException('Spl object hash mismatches ! You probably tried to save a detached item which has been already retrieved from cache.');
         }
 
@@ -609,7 +618,8 @@ 
                 $item->setCreationDate(new DateTime());
                 $item->setModificationDate(new DateTime());
             }
-        } else {
+        }
+        else {
             $item->setHit(true);
         }
     }

plugins/files/php/vendor/phpfastcache/phpfastcache/lib/Phpfastcache/Core/Pool/TaggableCacheItemPoolInterface.php

Indentation +247 added lines, -247 removed lines

@@ -21,268 +21,268 @@
 
 interface TaggableCacheItemPoolInterface
 {
-    public const DRIVER_TAGS_KEY_PREFIX = '_TAG_';
+	public const DRIVER_TAGS_KEY_PREFIX = '_TAG_';
 
-    public const DRIVER_TAGS_WRAPPER_INDEX = 'g';
+	public const DRIVER_TAGS_WRAPPER_INDEX = 'g';
 
-    /**
-     * Allows you to get cache item(s) by at least **ONE** of the specified matching tag(s).
-     * Default behavior
-     */
-    public const TAG_STRATEGY_ONE = 1;
+	/**
+	 * Allows you to get cache item(s) by at least **ONE** of the specified matching tag(s).
+	 * Default behavior
+	 */
+	public const TAG_STRATEGY_ONE = 1;
 
-    /**
-     * Allows you to get cache item(s) by **ALL** of the specified matching tag(s)
-     * The cache item *CAN* have additional tag(s)
-     */
-    public const TAG_STRATEGY_ALL = 2;
+	/**
+	 * Allows you to get cache item(s) by **ALL** of the specified matching tag(s)
+	 * The cache item *CAN* have additional tag(s)
+	 */
+	public const TAG_STRATEGY_ALL = 2;
 
-    /**
-     * Allows you to get cache item(s) by **ONLY** the specified matching tag(s)
-     * The cache item *CANNOT* have additional tag(s)
-     */
-    public const TAG_STRATEGY_ONLY = 4;
+	/**
+	 * Allows you to get cache item(s) by **ONLY** the specified matching tag(s)
+	 * The cache item *CANNOT* have additional tag(s)
+	 */
+	public const TAG_STRATEGY_ONLY = 4;
 
-    /**
-     * Returns a traversable set of cache items by a tag name.
-     *
-     * @param string $tagName
-     * An indexed array of keys of items to retrieve.
-     *
-     * @param int $strategy
-     *
-     * @return ExtendedCacheItemInterface[]
-     *   A traversable collection of Cache Items keyed by the cache keys of
-     *   each item. A Cache item will be returned for each key, even if that
-     *   key is not found. However, if no keys are specified then an empty
-     *   traversable MUST be returned instead.
-     * @throws InvalidArgumentException
-     *   If any of the keys in $keys are not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function getItemsByTag(string $tagName, int $strategy = self::TAG_STRATEGY_ONE): array;
+	/**
+	 * Returns a traversable set of cache items by a tag name.
+	 *
+	 * @param string $tagName
+	 * An indexed array of keys of items to retrieve.
+	 *
+	 * @param int $strategy
+	 *
+	 * @return ExtendedCacheItemInterface[]
+	 *   A traversable collection of Cache Items keyed by the cache keys of
+	 *   each item. A Cache item will be returned for each key, even if that
+	 *   key is not found. However, if no keys are specified then an empty
+	 *   traversable MUST be returned instead.
+	 * @throws InvalidArgumentException
+	 *   If any of the keys in $keys are not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function getItemsByTag(string $tagName, int $strategy = self::TAG_STRATEGY_ONE): array;
 
-    /**
-     * Returns a traversable set of cache items by one of multiple tag names.
-     *
-     * @param string[] $tagNames
-     * An indexed array of keys of items to retrieve.
-     *
-     * @param int $strategy
-     *
-     * @return ExtendedCacheItemInterface[]
-     *   A traversable collection of Cache Items keyed by the cache keys of
-     *   each item. A Cache item will be returned for each key, even if that
-     *   key is not found. However, if no keys are specified then an empty
-     *   traversable MUST be returned instead.
-     * @throws InvalidArgumentException
-     *   If any of the keys in $keys are not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function getItemsByTags(array $tagNames, int $strategy = self::TAG_STRATEGY_ONE): array;
+	/**
+	 * Returns a traversable set of cache items by one of multiple tag names.
+	 *
+	 * @param string[] $tagNames
+	 * An indexed array of keys of items to retrieve.
+	 *
+	 * @param int $strategy
+	 *
+	 * @return ExtendedCacheItemInterface[]
+	 *   A traversable collection of Cache Items keyed by the cache keys of
+	 *   each item. A Cache item will be returned for each key, even if that
+	 *   key is not found. However, if no keys are specified then an empty
+	 *   traversable MUST be returned instead.
+	 * @throws InvalidArgumentException
+	 *   If any of the keys in $keys are not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function getItemsByTags(array $tagNames, int $strategy = self::TAG_STRATEGY_ONE): array;
 
-    /**
-     * Returns A json string that represents an array of items by tags-based.
-     *
-     * @param string[] $tagNames
-     * An indexed array of keys of items to retrieve.
-     * @param int $option \json_encode() options
-     * @param int $depth \json_encode() depth
-     * @param int $strategy
-     *
-     * @return string
-     * @throws InvalidArgumentException
-     *   If any of the keys in $keys are not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function getItemsByTagsAsJsonString(array $tagNames, int $option = \JSON_THROW_ON_ERROR, int $depth = 512, int $strategy = self::TAG_STRATEGY_ONE): string;
+	/**
+	 * Returns A json string that represents an array of items by tags-based.
+	 *
+	 * @param string[] $tagNames
+	 * An indexed array of keys of items to retrieve.
+	 * @param int $option \json_encode() options
+	 * @param int $depth \json_encode() depth
+	 * @param int $strategy
+	 *
+	 * @return string
+	 * @throws InvalidArgumentException
+	 *   If any of the keys in $keys are not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function getItemsByTagsAsJsonString(array $tagNames, int $option = \JSON_THROW_ON_ERROR, int $depth = 512, int $strategy = self::TAG_STRATEGY_ONE): string;
 
-    /**
-     * Removes the item from the pool by tag.
-     *
-     * @param string $tagName
-     *   The tag for which to delete
-     *
-     * @param int $strategy
-     *
-     * @return bool
-     *   True if the item was successfully removed. False if there was an error.
-     * @throws InvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function deleteItemsByTag(string $tagName, int $strategy = self::TAG_STRATEGY_ONE): bool;
+	/**
+	 * Removes the item from the pool by tag.
+	 *
+	 * @param string $tagName
+	 *   The tag for which to delete
+	 *
+	 * @param int $strategy
+	 *
+	 * @return bool
+	 *   True if the item was successfully removed. False if there was an error.
+	 * @throws InvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function deleteItemsByTag(string $tagName, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
-    /**
-     * Removes the item from the pool by one of multiple tag names.
-     *
-     * @param string[] $tagNames
-     *   The tag for which to delete
-     *
-     * @param int $strategy
-     *
-     * @return bool
-     *   True if the items were successfully removed. False if there was an error.
-     * @throws InvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function deleteItemsByTags(array $tagNames, int $strategy = self::TAG_STRATEGY_ONE): bool;
+	/**
+	 * Removes the item from the pool by one of multiple tag names.
+	 *
+	 * @param string[] $tagNames
+	 *   The tag for which to delete
+	 *
+	 * @param int $strategy
+	 *
+	 * @return bool
+	 *   True if the items were successfully removed. False if there was an error.
+	 * @throws InvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function deleteItemsByTags(array $tagNames, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
-    /**
-     * Increment the items from the pool by tag.
-     *
-     * @param string $tagName
-     *   The tag for which to increment
-     *
-     * @param int $step
-     *
-     * @param int $strategy
-     *
-     * @return bool
-     *   True if the item was successfully incremented. False if there was an error.
-     * @throws InvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function incrementItemsByTag(string $tagName, int $step = 1, int $strategy = self::TAG_STRATEGY_ONE): bool;
+	/**
+	 * Increment the items from the pool by tag.
+	 *
+	 * @param string $tagName
+	 *   The tag for which to increment
+	 *
+	 * @param int $step
+	 *
+	 * @param int $strategy
+	 *
+	 * @return bool
+	 *   True if the item was successfully incremented. False if there was an error.
+	 * @throws InvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function incrementItemsByTag(string $tagName, int $step = 1, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
-    /**
-     * Increment the items from the pool by one of multiple tag names.
-     *
-     * @param string[] $tagNames
-     *   The tag for which to increment
-     *
-     * @param int $step
-     *
-     * @param int $strategy
-     *
-     * @return bool
-     *   True if the items were successfully incremented. False if there was an error.
-     * @throws InvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function incrementItemsByTags(array $tagNames, int $step = 1, int $strategy = self::TAG_STRATEGY_ONE): bool;
+	/**
+	 * Increment the items from the pool by one of multiple tag names.
+	 *
+	 * @param string[] $tagNames
+	 *   The tag for which to increment
+	 *
+	 * @param int $step
+	 *
+	 * @param int $strategy
+	 *
+	 * @return bool
+	 *   True if the items were successfully incremented. False if there was an error.
+	 * @throws InvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function incrementItemsByTags(array $tagNames, int $step = 1, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
-    /**
-     * Decrement the items from the pool by tag.
-     *
-     * @param string $tagName
-     *   The tag for which to decrement
-     *
-     * @param int $step
-     *
-     * @param int $strategy
-     *
-     * @return bool
-     *   True if the item was successfully decremented. False if there was an error.
-     * @throws InvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function decrementItemsByTag(string $tagName, int $step = 1, int $strategy = self::TAG_STRATEGY_ONE): bool;
+	/**
+	 * Decrement the items from the pool by tag.
+	 *
+	 * @param string $tagName
+	 *   The tag for which to decrement
+	 *
+	 * @param int $step
+	 *
+	 * @param int $strategy
+	 *
+	 * @return bool
+	 *   True if the item was successfully decremented. False if there was an error.
+	 * @throws InvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function decrementItemsByTag(string $tagName, int $step = 1, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
-    /**
-     * Decrement the items from the pool by one of multiple tag names.
-     *
-     * @param string[] $tagNames
-     *   The tag for which to decrement
-     *
-     * @param int $step
-     *
-     * @param int $strategy
-     *
-     * @return bool
-     *   True if the item was successfully decremented. False if there was an error.
-     * @throws InvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function decrementItemsByTags(array $tagNames, int $step = 1, int $strategy = self::TAG_STRATEGY_ONE): bool;
+	/**
+	 * Decrement the items from the pool by one of multiple tag names.
+	 *
+	 * @param string[] $tagNames
+	 *   The tag for which to decrement
+	 *
+	 * @param int $step
+	 *
+	 * @param int $strategy
+	 *
+	 * @return bool
+	 *   True if the item was successfully decremented. False if there was an error.
+	 * @throws InvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function decrementItemsByTags(array $tagNames, int $step = 1, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
-    /**
-     * Decrement the items from the pool by tag.
-     *
-     * @param string $tagName
-     *   The tag for which to append
-     *
-     * @param array<mixed>|string $data
-     *
-     * @param int $strategy
-     *
-     * @return bool
-     *   True if the item was successfully appended. False if there was an error.
-     * @throws InvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function appendItemsByTag(string $tagName, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
+	/**
+	 * Decrement the items from the pool by tag.
+	 *
+	 * @param string $tagName
+	 *   The tag for which to append
+	 *
+	 * @param array<mixed>|string $data
+	 *
+	 * @param int $strategy
+	 *
+	 * @return bool
+	 *   True if the item was successfully appended. False if there was an error.
+	 * @throws InvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function appendItemsByTag(string $tagName, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
-    /**
-     * Append the items from the pool by one of multiple tag names.
-     *
-     * @param string[] $tagNames
-     *   The tag for which to append
-     *
-     * @param array<mixed>|string $data
-     *
-     * @param int $strategy
-     *
-     * @return bool
-     *   True if the items were successfully appended. False if there was an error.
-     * @throws InvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function appendItemsByTags(array $tagNames, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
+	/**
+	 * Append the items from the pool by one of multiple tag names.
+	 *
+	 * @param string[] $tagNames
+	 *   The tag for which to append
+	 *
+	 * @param array<mixed>|string $data
+	 *
+	 * @param int $strategy
+	 *
+	 * @return bool
+	 *   True if the items were successfully appended. False if there was an error.
+	 * @throws InvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function appendItemsByTags(array $tagNames, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
-    /**
-     * Prepend the items from the pool by tag.
-     *
-     * @param string $tagName
-     *   The tag for which to prepend
-     *
-     * @param array<mixed>|string $data
-     *
-     * @param int $strategy
-     *
-     * @return bool
-     *   True if the item was successfully prepended. False if there was an error.
-     * @throws InvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function prependItemsByTag(string $tagName, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
+	/**
+	 * Prepend the items from the pool by tag.
+	 *
+	 * @param string $tagName
+	 *   The tag for which to prepend
+	 *
+	 * @param array<mixed>|string $data
+	 *
+	 * @param int $strategy
+	 *
+	 * @return bool
+	 *   True if the item was successfully prepended. False if there was an error.
+	 * @throws InvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function prependItemsByTag(string $tagName, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
-    /**
-     * Prepend the items from the pool by one of multiple tag names.
-     *
-     * @param string[] $tagNames
-     *   The tag for which to prepend
-     *
-     * @param array<mixed>|string $data
-     *
-     * @param int $strategy
-     *
-     * @return bool
-     *   True if the item was successfully prepended. False if there was an error.
-     * @throws InvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function prependItemsByTags(array $tagNames, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
+	/**
+	 * Prepend the items from the pool by one of multiple tag names.
+	 *
+	 * @param string[] $tagNames
+	 *   The tag for which to prepend
+	 *
+	 * @param array<mixed>|string $data
+	 *
+	 * @param int $strategy
+	 *
+	 * @return bool
+	 *   True if the item was successfully prepended. False if there was an error.
+	 * @throws InvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function prependItemsByTags(array $tagNames, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
 }

Spacing +4 added lines, -4 removed lines

@@ -227,7 +227,7 @@ 
      *   MUST be thrown.
      *
      */
-    public function appendItemsByTag(string $tagName, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
+    public function appendItemsByTag(string $tagName, array | string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
     /**
      * Append the items from the pool by one of multiple tag names.
@@ -246,7 +246,7 @@ 
      *   MUST be thrown.
      *
      */
-    public function appendItemsByTags(array $tagNames, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
+    public function appendItemsByTags(array $tagNames, array | string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
     /**
      * Prepend the items from the pool by tag.
@@ -265,7 +265,7 @@ 
      *   MUST be thrown.
      *
      */
-    public function prependItemsByTag(string $tagName, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
+    public function prependItemsByTag(string $tagName, array | string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
 
     /**
      * Prepend the items from the pool by one of multiple tag names.
@@ -284,5 +284,5 @@ 
      *   MUST be thrown.
      *
      */
-    public function prependItemsByTags(array $tagNames, array|string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
+    public function prependItemsByTags(array $tagNames, array | string $data, int $strategy = self::TAG_STRATEGY_ONE): bool;
 }

plugins/files/php/vendor/phpfastcache/phpfastcache/lib/Phpfastcache/Core/Pool/DriverPoolAbstractTrait.php

Indentation +97 added lines, -97 removed lines

@@ -24,101 +24,101 @@
 
 trait DriverPoolAbstractTrait
 {
-    /**
-     * @return bool
-     */
-    abstract protected function driverCheck(): bool;
-
-    /**
-     * @return bool
-     */
-    abstract protected function driverConnect(): bool;
-
-    /**
-     * @param ExtendedCacheItemInterface $item
-     * @return ?array<string, mixed>
-     */
-    abstract protected function driverRead(ExtendedCacheItemInterface $item): ?array;
-
-    /**
-     * @param ExtendedCacheItemInterface ...$items
-     * @return array<array<string, mixed>>
-     * @throws PhpfastcacheUnsupportedMethodException
-     */
-    protected function driverReadMultiple(ExtendedCacheItemInterface ...$items): array
-    {
-        throw new PhpfastcacheUnsupportedMethodException();
-    }
-
-    /**
-     * @return \Traversable<int, string>
-     * @throws PhpfastcacheUnsupportedMethodException
-     */
-    protected function driverReadAllKeys(string $pattern = ''): iterable
-    {
-        throw new PhpfastcacheUnsupportedMethodException(
-            sprintf(
-                'The "readAll" operation is unsupported by the the "%s" driver. See the Wiki for more information at %s',
-                $this->getDriverName(),
-                Wiki::FETCH_ALL_KEY_URL,
-            )
-        );
-    }
-
-    /**
-     * @param ExtendedCacheItemInterface $item
-     * @return bool
-     */
-    abstract protected function driverWrite(ExtendedCacheItemInterface $item): bool;
-
-    /**
-     * @param ExtendedCacheItemInterface ...$item
-     * @return bool
-     * @throws PhpfastcacheUnsupportedMethodException
-     */
-    protected function driverWriteMultiple(ExtendedCacheItemInterface ...$item): bool
-    {
-        /**
-         * @todo Implement bulk writes to be for v10:
-         * For methods commit() and saveMultiple()
-         */
-        throw new PhpfastcacheUnsupportedMethodException();
-    }
-
-
-    /**
-     * @param string $key
-     * @param string $encodedKey
-     * @return bool
-     */
-    abstract protected function driverDelete(string $key, string $encodedKey): bool;
-
-    /**
-     * @param string[] $keys
-     * @return bool
-     * @throws PhpfastcacheUnsupportedMethodException
-     */
-    protected function driverDeleteMultiple(array $keys): bool
-    {
-        throw new PhpfastcacheUnsupportedMethodException();
-    }
-
-    /**
-     * @return bool
-     */
-    abstract protected function driverClear(): bool;
-
-    /**
-     * @param CacheItemInterface $item
-     * @param string $expectedClassType
-     * @throws PhpfastcacheInvalidArgumentException
-     */
-    protected function assertCacheItemType(CacheItemInterface $item, string $expectedClassType): void
-    {
-        if (!($item instanceof $expectedClassType)) {
-            throw new PhpfastcacheInvalidArgumentException(
-                \sprintf('Cross-driver type confusion detected: Expected "%s" object, got "%s"', $expectedClassType, $item::class)
-            );
-        }
-    }
+	/**
+	 * @return bool
+	 */
+	abstract protected function driverCheck(): bool;
+
+	/**
+	 * @return bool
+	 */
+	abstract protected function driverConnect(): bool;
+
+	/**
+	 * @param ExtendedCacheItemInterface $item
+	 * @return ?array<string, mixed>
+	 */
+	abstract protected function driverRead(ExtendedCacheItemInterface $item): ?array;
+
+	/**
+	 * @param ExtendedCacheItemInterface ...$items
+	 * @return array<array<string, mixed>>
+	 * @throws PhpfastcacheUnsupportedMethodException
+	 */
+	protected function driverReadMultiple(ExtendedCacheItemInterface ...$items): array
+	{
+		throw new PhpfastcacheUnsupportedMethodException();
+	}
+
+	/**
+	 * @return \Traversable<int, string>
+	 * @throws PhpfastcacheUnsupportedMethodException
+	 */
+	protected function driverReadAllKeys(string $pattern = ''): iterable
+	{
+		throw new PhpfastcacheUnsupportedMethodException(
+			sprintf(
+				'The "readAll" operation is unsupported by the the "%s" driver. See the Wiki for more information at %s',
+				$this->getDriverName(),
+				Wiki::FETCH_ALL_KEY_URL,
+			)
+		);
+	}
+
+	/**
+	 * @param ExtendedCacheItemInterface $item
+	 * @return bool
+	 */
+	abstract protected function driverWrite(ExtendedCacheItemInterface $item): bool;
+
+	/**
+	 * @param ExtendedCacheItemInterface ...$item
+	 * @return bool
+	 * @throws PhpfastcacheUnsupportedMethodException
+	 */
+	protected function driverWriteMultiple(ExtendedCacheItemInterface ...$item): bool
+	{
+		/**
+		 * @todo Implement bulk writes to be for v10:
+		 * For methods commit() and saveMultiple()
+		 */
+		throw new PhpfastcacheUnsupportedMethodException();
+	}
+
+
+	/**
+	 * @param string $key
+	 * @param string $encodedKey
+	 * @return bool
+	 */
+	abstract protected function driverDelete(string $key, string $encodedKey): bool;
+
+	/**
+	 * @param string[] $keys
+	 * @return bool
+	 * @throws PhpfastcacheUnsupportedMethodException
+	 */
+	protected function driverDeleteMultiple(array $keys): bool
+	{
+		throw new PhpfastcacheUnsupportedMethodException();
+	}
+
+	/**
+	 * @return bool
+	 */
+	abstract protected function driverClear(): bool;
+
+	/**
+	 * @param CacheItemInterface $item
+	 * @param string $expectedClassType
+	 * @throws PhpfastcacheInvalidArgumentException
+	 */
+	protected function assertCacheItemType(CacheItemInterface $item, string $expectedClassType): void
+	{
+		if (!($item instanceof $expectedClassType)) {
+			throw new PhpfastcacheInvalidArgumentException(
+				\sprintf('Cross-driver type confusion detected: Expected "%s" object, got "%s"', $expectedClassType, $item::class)
+			);
+		}
+	}
 }

plugins/files/php/vendor/phpfastcache/phpfastcache/lib/Phpfastcache/Core/Pool/IO/IOHelperTrait.php

Indentation +276 added lines, -276 removed lines

@@ -30,285 +30,285 @@
  */
 trait IOHelperTrait
 {
-    use TaggableCacheItemPoolTrait;
-
-    /**
-     * @var array<string, string>
-     */
-    public array $tmp = [];
-
-    /**
-     * Provide a generic getStats() method
-     * for files-based drivers
-     * @return DriverStatistic
-     * @throws PhpfastcacheIOException
-     * @throws PhpfastcacheInvalidArgumentException
-     */
-    public function getStats(): DriverStatistic
-    {
-        $stat = new DriverStatistic();
-        $path = $this->getFilePath(false);
-
-        if (!is_dir($path)) {
-            throw new PhpfastcacheIOException("Can't read PATH:" . $path);
-        }
-        $stat->setSize(Directory::dirSize($path))
-            ->setInfo('Number of files used to build the cache: ' . Directory::getFileCount($path))
-            ->setRawData(
-                [
-                    'tmp' => $this->tmp,
-                ]
-            );
-
-        if ($this->getConfig()->isUseStaticItemCaching()) {
-            $stat->setData(implode(', ', \array_keys($this->itemInstances)));
-        } else {
-            $stat->setData('No data available since static item caching option (useStaticItemCaching) is disabled.');
-        }
-
-        return $stat;
-    }
-
-    /**
-     * @param string|bool $keyword
-     * @param bool $skip
-     * @return string
-     * @throws PhpfastcacheIOException
-     * @throws PhpfastcacheInvalidArgumentException
-     */
-    protected function getFilePath(string|bool $keyword, bool $skip = false): string
-    {
-        $path = $this->getPath();
-
-        if ($keyword === false) {
-            return $path;
-        }
-
-        $filename = $this->encodeFilename($keyword);
-        $folder = \substr($filename, 0, 2) . DIRECTORY_SEPARATOR . \substr($filename, 2, 2);
-        $path = \rtrim($path, '/\\') . DIRECTORY_SEPARATOR . $folder;
-
-        /**
-         * Skip Create Sub Folders;
-         */
-        if (!$skip && !\is_dir($path) && @!\mkdir($path, $this->getDefaultChmod(), true) && !\is_dir($path)) {
-            throw new PhpfastcacheIOException(
-                'Path "' . $path . '" is not writable, please set a chmod 0777 or any writable permission and make sure to make use of an absolute path !'
-            );
-        }
-
-        return $path . \DIRECTORY_SEPARATOR . $filename . '.' . $this->getConfig()->getCacheFileExtension();
-    }
-
-    /**
-     * @param bool $readonly
-     * @return string
-     * @throws PhpfastcacheIOException
-     * @throws PhpfastcacheInvalidArgumentException
-     */
-    public function getPath(bool $readonly = false): string
-    {
-        $tmpDir = \rtrim(\ini_get('upload_tmp_dir') ?: \sys_get_temp_dir(), '\\/') . DIRECTORY_SEPARATOR . 'phpfastcache';
-        $httpHost = $this->getConfig()->getSuperGlobalAccessor()('SERVER', 'HTTP_HOST');
-        $securityKey = $this->buildSecurityKey($httpHost);
-
-        /**
-         * Extends the temporary directory
-         * with the security key and the driver name
-         */
-        $tmpDir = \rtrim($tmpDir, '/') . DIRECTORY_SEPARATOR;
-
-        if (empty($this->getConfig()->getPath())) {
-            $path = $tmpDir;
-        } else {
-            $path = \rtrim($this->getConfig()->getPath(), '/') . DIRECTORY_SEPARATOR;
-        }
-
-        $pathSuffix = $securityKey . DIRECTORY_SEPARATOR . $this->getDriverName();
-        $fullPath = Directory::getAbsolutePath($path . $pathSuffix);
-        $fullPathTmp = Directory::getAbsolutePath($tmpDir . $pathSuffix);
-
-        $this->mkdir($fullPath, $fullPathTmp);
-
-        /**
-         * In readonly mode we only attempt
-         * to verify if the directory exists
-         * or not, if it does not then we
-         * return the temp dir
-         */
-        if ($readonly) {
-            if ($this->getConfig()->isAutoTmpFallback() && (!@\file_exists($fullPath) || !@\is_writable($fullPath))) {
-                return $fullPathTmp;
-            }
-            return $fullPath;
-        }
-
-        return realpath($fullPath);
-    }
-
-    protected function buildSecurityKey(?string $httpHost): string
-    {
-        $securityKey = $this->getConfig()->getSecurityKey();
-        if (!$securityKey || \mb_strtolower($securityKey) === 'auto') {
-            if (isset($httpHost)) {
-                $securityKey = \preg_replace('/^www./', '', \strtolower(\str_replace(':', '_', $httpHost)));
-            } else {
-                $securityKey = (SapiDetector::isWebScript() ? 'web' : 'cli');
-            }
-        }
-
-        if (!empty($securityKey)) {
-            $securityKey .= '/';
-        }
-
-        return static::cleanFileName($securityKey);
-    }
-
-    /**
-     * @throws PhpfastcacheIOException
-     */
-    protected function mkdir(string $fullPath, string $fullPathTmp): void
-    {
-        $fullPathHash = $this->getConfig()->getDefaultFileNameHashFunction()($fullPath);
-
-        if (!isset($this->tmp[$fullPathHash]) || (!@\file_exists($fullPath) || !@\is_writable($fullPath))) {
-            if (!@\file_exists($fullPath)) {
-                if (@mkdir($fullPath, $this->getDefaultChmod(), true) === false && !\is_dir($fullPath)) {
-                    throw new PhpfastcacheIOException('The directory ' . $fullPath . ' could not be created.');
-                }
-            } elseif (!@\is_writable($fullPath) && !@\chmod($fullPath, $this->getDefaultChmod()) && $this->getConfig()->isAutoTmpFallback()) {
-                /**
-                 * Switch back to tmp dir
-                 * again if the path is not writable
-                 */
-                $fullPath = $fullPathTmp;
-                if (!@\file_exists($fullPath) && @\mkdir($fullPath, $this->getDefaultChmod(), true) && !\is_dir($fullPath)) {
-                    throw new PhpfastcacheIOException('The directory ' . $fullPath . ' could not be created.');
-                }
-            }
-
-            /**
-             * In case there is no directory
-             * writable including the temporary
-             * one, we must throw an exception
-             */
-            if (!@\file_exists($fullPath) || !@\is_writable($fullPath)) {
-                throw new PhpfastcacheIOException(
-                    'Path "' . $fullPath . '" is not writable, please set a chmod 0777 or any writable permission and make sure to make use of an absolute path !'
-                );
-            }
-
-            $this->tmp[$fullPathHash] = $fullPath;
-        }
-    }
-
-    /**
-     * @param string $filename
-     * @return string
-     */
-    protected static function cleanFileName(string $filename): string
-    {
-        $regex = [
-            '/[\?\[\]\/\\\=\<\>\:\;\,\'\"\&\$\#\*\(\)\|\~\`\!\{\}]/',
-            '/\.$/',
-            '/^\./',
-        ];
-        $replace = ['-', '', ''];
-
-        return \trim(\preg_replace($regex, $replace, \trim($filename)), '-');
-    }
-
-    /**
-     * @return int
-     */
-    protected function getDefaultChmod(): int
-    {
-        if (!$this->getConfig()->getDefaultChmod()) {
-            return 0777;
-        }
-
-        return $this->getConfig()->getDefaultChmod();
-    }
-
-    /**
-     * @param string $keyword
-     * @return string
-     */
-    protected function encodeFilename(string $keyword): string
-    {
-        return $this->getConfig()->getDefaultFileNameHashFunction()($keyword);
-    }
-
-    /**
-     * @param string $file
-     * @return string
-     * @throws PhpfastcacheIOException
-     */
-    protected function readFile(string $file): string
-    {
-        if (!\is_readable($file)) {
-            throw new PhpfastcacheIOException("Cannot read file located at: $file");
-        }
-        if (\function_exists('file_get_contents')) {
-            return (string)\file_get_contents($file);
-        }
-
-        $string = '';
-
-        $fileHandle = @\fopen($file, 'rb');
-        while (!\feof($fileHandle)) {
-            $line = \fgets($fileHandle);
-            $string .= $line;
-        }
-        \fclose($fileHandle);
-
-        return $string;
-    }
-
-    /********************
+	use TaggableCacheItemPoolTrait;
+
+	/**
+	 * @var array<string, string>
+	 */
+	public array $tmp = [];
+
+	/**
+	 * Provide a generic getStats() method
+	 * for files-based drivers
+	 * @return DriverStatistic
+	 * @throws PhpfastcacheIOException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 */
+	public function getStats(): DriverStatistic
+	{
+		$stat = new DriverStatistic();
+		$path = $this->getFilePath(false);
+
+		if (!is_dir($path)) {
+			throw new PhpfastcacheIOException("Can't read PATH:" . $path);
+		}
+		$stat->setSize(Directory::dirSize($path))
+			->setInfo('Number of files used to build the cache: ' . Directory::getFileCount($path))
+			->setRawData(
+				[
+					'tmp' => $this->tmp,
+				]
+			);
+
+		if ($this->getConfig()->isUseStaticItemCaching()) {
+			$stat->setData(implode(', ', \array_keys($this->itemInstances)));
+		} else {
+			$stat->setData('No data available since static item caching option (useStaticItemCaching) is disabled.');
+		}
+
+		return $stat;
+	}
+
+	/**
+	 * @param string|bool $keyword
+	 * @param bool $skip
+	 * @return string
+	 * @throws PhpfastcacheIOException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 */
+	protected function getFilePath(string|bool $keyword, bool $skip = false): string
+	{
+		$path = $this->getPath();
+
+		if ($keyword === false) {
+			return $path;
+		}
+
+		$filename = $this->encodeFilename($keyword);
+		$folder = \substr($filename, 0, 2) . DIRECTORY_SEPARATOR . \substr($filename, 2, 2);
+		$path = \rtrim($path, '/\\') . DIRECTORY_SEPARATOR . $folder;
+
+		/**
+		 * Skip Create Sub Folders;
+		 */
+		if (!$skip && !\is_dir($path) && @!\mkdir($path, $this->getDefaultChmod(), true) && !\is_dir($path)) {
+			throw new PhpfastcacheIOException(
+				'Path "' . $path . '" is not writable, please set a chmod 0777 or any writable permission and make sure to make use of an absolute path !'
+			);
+		}
+
+		return $path . \DIRECTORY_SEPARATOR . $filename . '.' . $this->getConfig()->getCacheFileExtension();
+	}
+
+	/**
+	 * @param bool $readonly
+	 * @return string
+	 * @throws PhpfastcacheIOException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 */
+	public function getPath(bool $readonly = false): string
+	{
+		$tmpDir = \rtrim(\ini_get('upload_tmp_dir') ?: \sys_get_temp_dir(), '\\/') . DIRECTORY_SEPARATOR . 'phpfastcache';
+		$httpHost = $this->getConfig()->getSuperGlobalAccessor()('SERVER', 'HTTP_HOST');
+		$securityKey = $this->buildSecurityKey($httpHost);
+
+		/**
+		 * Extends the temporary directory
+		 * with the security key and the driver name
+		 */
+		$tmpDir = \rtrim($tmpDir, '/') . DIRECTORY_SEPARATOR;
+
+		if (empty($this->getConfig()->getPath())) {
+			$path = $tmpDir;
+		} else {
+			$path = \rtrim($this->getConfig()->getPath(), '/') . DIRECTORY_SEPARATOR;
+		}
+
+		$pathSuffix = $securityKey . DIRECTORY_SEPARATOR . $this->getDriverName();
+		$fullPath = Directory::getAbsolutePath($path . $pathSuffix);
+		$fullPathTmp = Directory::getAbsolutePath($tmpDir . $pathSuffix);
+
+		$this->mkdir($fullPath, $fullPathTmp);
+
+		/**
+		 * In readonly mode we only attempt
+		 * to verify if the directory exists
+		 * or not, if it does not then we
+		 * return the temp dir
+		 */
+		if ($readonly) {
+			if ($this->getConfig()->isAutoTmpFallback() && (!@\file_exists($fullPath) || !@\is_writable($fullPath))) {
+				return $fullPathTmp;
+			}
+			return $fullPath;
+		}
+
+		return realpath($fullPath);
+	}
+
+	protected function buildSecurityKey(?string $httpHost): string
+	{
+		$securityKey = $this->getConfig()->getSecurityKey();
+		if (!$securityKey || \mb_strtolower($securityKey) === 'auto') {
+			if (isset($httpHost)) {
+				$securityKey = \preg_replace('/^www./', '', \strtolower(\str_replace(':', '_', $httpHost)));
+			} else {
+				$securityKey = (SapiDetector::isWebScript() ? 'web' : 'cli');
+			}
+		}
+
+		if (!empty($securityKey)) {
+			$securityKey .= '/';
+		}
+
+		return static::cleanFileName($securityKey);
+	}
+
+	/**
+	 * @throws PhpfastcacheIOException
+	 */
+	protected function mkdir(string $fullPath, string $fullPathTmp): void
+	{
+		$fullPathHash = $this->getConfig()->getDefaultFileNameHashFunction()($fullPath);
+
+		if (!isset($this->tmp[$fullPathHash]) || (!@\file_exists($fullPath) || !@\is_writable($fullPath))) {
+			if (!@\file_exists($fullPath)) {
+				if (@mkdir($fullPath, $this->getDefaultChmod(), true) === false && !\is_dir($fullPath)) {
+					throw new PhpfastcacheIOException('The directory ' . $fullPath . ' could not be created.');
+				}
+			} elseif (!@\is_writable($fullPath) && !@\chmod($fullPath, $this->getDefaultChmod()) && $this->getConfig()->isAutoTmpFallback()) {
+				/**
+				 * Switch back to tmp dir
+				 * again if the path is not writable
+				 */
+				$fullPath = $fullPathTmp;
+				if (!@\file_exists($fullPath) && @\mkdir($fullPath, $this->getDefaultChmod(), true) && !\is_dir($fullPath)) {
+					throw new PhpfastcacheIOException('The directory ' . $fullPath . ' could not be created.');
+				}
+			}
+
+			/**
+			 * In case there is no directory
+			 * writable including the temporary
+			 * one, we must throw an exception
+			 */
+			if (!@\file_exists($fullPath) || !@\is_writable($fullPath)) {
+				throw new PhpfastcacheIOException(
+					'Path "' . $fullPath . '" is not writable, please set a chmod 0777 or any writable permission and make sure to make use of an absolute path !'
+				);
+			}
+
+			$this->tmp[$fullPathHash] = $fullPath;
+		}
+	}
+
+	/**
+	 * @param string $filename
+	 * @return string
+	 */
+	protected static function cleanFileName(string $filename): string
+	{
+		$regex = [
+			'/[\?\[\]\/\\\=\<\>\:\;\,\'\"\&\$\#\*\(\)\|\~\`\!\{\}]/',
+			'/\.$/',
+			'/^\./',
+		];
+		$replace = ['-', '', ''];
+
+		return \trim(\preg_replace($regex, $replace, \trim($filename)), '-');
+	}
+
+	/**
+	 * @return int
+	 */
+	protected function getDefaultChmod(): int
+	{
+		if (!$this->getConfig()->getDefaultChmod()) {
+			return 0777;
+		}
+
+		return $this->getConfig()->getDefaultChmod();
+	}
+
+	/**
+	 * @param string $keyword
+	 * @return string
+	 */
+	protected function encodeFilename(string $keyword): string
+	{
+		return $this->getConfig()->getDefaultFileNameHashFunction()($keyword);
+	}
+
+	/**
+	 * @param string $file
+	 * @return string
+	 * @throws PhpfastcacheIOException
+	 */
+	protected function readFile(string $file): string
+	{
+		if (!\is_readable($file)) {
+			throw new PhpfastcacheIOException("Cannot read file located at: $file");
+		}
+		if (\function_exists('file_get_contents')) {
+			return (string)\file_get_contents($file);
+		}
+
+		$string = '';
+
+		$fileHandle = @\fopen($file, 'rb');
+		while (!\feof($fileHandle)) {
+			$line = \fgets($fileHandle);
+			$string .= $line;
+		}
+		\fclose($fileHandle);
+
+		return $string;
+	}
+
+	/********************
      *
      * PSR-6 Extended Methods
      *
      *******************/
 
-    /**
-     * @param string $file
-     * @param string $data
-     * @param bool $secureFileManipulation
-     * @return bool
-     * @throws PhpfastcacheIOException
-     * @throws \Exception
-     */
-    protected function writeFile(string $file, string $data, bool $secureFileManipulation = false): bool
-    {
-        $this->eventManager->dispatch(Event::CACHE_WRITE_FILE_ON_DISK, $this, $file, $secureFileManipulation);
-
-        if ($secureFileManipulation) {
-            $tmpFilename = Directory::getAbsolutePath(
-                dirname($file) . \DIRECTORY_SEPARATOR . 'tmp_' . $this->getConfig()->getDefaultFileNameHashFunction()(
-                    \bin2hex(\random_bytes(16))
-                )
-            ) . '.' . $this->getConfig()->getCacheFileExtension() . \random_int(1000, 9999);
-
-            $handle = \fopen($tmpFilename, 'w+b');
-            if (\is_resource($handle)) {
-                \flock($handle, \LOCK_EX);
-                $octetWritten = fwrite($handle, $data);
-                \flock($handle, \LOCK_UN);
-                \fclose($handle);
-            }
-
-            if (!\rename($tmpFilename, $file)) {
-                throw new PhpfastcacheIOException(\sprintf('Failed to rename %s to %s', $tmpFilename, $file));
-            }
-        } else {
-            $handle = \fopen($file, 'w+b');
-            if (\is_resource($handle)) {
-                $octetWritten = \fwrite($handle, $data);
-                \fclose($handle);
-            }
-        }
-
-        return (bool)($octetWritten ?? false);
-    }
+	/**
+	 * @param string $file
+	 * @param string $data
+	 * @param bool $secureFileManipulation
+	 * @return bool
+	 * @throws PhpfastcacheIOException
+	 * @throws \Exception
+	 */
+	protected function writeFile(string $file, string $data, bool $secureFileManipulation = false): bool
+	{
+		$this->eventManager->dispatch(Event::CACHE_WRITE_FILE_ON_DISK, $this, $file, $secureFileManipulation);
+
+		if ($secureFileManipulation) {
+			$tmpFilename = Directory::getAbsolutePath(
+				dirname($file) . \DIRECTORY_SEPARATOR . 'tmp_' . $this->getConfig()->getDefaultFileNameHashFunction()(
+					\bin2hex(\random_bytes(16))
+				)
+			) . '.' . $this->getConfig()->getCacheFileExtension() . \random_int(1000, 9999);
+
+			$handle = \fopen($tmpFilename, 'w+b');
+			if (\is_resource($handle)) {
+				\flock($handle, \LOCK_EX);
+				$octetWritten = fwrite($handle, $data);
+				\flock($handle, \LOCK_UN);
+				\fclose($handle);
+			}
+
+			if (!\rename($tmpFilename, $file)) {
+				throw new PhpfastcacheIOException(\sprintf('Failed to rename %s to %s', $tmpFilename, $file));
+			}
+		} else {
+			$handle = \fopen($file, 'w+b');
+			if (\is_resource($handle)) {
+				$octetWritten = \fwrite($handle, $data);
+				\fclose($handle);
+			}
+		}
+
+		return (bool)($octetWritten ?? false);
+	}
 }

Spacing +3 added lines, -3 removed lines

@@ -76,7 +76,7 @@ 
      * @throws PhpfastcacheIOException
      * @throws PhpfastcacheInvalidArgumentException
      */
-    protected function getFilePath(string|bool $keyword, bool $skip = false): string
+    protected function getFilePath(string | bool $keyword, bool $skip = false): string
     {
         $path = $this->getPath();
 
@@ -250,7 +250,7 @@ 
             throw new PhpfastcacheIOException("Cannot read file located at: $file");
         }
         if (\function_exists('file_get_contents')) {
-            return (string)\file_get_contents($file);
+            return (string) \file_get_contents($file);
         }
 
         $string = '';
@@ -309,6 +309,6 @@ 
             }
         }
 
-        return (bool)($octetWritten ?? false);
+        return (bool) ($octetWritten ?? false);
     }
 }

Braces +10 added lines, -5 removed lines

@@ -62,7 +62,8 @@ 
 
         if ($this->getConfig()->isUseStaticItemCaching()) {
             $stat->setData(implode(', ', \array_keys($this->itemInstances)));
-        } else {
+        }
+        else {
             $stat->setData('No data available since static item caching option (useStaticItemCaching) is disabled.');
         }
 
@@ -120,7 +121,8 @@ 
 
         if (empty($this->getConfig()->getPath())) {
             $path = $tmpDir;
-        } else {
+        }
+        else {
             $path = \rtrim($this->getConfig()->getPath(), '/') . DIRECTORY_SEPARATOR;
         }
 
@@ -152,7 +154,8 @@ 
         if (!$securityKey || \mb_strtolower($securityKey) === 'auto') {
             if (isset($httpHost)) {
                 $securityKey = \preg_replace('/^www./', '', \strtolower(\str_replace(':', '_', $httpHost)));
-            } else {
+            }
+            else {
                 $securityKey = (SapiDetector::isWebScript() ? 'web' : 'cli');
             }
         }
@@ -176,7 +179,8 @@ 
                 if (@mkdir($fullPath, $this->getDefaultChmod(), true) === false && !\is_dir($fullPath)) {
                     throw new PhpfastcacheIOException('The directory ' . $fullPath . ' could not be created.');
                 }
-            } elseif (!@\is_writable($fullPath) && !@\chmod($fullPath, $this->getDefaultChmod()) && $this->getConfig()->isAutoTmpFallback()) {
+            }
+            elseif (!@\is_writable($fullPath) && !@\chmod($fullPath, $this->getDefaultChmod()) && $this->getConfig()->isAutoTmpFallback()) {
                 /**
                  * Switch back to tmp dir
                  * again if the path is not writable
@@ -301,7 +305,8 @@ 
             if (!\rename($tmpFilename, $file)) {
                 throw new PhpfastcacheIOException(\sprintf('Failed to rename %s to %s', $tmpFilename, $file));
             }
-        } else {
+        }
+        else {
             $handle = \fopen($file, 'w+b');
             if (\is_resource($handle)) {
                 $octetWritten = \fwrite($handle, $data);

plugins/files/php/vendor/phpfastcache/phpfastcache/lib/Phpfastcache/Core/Pool/ExtendedCacheItemPoolInterface.php

Indentation +190 added lines, -190 removed lines

@@ -36,196 +36,196 @@
  */
 interface ExtendedCacheItemPoolInterface extends CacheItemPoolInterface, EventManagerDispatcherInterface, ClassNamespaceResolverInterface, TaggableCacheItemPoolInterface
 {
-    public const DRIVER_CHECK_FAILURE = '%s is not installed or is misconfigured, cannot continue. 
+	public const DRIVER_CHECK_FAILURE = '%s is not installed or is misconfigured, cannot continue. 
     Also, please verify the suggested dependencies in composer because as of the V6, 3rd party libraries are no longer required.%s';
 
-    public const DRIVER_CONNECT_FAILURE = '%s failed to connect with the following error message: "%s" line %d in %s.';
-
-    public const DRIVER_KEY_WRAPPER_INDEX = 'k';
-
-    public const DRIVER_DATA_WRAPPER_INDEX = 'd';
-
-    /**
-     * Expiration date Index
-     */
-    public const DRIVER_EDATE_WRAPPER_INDEX = 'e';
-
-    /**
-     * Creation date Index
-     */
-    public const DRIVER_CDATE_WRAPPER_INDEX = 'c';
-
-    /**
-     * Modification date Index
-     */
-    public const DRIVER_MDATE_WRAPPER_INDEX = 'm';
-
-    /**
-     * Hard-limit count  of items returns by getAllItems()
-     */
-    public const MAX_ALL_KEYS_COUNT = 9999;
-
-    /**
-     * Return the config class name
-     * @return string
-     */
-    public static function getConfigClass(): string;
-
-    /**
-     * Return the item class name
-     * @return string
-     */
-    public static function getItemClass(): string;
-
-    /**
-     * @param string $key
-     * @return string
-     */
-    public function getEncodedKey(string $key): string;
-
-    /**
-     * @return ConfigurationOptionInterface
-     */
-    public function getConfig(): ConfigurationOptionInterface;
-
-    /**
-     * @return ConfigurationOptionInterface
-     */
-    public function getDefaultConfig(): ConfigurationOptionInterface;
-
-    /**
-     * @return string
-     */
-    public function getDriverName(): string;
-
-    /**
-     * @return mixed
-     */
-    public function getInstanceId(): string;
-
-    /**
-     * [Phpfastcache phpDoc Override]
-     * Returns a Cache Item representing the specified key.
-     *
-     * This method must always return a CacheItemInterface object, even in case of
-     * a cache miss. It MUST NOT return null.
-     *
-     * @param string $key
-     *   The key for which to return the corresponding Cache Item.
-     *
-     * @return ExtendedCacheItemInterface
-     *   The corresponding Cache Item.
-     * @throws PhpfastcacheInvalidArgumentException
-     *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function getItem(string $key): ExtendedCacheItemInterface;
-
-    /**
-     * [Phpfastcache phpDoc Override]
-     * Returns a traversable set of cache items.
-     *
-     * @param string[] $keys
-     * An indexed array of keys of items to retrieve.
-     *
-     * @return iterable<ExtendedCacheItemInterface>
-     *   A traversable collection of Cache Items keyed by the cache keys of
-     *   each item. A Cache item will be returned for each key, even if that
-     *   key is not found. However, if no keys are specified then an empty
-     *   traversable MUST be returned instead.
-     * @throws InvalidArgumentException
-     *   If any of the keys in $keys are not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function getItems(array $keys = []): iterable;
-
-    /**
-     * Returns the WHOLE cache as a traversable set of cache items.
-     * A hard-limit of 9999 items is defined internally to prevent
-     * serious performances issues of your application.
-     * @see ExtendedCacheItemPoolInterface::MAX_ALL_KEYS_COUNT
-     *
-     * @param string $pattern
-     * An optional pattern supported by a limited range of drivers.
-     * If this parameter is unsupported by the driver, a PhpfastcacheInvalidArgumentException will be thrown.
-     *
-     * @return iterable<ExtendedCacheItemInterface>
-     *   A traversable collection of Cache Items keyed by the cache keys of
-     *   each item. However, if no keys are returned by the backend then an empty
-     *   traversable WILL be returned instead.
-     *
-     * @throws PhpfastcacheInvalidArgumentException If the driver does not support the $pattern argument
-     * @throws PhpfastcacheUnsupportedMethodException If the driver does not permit to list all the keys through this implementation.
-     */
-    public function getAllItems(string $pattern = ''): iterable;
-
-    /**
-     * Returns A json string that represents an array of items.
-     *
-     * @param array<string> $keys An indexed array of keys of items to retrieve.
-     * @param int $options \json_encode() options
-     * @param int $depth \json_encode() depth
-     *
-     * @return string
-     * @throws InvalidArgumentException
-     *   If any of the keys in $keys are not a legal value a phpfastcacheInvalidArgumentException
-     *   MUST be thrown.
-     *
-     */
-    public function getItemsAsJsonString(array $keys = [], int $options = \JSON_THROW_ON_ERROR, int $depth = 512): string;
-
-    public function setItem(CacheItemInterface $item): static;
-
-    public function getStats(): DriverStatistic;
-
-    /**
-     * Get a quick help guide
-     * about the current driver
-     */
-    public function getHelp(): string;
-
-    public function detachItem(CacheItemInterface $item): static;
-
-    public function detachAllItems(): static;
-
-    public function attachItem(CacheItemInterface $item): static;
-
-    /**
-     * Returns true if the item exists, is attached and the Spl Hash matches
-     * Returns false if the item exists, is attached and the Spl Hash mismatches
-     * Returns null if the item does not exist
-     *
-     * @param CacheItemInterface $item
-     * @return bool
-     * @throws PhpfastcacheLogicException
-     */
-    public function isAttached(CacheItemInterface $item): bool;
-
-    /**
-     * Persists a cache item immediately.
-     *
-     * @param ExtendedCacheItemInterface|CacheItemInterface $item
-     *   The cache item to save.
-     *
-     * @return bool
-     *   True if the item was successfully persisted. False if there was an error.
-     */
-    public function save(ExtendedCacheItemInterface|CacheItemInterface $item): bool;
-
-    /**
-     * Save multiple items, possible uses:
-     *  saveMultiple([$item1, $item2, $item3]);
-     *  saveMultiple($item1, $item2, $item3);
-     *
-     * @param ExtendedCacheItemInterface[] $items
-     * @return bool
-     */
-    public function saveMultiple(ExtendedCacheItemInterface ...$items): bool;
-
-    /**
-     * @return DriverIO
-     */
-    public function getIO(): DriverIO;
+	public const DRIVER_CONNECT_FAILURE = '%s failed to connect with the following error message: "%s" line %d in %s.';
+
+	public const DRIVER_KEY_WRAPPER_INDEX = 'k';
+
+	public const DRIVER_DATA_WRAPPER_INDEX = 'd';
+
+	/**
+	 * Expiration date Index
+	 */
+	public const DRIVER_EDATE_WRAPPER_INDEX = 'e';
+
+	/**
+	 * Creation date Index
+	 */
+	public const DRIVER_CDATE_WRAPPER_INDEX = 'c';
+
+	/**
+	 * Modification date Index
+	 */
+	public const DRIVER_MDATE_WRAPPER_INDEX = 'm';
+
+	/**
+	 * Hard-limit count  of items returns by getAllItems()
+	 */
+	public const MAX_ALL_KEYS_COUNT = 9999;
+
+	/**
+	 * Return the config class name
+	 * @return string
+	 */
+	public static function getConfigClass(): string;
+
+	/**
+	 * Return the item class name
+	 * @return string
+	 */
+	public static function getItemClass(): string;
+
+	/**
+	 * @param string $key
+	 * @return string
+	 */
+	public function getEncodedKey(string $key): string;
+
+	/**
+	 * @return ConfigurationOptionInterface
+	 */
+	public function getConfig(): ConfigurationOptionInterface;
+
+	/**
+	 * @return ConfigurationOptionInterface
+	 */
+	public function getDefaultConfig(): ConfigurationOptionInterface;
+
+	/**
+	 * @return string
+	 */
+	public function getDriverName(): string;
+
+	/**
+	 * @return mixed
+	 */
+	public function getInstanceId(): string;
+
+	/**
+	 * [Phpfastcache phpDoc Override]
+	 * Returns a Cache Item representing the specified key.
+	 *
+	 * This method must always return a CacheItemInterface object, even in case of
+	 * a cache miss. It MUST NOT return null.
+	 *
+	 * @param string $key
+	 *   The key for which to return the corresponding Cache Item.
+	 *
+	 * @return ExtendedCacheItemInterface
+	 *   The corresponding Cache Item.
+	 * @throws PhpfastcacheInvalidArgumentException
+	 *   If the $key string is not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function getItem(string $key): ExtendedCacheItemInterface;
+
+	/**
+	 * [Phpfastcache phpDoc Override]
+	 * Returns a traversable set of cache items.
+	 *
+	 * @param string[] $keys
+	 * An indexed array of keys of items to retrieve.
+	 *
+	 * @return iterable<ExtendedCacheItemInterface>
+	 *   A traversable collection of Cache Items keyed by the cache keys of
+	 *   each item. A Cache item will be returned for each key, even if that
+	 *   key is not found. However, if no keys are specified then an empty
+	 *   traversable MUST be returned instead.
+	 * @throws InvalidArgumentException
+	 *   If any of the keys in $keys are not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function getItems(array $keys = []): iterable;
+
+	/**
+	 * Returns the WHOLE cache as a traversable set of cache items.
+	 * A hard-limit of 9999 items is defined internally to prevent
+	 * serious performances issues of your application.
+	 * @see ExtendedCacheItemPoolInterface::MAX_ALL_KEYS_COUNT
+	 *
+	 * @param string $pattern
+	 * An optional pattern supported by a limited range of drivers.
+	 * If this parameter is unsupported by the driver, a PhpfastcacheInvalidArgumentException will be thrown.
+	 *
+	 * @return iterable<ExtendedCacheItemInterface>
+	 *   A traversable collection of Cache Items keyed by the cache keys of
+	 *   each item. However, if no keys are returned by the backend then an empty
+	 *   traversable WILL be returned instead.
+	 *
+	 * @throws PhpfastcacheInvalidArgumentException If the driver does not support the $pattern argument
+	 * @throws PhpfastcacheUnsupportedMethodException If the driver does not permit to list all the keys through this implementation.
+	 */
+	public function getAllItems(string $pattern = ''): iterable;
+
+	/**
+	 * Returns A json string that represents an array of items.
+	 *
+	 * @param array<string> $keys An indexed array of keys of items to retrieve.
+	 * @param int $options \json_encode() options
+	 * @param int $depth \json_encode() depth
+	 *
+	 * @return string
+	 * @throws InvalidArgumentException
+	 *   If any of the keys in $keys are not a legal value a phpfastcacheInvalidArgumentException
+	 *   MUST be thrown.
+	 *
+	 */
+	public function getItemsAsJsonString(array $keys = [], int $options = \JSON_THROW_ON_ERROR, int $depth = 512): string;
+
+	public function setItem(CacheItemInterface $item): static;
+
+	public function getStats(): DriverStatistic;
+
+	/**
+	 * Get a quick help guide
+	 * about the current driver
+	 */
+	public function getHelp(): string;
+
+	public function detachItem(CacheItemInterface $item): static;
+
+	public function detachAllItems(): static;
+
+	public function attachItem(CacheItemInterface $item): static;
+
+	/**
+	 * Returns true if the item exists, is attached and the Spl Hash matches
+	 * Returns false if the item exists, is attached and the Spl Hash mismatches
+	 * Returns null if the item does not exist
+	 *
+	 * @param CacheItemInterface $item
+	 * @return bool
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function isAttached(CacheItemInterface $item): bool;
+
+	/**
+	 * Persists a cache item immediately.
+	 *
+	 * @param ExtendedCacheItemInterface|CacheItemInterface $item
+	 *   The cache item to save.
+	 *
+	 * @return bool
+	 *   True if the item was successfully persisted. False if there was an error.
+	 */
+	public function save(ExtendedCacheItemInterface|CacheItemInterface $item): bool;
+
+	/**
+	 * Save multiple items, possible uses:
+	 *  saveMultiple([$item1, $item2, $item3]);
+	 *  saveMultiple($item1, $item2, $item3);
+	 *
+	 * @param ExtendedCacheItemInterface[] $items
+	 * @return bool
+	 */
+	public function saveMultiple(ExtendedCacheItemInterface ...$items): bool;
+
+	/**
+	 * @return DriverIO
+	 */
+	public function getIO(): DriverIO;
 }

Spacing +1 added lines, -1 removed lines

@@ -212,7 +212,7 @@
      * @return bool
      *   True if the item was successfully persisted. False if there was an error.
      */
-    public function save(ExtendedCacheItemInterface|CacheItemInterface $item): bool;
+    public function save(ExtendedCacheItemInterface | CacheItemInterface $item): bool;
 
     /**
      * Save multiple items, possible uses:

plugins/files/php/vendor/phpfastcache/phpfastcache/lib/Phpfastcache/Core/Pool/TaggableCacheItemPoolTrait.php

Indentation +438 added lines, -438 removed lines

@@ -30,442 +30,442 @@
  */
 trait TaggableCacheItemPoolTrait
 {
-    use ExtendedCacheItemPoolTrait;
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function getItemsByTagsAsJsonString(
-        array $tagNames,
-        int $option = \JSON_THROW_ON_ERROR,
-        int $depth = 512,
-        int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE
-    ): string {
-        return \json_encode(
-            \array_map(
-                static fn(CacheItemInterface $item) => $item->get(),
-                \array_values($this->getItemsByTags($tagNames, $strategy))
-            ),
-            $option,
-            $depth,
-        );
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function getItemsByTags(array $tagNames, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): array
-    {
-        $items = [];
-        foreach (\array_unique($tagNames) as $tagName) {
-            $items[] = $this->fetchItemsByTagFromBackend($tagName);
-        }
-
-        $items = \array_merge([], ...$items);
-
-        switch ($strategy) {
-            case TaggableCacheItemPoolInterface::TAG_STRATEGY_ALL:
-                foreach ($items as $key => $item) {
-                    if (\array_diff($tagNames, $item->getTags())) {
-                        unset($items[$key]);
-                    }
-                }
-                break;
-
-            case TaggableCacheItemPoolInterface::TAG_STRATEGY_ONLY:
-                foreach ($items as $key => $item) {
-                    if (\array_diff($tagNames, $item->getTags()) || \array_diff($item->getTags(), $tagNames)) {
-                        unset($items[$key]);
-                    }
-                }
-                break;
-        }
-        return $items;
-    }
-
-    /**
-     * @param string $tagName
-     * @return ExtendedCacheItemInterface[]
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    protected function fetchItemsByTagFromBackend(string $tagName): array
-    {
-        $driverResponse = $this->getItem($this->getTagKey($tagName));
-
-        if ($driverResponse->isHit()) {
-            $tagsItems = (array)$driverResponse->get();
-            /**
-             * getItems() may provide expired item(s)
-             * themselves provided by a cache of item
-             * keys based stored the tag item.
-             * Therefore, we pass a filter callback
-             * to remove the expired Item(s) provided by
-             * the item keys passed through getItems()
-             *
-             * #headache
-             */
-            return \array_filter(
-                $this->getItems(\array_unique(\array_keys($tagsItems))),
-                static fn (ExtendedCacheItemInterface $item) => $item->isHit(),
-            );
-        }
-        return [];
-    }
-
-    /**
-     * @param string $key
-     * @return string
-     */
-    protected function getTagKey(string $key): string
-    {
-        return TaggableCacheItemPoolInterface::DRIVER_TAGS_KEY_PREFIX . $key;
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws PhpfastcacheDriverException
-     */
-    public function deleteItemsByTags(array $tagNames, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
-    {
-        $return = true;
-
-        foreach ($this->getItemsByTags($tagNames, $strategy) as $item) {
-            $result = $this->deleteItem($item->getKey());
-            if ($result !== true) {
-                $return = $result;
-            }
-        }
-
-        return $return;
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws PhpfastcacheDriverException
-     */
-    public function deleteItemsByTag(string $tagName, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
-    {
-        $return = true;
-        foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
-            $result = $this->deleteItem($item->getKey());
-            if ($result !== true) {
-                $return = $result;
-            }
-        }
-
-        return $return;
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    public function getItemsByTag(string $tagName, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): array
-    {
-        $items = $this->fetchItemsByTagFromBackend($tagName);
-
-        if ($strategy === TaggableCacheItemPoolInterface::TAG_STRATEGY_ONLY) {
-            foreach ($items as $key => $item) {
-                if (\array_diff($item->getTags(), [$tagName])) {
-                    unset($items[$key]);
-                }
-            }
-        }
-        return $items;
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws \ReflectionException
-     */
-    public function incrementItemsByTags(array $tagNames, int $step = 1, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
-    {
-        $return = true;
-        foreach ($tagNames as $tagName) {
-            $result = $this->incrementItemsByTag($tagName, $step, $strategy);
-            if ($result !== true) {
-                $return = $result;
-            }
-        }
-
-        return $return;
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws \ReflectionException
-     */
-    public function incrementItemsByTag(string $tagName, int $step = 1, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
-    {
-        foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
-            $item->increment($step);
-            $this->saveDeferred($item);
-        }
-
-        return $this->commit();
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws \ReflectionException
-     */
-    public function decrementItemsByTags(array $tagNames, int $step = 1, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
-    {
-        $return = true;
-        foreach ($tagNames as $tagName) {
-            $result = $this->decrementItemsByTag($tagName, $step, $strategy);
-            if ($result !== true) {
-                $return = $result;
-            }
-        }
-
-        return $return;
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws \ReflectionException
-     */
-    public function decrementItemsByTag(string $tagName, int $step = 1, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
-    {
-        foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
-            $item->decrement($step);
-            $this->saveDeferred($item);
-        }
-
-        return $this->commit();
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws \ReflectionException
-     */
-    public function appendItemsByTags(array $tagNames, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
-    {
-        $return = true;
-        foreach ($tagNames as $tagName) {
-            $result = $this->appendItemsByTag($tagName, $data, $strategy);
-            if ($result !== true) {
-                $return = $result;
-            }
-        }
-
-        return $return;
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws \ReflectionException
-     */
-    public function appendItemsByTag(string $tagName, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
-    {
-        foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
-            $item->append($data);
-            $this->saveDeferred($item);
-        }
-
-        return $this->commit();
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws \ReflectionException
-     */
-    public function prependItemsByTags(array $tagNames, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
-    {
-        $return = true;
-        foreach ($tagNames as $tagName) {
-            $result = $this->prependItemsByTag($tagName, $data, $strategy);
-            if ($result !== true) {
-                $return = $result;
-            }
-        }
-
-        return $return;
-    }
-
-    /**
-     * @inheritDoc
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws \ReflectionException
-     */
-    public function prependItemsByTag(string $tagName, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
-    {
-        foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
-            $item->prepend($data);
-            $this->saveDeferred($item);
-        }
-
-        return $this->commit();
-    }
-
-    /**
-     * @param array<mixed> $wrapper
-     * @return string[]
-     */
-    protected function driverUnwrapTags(array $wrapper): array
-    {
-        return $wrapper[TaggableCacheItemPoolInterface::DRIVER_TAGS_WRAPPER_INDEX];
-    }
-
-    /**
-     * @param ExtendedCacheItemInterface $item
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     */
-    protected function cleanItemTags(ExtendedCacheItemInterface $item): void
-    {
-        if (!empty($item->getTags()) || !empty($item->getRemovedTags())) {
-            $this->driverWriteTags($item->removeTags($item->getTags()));
-        }
-    }
-
-    /**
-     * @param ExtendedCacheItemInterface $item
-     * @return bool
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheInvalidArgumentException
-     * @throws PhpfastcacheLogicException
-     * @throws PhpfastcacheDriverException
-     */
-    protected function driverWriteTags(ExtendedCacheItemInterface $item): bool
-    {
-        /**
-         * Do not attempt to write tags
-         * on tags item, it can lead
-         * to an infinite recursive calls
-         */
-        if (str_starts_with($item->getKey(), TaggableCacheItemPoolInterface::DRIVER_TAGS_KEY_PREFIX)) {
-            throw new PhpfastcacheLogicException('Trying to set tag(s) to an Tag item index: ' . $item->getKey());
-        }
-
-        if (!$item->getTags() && !$item->getRemovedTags()) {
-            return true;
-        }
-
-        /**
-         * @var $tagsItems ExtendedCacheItemInterface[]
-         */
-        $tagsItems = $this->getItems($this->getTagKeys($item->getTags()));
-
-        foreach ($tagsItems as $tagsItem) {
-            $data = $tagsItem->get();
-            $expTimestamp = $item->getExpirationDate()->getTimestamp();
-
-            /**
-             * Using the key will
-             * avoid to use array_unique
-             * that has slow performances
-             */
-            $data = \array_merge((array)$data, [$item->getKey() => $expTimestamp]);
-            $tagsItem->set($data);
-
-            /**
-             * Recalculate the expiration date
-             *
-             * If the $tagsItem does not have
-             * any cache item references left
-             * then remove it from tagsItems index
-             */
-            $tagsItem->expiresAt((new DateTime())->setTimestamp(max($data)));
-
-            $this->driverWrite($tagsItem);
-            $tagsItem->setHit(true);
-        }
-
-        /**
-         * Also update removed tags to
-         * keep the index up to date
-         */
-        $tagsItems = $this->getItems($this->getTagKeys($item->getRemovedTags()));
-
-        foreach ($tagsItems as $tagsItem) {
-            $data = (array)$tagsItem->get();
-
-            unset($data[$item->getKey()]);
-            $tagsItem->set($data);
-
-            /**
-             * Recalculate the expiration date
-             *
-             * If the $tagsItem does not have
-             * any cache item references left
-             * then remove it from tagsItems index
-             */
-            if (\count($data)) {
-                $tagsItem->expiresAt((new DateTime())->setTimestamp(max($data)));
-                $this->driverWrite($tagsItem);
-                $tagsItem->setHit(true);
-            } else {
-                $this->deleteItem($tagsItem->getKey());
-            }
-        }
-
-        return true;
-    }
-
-    /**
-     * @param array<string> $keys
-     * @return array<string>
-     */
-    protected function getTagKeys(array $keys): array
-    {
-        return \array_map(
-            fn (string $key) => $this->getTagKey($key),
-            $keys
-        );
-    }
+	use ExtendedCacheItemPoolTrait;
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function getItemsByTagsAsJsonString(
+		array $tagNames,
+		int $option = \JSON_THROW_ON_ERROR,
+		int $depth = 512,
+		int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE
+	): string {
+		return \json_encode(
+			\array_map(
+				static fn(CacheItemInterface $item) => $item->get(),
+				\array_values($this->getItemsByTags($tagNames, $strategy))
+			),
+			$option,
+			$depth,
+		);
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function getItemsByTags(array $tagNames, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): array
+	{
+		$items = [];
+		foreach (\array_unique($tagNames) as $tagName) {
+			$items[] = $this->fetchItemsByTagFromBackend($tagName);
+		}
+
+		$items = \array_merge([], ...$items);
+
+		switch ($strategy) {
+			case TaggableCacheItemPoolInterface::TAG_STRATEGY_ALL:
+				foreach ($items as $key => $item) {
+					if (\array_diff($tagNames, $item->getTags())) {
+						unset($items[$key]);
+					}
+				}
+				break;
+
+			case TaggableCacheItemPoolInterface::TAG_STRATEGY_ONLY:
+				foreach ($items as $key => $item) {
+					if (\array_diff($tagNames, $item->getTags()) || \array_diff($item->getTags(), $tagNames)) {
+						unset($items[$key]);
+					}
+				}
+				break;
+		}
+		return $items;
+	}
+
+	/**
+	 * @param string $tagName
+	 * @return ExtendedCacheItemInterface[]
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	protected function fetchItemsByTagFromBackend(string $tagName): array
+	{
+		$driverResponse = $this->getItem($this->getTagKey($tagName));
+
+		if ($driverResponse->isHit()) {
+			$tagsItems = (array)$driverResponse->get();
+			/**
+			 * getItems() may provide expired item(s)
+			 * themselves provided by a cache of item
+			 * keys based stored the tag item.
+			 * Therefore, we pass a filter callback
+			 * to remove the expired Item(s) provided by
+			 * the item keys passed through getItems()
+			 *
+			 * #headache
+			 */
+			return \array_filter(
+				$this->getItems(\array_unique(\array_keys($tagsItems))),
+				static fn (ExtendedCacheItemInterface $item) => $item->isHit(),
+			);
+		}
+		return [];
+	}
+
+	/**
+	 * @param string $key
+	 * @return string
+	 */
+	protected function getTagKey(string $key): string
+	{
+		return TaggableCacheItemPoolInterface::DRIVER_TAGS_KEY_PREFIX . $key;
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws PhpfastcacheDriverException
+	 */
+	public function deleteItemsByTags(array $tagNames, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+	{
+		$return = true;
+
+		foreach ($this->getItemsByTags($tagNames, $strategy) as $item) {
+			$result = $this->deleteItem($item->getKey());
+			if ($result !== true) {
+				$return = $result;
+			}
+		}
+
+		return $return;
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws PhpfastcacheDriverException
+	 */
+	public function deleteItemsByTag(string $tagName, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+	{
+		$return = true;
+		foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
+			$result = $this->deleteItem($item->getKey());
+			if ($result !== true) {
+				$return = $result;
+			}
+		}
+
+		return $return;
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function getItemsByTag(string $tagName, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): array
+	{
+		$items = $this->fetchItemsByTagFromBackend($tagName);
+
+		if ($strategy === TaggableCacheItemPoolInterface::TAG_STRATEGY_ONLY) {
+			foreach ($items as $key => $item) {
+				if (\array_diff($item->getTags(), [$tagName])) {
+					unset($items[$key]);
+				}
+			}
+		}
+		return $items;
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws \ReflectionException
+	 */
+	public function incrementItemsByTags(array $tagNames, int $step = 1, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+	{
+		$return = true;
+		foreach ($tagNames as $tagName) {
+			$result = $this->incrementItemsByTag($tagName, $step, $strategy);
+			if ($result !== true) {
+				$return = $result;
+			}
+		}
+
+		return $return;
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws \ReflectionException
+	 */
+	public function incrementItemsByTag(string $tagName, int $step = 1, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+	{
+		foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
+			$item->increment($step);
+			$this->saveDeferred($item);
+		}
+
+		return $this->commit();
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws \ReflectionException
+	 */
+	public function decrementItemsByTags(array $tagNames, int $step = 1, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+	{
+		$return = true;
+		foreach ($tagNames as $tagName) {
+			$result = $this->decrementItemsByTag($tagName, $step, $strategy);
+			if ($result !== true) {
+				$return = $result;
+			}
+		}
+
+		return $return;
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws \ReflectionException
+	 */
+	public function decrementItemsByTag(string $tagName, int $step = 1, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+	{
+		foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
+			$item->decrement($step);
+			$this->saveDeferred($item);
+		}
+
+		return $this->commit();
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws \ReflectionException
+	 */
+	public function appendItemsByTags(array $tagNames, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+	{
+		$return = true;
+		foreach ($tagNames as $tagName) {
+			$result = $this->appendItemsByTag($tagName, $data, $strategy);
+			if ($result !== true) {
+				$return = $result;
+			}
+		}
+
+		return $return;
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws \ReflectionException
+	 */
+	public function appendItemsByTag(string $tagName, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+	{
+		foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
+			$item->append($data);
+			$this->saveDeferred($item);
+		}
+
+		return $this->commit();
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws \ReflectionException
+	 */
+	public function prependItemsByTags(array $tagNames, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+	{
+		$return = true;
+		foreach ($tagNames as $tagName) {
+			$result = $this->prependItemsByTag($tagName, $data, $strategy);
+			if ($result !== true) {
+				$return = $result;
+			}
+		}
+
+		return $return;
+	}
+
+	/**
+	 * @inheritDoc
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws \ReflectionException
+	 */
+	public function prependItemsByTag(string $tagName, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+	{
+		foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
+			$item->prepend($data);
+			$this->saveDeferred($item);
+		}
+
+		return $this->commit();
+	}
+
+	/**
+	 * @param array<mixed> $wrapper
+	 * @return string[]
+	 */
+	protected function driverUnwrapTags(array $wrapper): array
+	{
+		return $wrapper[TaggableCacheItemPoolInterface::DRIVER_TAGS_WRAPPER_INDEX];
+	}
+
+	/**
+	 * @param ExtendedCacheItemInterface $item
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 */
+	protected function cleanItemTags(ExtendedCacheItemInterface $item): void
+	{
+		if (!empty($item->getTags()) || !empty($item->getRemovedTags())) {
+			$this->driverWriteTags($item->removeTags($item->getTags()));
+		}
+	}
+
+	/**
+	 * @param ExtendedCacheItemInterface $item
+	 * @return bool
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 * @throws PhpfastcacheLogicException
+	 * @throws PhpfastcacheDriverException
+	 */
+	protected function driverWriteTags(ExtendedCacheItemInterface $item): bool
+	{
+		/**
+		 * Do not attempt to write tags
+		 * on tags item, it can lead
+		 * to an infinite recursive calls
+		 */
+		if (str_starts_with($item->getKey(), TaggableCacheItemPoolInterface::DRIVER_TAGS_KEY_PREFIX)) {
+			throw new PhpfastcacheLogicException('Trying to set tag(s) to an Tag item index: ' . $item->getKey());
+		}
+
+		if (!$item->getTags() && !$item->getRemovedTags()) {
+			return true;
+		}
+
+		/**
+		 * @var $tagsItems ExtendedCacheItemInterface[]
+		 */
+		$tagsItems = $this->getItems($this->getTagKeys($item->getTags()));
+
+		foreach ($tagsItems as $tagsItem) {
+			$data = $tagsItem->get();
+			$expTimestamp = $item->getExpirationDate()->getTimestamp();
+
+			/**
+			 * Using the key will
+			 * avoid to use array_unique
+			 * that has slow performances
+			 */
+			$data = \array_merge((array)$data, [$item->getKey() => $expTimestamp]);
+			$tagsItem->set($data);
+
+			/**
+			 * Recalculate the expiration date
+			 *
+			 * If the $tagsItem does not have
+			 * any cache item references left
+			 * then remove it from tagsItems index
+			 */
+			$tagsItem->expiresAt((new DateTime())->setTimestamp(max($data)));
+
+			$this->driverWrite($tagsItem);
+			$tagsItem->setHit(true);
+		}
+
+		/**
+		 * Also update removed tags to
+		 * keep the index up to date
+		 */
+		$tagsItems = $this->getItems($this->getTagKeys($item->getRemovedTags()));
+
+		foreach ($tagsItems as $tagsItem) {
+			$data = (array)$tagsItem->get();
+
+			unset($data[$item->getKey()]);
+			$tagsItem->set($data);
+
+			/**
+			 * Recalculate the expiration date
+			 *
+			 * If the $tagsItem does not have
+			 * any cache item references left
+			 * then remove it from tagsItems index
+			 */
+			if (\count($data)) {
+				$tagsItem->expiresAt((new DateTime())->setTimestamp(max($data)));
+				$this->driverWrite($tagsItem);
+				$tagsItem->setHit(true);
+			} else {
+				$this->deleteItem($tagsItem->getKey());
+			}
+		}
+
+		return true;
+	}
+
+	/**
+	 * @param array<string> $keys
+	 * @return array<string>
+	 */
+	protected function getTagKeys(array $keys): array
+	{
+		return \array_map(
+			fn (string $key) => $this->getTagKey($key),
+			$keys
+		);
+	}
 }

Spacing +7 added lines, -7 removed lines

@@ -104,7 +104,7 @@ 
         $driverResponse = $this->getItem($this->getTagKey($tagName));
 
         if ($driverResponse->isHit()) {
-            $tagsItems = (array)$driverResponse->get();
+            $tagsItems = (array) $driverResponse->get();
             /**
              * getItems() may provide expired item(s)
              * themselves provided by a cache of item
@@ -280,7 +280,7 @@ 
      * @throws PhpfastcacheLogicException
      * @throws \ReflectionException
      */
-    public function appendItemsByTags(array $tagNames, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+    public function appendItemsByTags(array $tagNames, array | string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
     {
         $return = true;
         foreach ($tagNames as $tagName) {
@@ -301,7 +301,7 @@ 
      * @throws PhpfastcacheLogicException
      * @throws \ReflectionException
      */
-    public function appendItemsByTag(string $tagName, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+    public function appendItemsByTag(string $tagName, array | string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
     {
         foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
             $item->append($data);
@@ -319,7 +319,7 @@ 
      * @throws PhpfastcacheLogicException
      * @throws \ReflectionException
      */
-    public function prependItemsByTags(array $tagNames, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+    public function prependItemsByTags(array $tagNames, array | string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
     {
         $return = true;
         foreach ($tagNames as $tagName) {
@@ -340,7 +340,7 @@ 
      * @throws PhpfastcacheLogicException
      * @throws \ReflectionException
      */
-    public function prependItemsByTag(string $tagName, array|string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
+    public function prependItemsByTag(string $tagName, array | string $data, int $strategy = TaggableCacheItemPoolInterface::TAG_STRATEGY_ONE): bool
     {
         foreach ($this->getItemsByTag($tagName, $strategy) as $item) {
             $item->prepend($data);
@@ -410,7 +410,7 @@ 
              * avoid to use array_unique
              * that has slow performances
              */
-            $data = \array_merge((array)$data, [$item->getKey() => $expTimestamp]);
+            $data = \array_merge((array) $data, [$item->getKey() => $expTimestamp]);
             $tagsItem->set($data);
 
             /**
@@ -433,7 +433,7 @@ 
         $tagsItems = $this->getItems($this->getTagKeys($item->getRemovedTags()));
 
         foreach ($tagsItems as $tagsItem) {
-            $data = (array)$tagsItem->get();
+            $data = (array) $tagsItem->get();
 
             unset($data[$item->getKey()]);
             $tagsItem->set($data);

Braces +2 added lines, -1 removed lines

@@ -449,7 +449,8 @@
                 $tagsItem->expiresAt((new DateTime())->setTimestamp(max($data)));
                 $this->driverWrite($tagsItem);
                 $tagsItem->setHit(true);
-            } else {
+            }
+            else {
                 $this->deleteItem($tagsItem->getKey());
             }
         }

plugins/files/php/vendor/phpfastcache/phpfastcache/lib/Phpfastcache/Core/Pool/DriverBaseTrait.php

Indentation +282 added lines, -282 removed lines

@@ -39,286 +39,286 @@
 
 trait DriverBaseTrait
 {
-    use DriverPoolAbstractTrait;
-    use ClassNamespaceResolverTrait;
-    use EventManagerDispatcherTrait;
-
-    /**
-     * @var string[]
-     */
-    protected static array $cacheItemClasses = [];
-
-    protected ConfigurationOptionInterface $config;
-
-    /**
-     * @var object|null
-     */
-    protected ?object $instance;
-
-    protected string $driverName;
-
-    protected string $instanceId;
-
-    /**
-     * Driver constructor.
-     * @param ConfigurationOptionInterface $config
-     * @param string $instanceId
-     * @param EventManagerInterface $em
-     * @throws PhpfastcacheCoreException
-     * @throws PhpfastcacheDriverCheckException
-     * @throws PhpfastcacheDriverConnectException
-     * @throws PhpfastcacheIOException
-     * @throws PhpfastcacheInvalidArgumentException
-     */
-    public function __construct(#[\SensitiveParameter] ConfigurationOptionInterface $config, string $instanceId, EventManagerInterface $em)
-    {
-        $this->setEventManager($em->getScopedEventManager($this));
-        $this->setConfig($config);
-        $this->instanceId = $instanceId;
-
-        if (!$this->driverCheck()) {
-            throw new PhpfastcacheDriverCheckException(
-                \sprintf(
-                    ExtendedCacheItemPoolInterface::DRIVER_CHECK_FAILURE,
-                    $this->getDriverName(),
-                    $this->getHelp() ? " Additionally, {$this->getHelp()}" : ''
-                )
-            );
-        }
-        $this->eventManager->dispatch(Event::CACHE_DRIVER_CHECKED, $this);
-
-        try {
-            $this->driverConnect();
-            $config->lock($this); // Lock the config only after a successful driver connection.
-            $this->eventManager->dispatch(Event::CACHE_DRIVER_CONNECTED, $this, $this->instance ?? null);
-        } catch (Throwable $e) {
-            throw new PhpfastcacheDriverConnectException(
-                sprintf(
-                    ExtendedCacheItemPoolInterface::DRIVER_CONNECT_FAILURE,
-                    $this->getDriverName(),
-                    $e->getMessage(),
-                    $e->getLine() ?: 'unknown line',
-                    $e->getFile() ?: 'unknown file',
-                ),
-                0,
-                $e
-            );
-        }
-    }
-
-    /**
-     * @return string
-     */
-    public function getDriverName(): string
-    {
-        if (!isset($this->driverName)) {
-            $this->driverName = \ucfirst(\substr(\strrchr((new ReflectionObject($this))->getNamespaceName(), '\\'), 1));
-        }
-        return $this->driverName;
-    }
-
-    /**
-     * @return ConfigurationOptionInterface
-     */
-    public function getDefaultConfig(): ConfigurationOptionInterface
-    {
-        $className = $this::getConfigClass();
-
-        return new $className();
-    }
-
-    /**
-     * @return string
-     */
-    public static function getConfigClass(): string
-    {
-        $localConfigClass = \substr(static::class, 0, \strrpos(static::class, '\\')) . '\Config';
-        if (\class_exists($localConfigClass) && \is_a($localConfigClass, ConfigurationOption::class, true)) {
-            return $localConfigClass;
-        }
-        return ConfigurationOption::class;
-    }
-
-    public static function getItemClass(): string
-    {
-        if (!isset(self::$cacheItemClasses[static::class])) {
-            self::$cacheItemClasses[static::class] = self::getClassNamespace() . '\\' . 'Item';
-        }
-
-        return self::$cacheItemClasses[static::class];
-    }
-
-    /**
-     * @inheritDoc
-     */
-    public function getEncodedKey(string $key): string
-    {
-        $keyHashFunction = $this->getConfig()->getDefaultKeyHashFunction();
-
-        if ($keyHashFunction) {
-            if (\is_callable($keyHashFunction)) {
-                return $keyHashFunction($key);
-            }
-            throw new PhpfastcacheLogicException('Unable to build the encoded key (defaultKeyHashFunction is not callable)');
-        }
-
-        return $key;
-    }
-
-
-
-    /**
-     * @param ExtendedCacheItemInterface $item
-     * @param bool $stringifyDate
-     * @return array<string, mixed>
-     * @throws PhpfastcacheLogicException
-     */
-    public function driverPreWrap(ExtendedCacheItemInterface $item, bool $stringifyDate = false): array
-    {
-        $wrap = [
-            ExtendedCacheItemPoolInterface::DRIVER_KEY_WRAPPER_INDEX => $item->getKey(), // Stored but not really used, allow you to quickly identify the cache key
-            ExtendedCacheItemPoolInterface::DRIVER_DATA_WRAPPER_INDEX => $item->_getData(),
-            ExtendedCacheItemPoolInterface::DRIVER_EDATE_WRAPPER_INDEX => $item->getExpirationDate(),
-            TaggableCacheItemPoolInterface::DRIVER_TAGS_WRAPPER_INDEX => $item->getTags(),
-        ];
-
-        if ($this->getConfig()->isItemDetailedDate()) {
-            $wrap[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX] = new DateTime();// Always on the latest date
-            /**
-             * If the creation date exists
-             * reuse it else set a new Date
-             */
-            $wrap[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX] = $item->getCreationDate();
-        } else {
-            $wrap[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX] = null;
-            $wrap[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX] = null;
-        }
-
-        if ($stringifyDate) {
-            \array_walk($wrap, static function (mixed &$value, string $key): void {
-                if ($value instanceof DateTimeInterface && $key !== ExtendedCacheItemPoolInterface::DRIVER_DATA_WRAPPER_INDEX) {
-                    $value = $value->format(DateTimeInterface::W3C);
-                }
-            });
-        }
-
-        return $wrap;
-    }
-
-    /**
-     * @return ConfigurationOptionInterface
-     */
-    public function getConfig(): ConfigurationOptionInterface
-    {
-        return $this->config;
-    }
-
-    /**
-     * @param ConfigurationOptionInterface $config
-     * @return static
-     */
-    public function setConfig(ConfigurationOptionInterface $config): static
-    {
-        $this->config = $config;
-
-        return $this;
-    }
-
-    /**
-     * @param array<string, mixed> $wrapper
-     * @return mixed
-     * @throws \Exception
-     */
-    public function driverUnwrapData(array $wrapper): mixed
-    {
-        return $wrapper[ExtendedCacheItemPoolInterface::DRIVER_DATA_WRAPPER_INDEX];
-    }
-
-    /**
-     * @param array<string, mixed> $wrapper
-     * @return DateTimeInterface
-     */
-    public function driverUnwrapEdate(array $wrapper): \DateTimeInterface
-    {
-        if ($wrapper[ExtendedCacheItemPoolInterface::DRIVER_EDATE_WRAPPER_INDEX] instanceof \DateTimeInterface) {
-            return $wrapper[ExtendedCacheItemPoolInterface::DRIVER_EDATE_WRAPPER_INDEX];
-        }
-
-        return DateTime::createFromFormat(\DateTimeInterface::W3C, $wrapper[ExtendedCacheItemPoolInterface::DRIVER_EDATE_WRAPPER_INDEX]);
-    }
-
-    /**
-     * @param array<string, mixed> $wrapper
-     * @return DateTimeInterface|null
-     */
-    public function driverUnwrapCdate(array $wrapper): ?\DateTimeInterface
-    {
-        if ($wrapper[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX] instanceof \DateTimeInterface) {
-            return $wrapper[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX];
-        }
-
-        return DateTime::createFromFormat(\DateTimeInterface::W3C, $wrapper[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX]);
-    }
-
-    /**
-     * @param array<string, mixed> $wrapper
-     * @return DateTimeInterface|null
-     */
-    public function driverUnwrapMdate(array $wrapper): ?\DateTimeInterface
-    {
-        if ($wrapper[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX] instanceof \DateTimeInterface) {
-            return $wrapper[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX];
-        }
-
-        return DateTime::createFromFormat(\DateTimeInterface::W3C, $wrapper[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX]);
-    }
-
-    /**
-     * @return string
-     */
-    public function getInstanceId(): string
-    {
-        return $this->instanceId;
-    }
-
-    /**
-     * Encode data types such as object/array
-     * for driver that does not support
-     * non-scalar value
-     * @param mixed $data
-     * @return string
-     */
-    protected function encode(mixed $data): string
-    {
-        return \serialize($data);
-    }
-
-    /**
-     * Decode data stored in the cache
-     * for driver that does not support
-     * non-scalar value storage.
-     * @param string|null $value
-     * @return array<string, mixed>|null
-     * @throws PhpfastcacheDriverException
-     */
-    protected function decode(?string $value): ?array
-    {
-        $decoded = $this->unserialize($value);
-
-        if ($decoded === null || is_array($decoded)) {
-            return $decoded;
-        }
-        throw new PhpfastcacheCorruptedDataException(
-            sprintf(
-                'Failed to unserialize data from the cache, expected array or null but got "%s". Stored data may be corrupted.',
-                gettype($decoded)
-            ),
-            $value
-        );
-    }
-
-    protected function unserialize(?string $value): mixed
-    {
-        return $value ? \unserialize($value, ['allowed_classes' => true]) : null;
-    }
+	use DriverPoolAbstractTrait;
+	use ClassNamespaceResolverTrait;
+	use EventManagerDispatcherTrait;
+
+	/**
+	 * @var string[]
+	 */
+	protected static array $cacheItemClasses = [];
+
+	protected ConfigurationOptionInterface $config;
+
+	/**
+	 * @var object|null
+	 */
+	protected ?object $instance;
+
+	protected string $driverName;
+
+	protected string $instanceId;
+
+	/**
+	 * Driver constructor.
+	 * @param ConfigurationOptionInterface $config
+	 * @param string $instanceId
+	 * @param EventManagerInterface $em
+	 * @throws PhpfastcacheCoreException
+	 * @throws PhpfastcacheDriverCheckException
+	 * @throws PhpfastcacheDriverConnectException
+	 * @throws PhpfastcacheIOException
+	 * @throws PhpfastcacheInvalidArgumentException
+	 */
+	public function __construct(#[\SensitiveParameter] ConfigurationOptionInterface $config, string $instanceId, EventManagerInterface $em)
+	{
+		$this->setEventManager($em->getScopedEventManager($this));
+		$this->setConfig($config);
+		$this->instanceId = $instanceId;
+
+		if (!$this->driverCheck()) {
+			throw new PhpfastcacheDriverCheckException(
+				\sprintf(
+					ExtendedCacheItemPoolInterface::DRIVER_CHECK_FAILURE,
+					$this->getDriverName(),
+					$this->getHelp() ? " Additionally, {$this->getHelp()}" : ''
+				)
+			);
+		}
+		$this->eventManager->dispatch(Event::CACHE_DRIVER_CHECKED, $this);
+
+		try {
+			$this->driverConnect();
+			$config->lock($this); // Lock the config only after a successful driver connection.
+			$this->eventManager->dispatch(Event::CACHE_DRIVER_CONNECTED, $this, $this->instance ?? null);
+		} catch (Throwable $e) {
+			throw new PhpfastcacheDriverConnectException(
+				sprintf(
+					ExtendedCacheItemPoolInterface::DRIVER_CONNECT_FAILURE,
+					$this->getDriverName(),
+					$e->getMessage(),
+					$e->getLine() ?: 'unknown line',
+					$e->getFile() ?: 'unknown file',
+				),
+				0,
+				$e
+			);
+		}
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getDriverName(): string
+	{
+		if (!isset($this->driverName)) {
+			$this->driverName = \ucfirst(\substr(\strrchr((new ReflectionObject($this))->getNamespaceName(), '\\'), 1));
+		}
+		return $this->driverName;
+	}
+
+	/**
+	 * @return ConfigurationOptionInterface
+	 */
+	public function getDefaultConfig(): ConfigurationOptionInterface
+	{
+		$className = $this::getConfigClass();
+
+		return new $className();
+	}
+
+	/**
+	 * @return string
+	 */
+	public static function getConfigClass(): string
+	{
+		$localConfigClass = \substr(static::class, 0, \strrpos(static::class, '\\')) . '\Config';
+		if (\class_exists($localConfigClass) && \is_a($localConfigClass, ConfigurationOption::class, true)) {
+			return $localConfigClass;
+		}
+		return ConfigurationOption::class;
+	}
+
+	public static function getItemClass(): string
+	{
+		if (!isset(self::$cacheItemClasses[static::class])) {
+			self::$cacheItemClasses[static::class] = self::getClassNamespace() . '\\' . 'Item';
+		}
+
+		return self::$cacheItemClasses[static::class];
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	public function getEncodedKey(string $key): string
+	{
+		$keyHashFunction = $this->getConfig()->getDefaultKeyHashFunction();
+
+		if ($keyHashFunction) {
+			if (\is_callable($keyHashFunction)) {
+				return $keyHashFunction($key);
+			}
+			throw new PhpfastcacheLogicException('Unable to build the encoded key (defaultKeyHashFunction is not callable)');
+		}
+
+		return $key;
+	}
+
+
+
+	/**
+	 * @param ExtendedCacheItemInterface $item
+	 * @param bool $stringifyDate
+	 * @return array<string, mixed>
+	 * @throws PhpfastcacheLogicException
+	 */
+	public function driverPreWrap(ExtendedCacheItemInterface $item, bool $stringifyDate = false): array
+	{
+		$wrap = [
+			ExtendedCacheItemPoolInterface::DRIVER_KEY_WRAPPER_INDEX => $item->getKey(), // Stored but not really used, allow you to quickly identify the cache key
+			ExtendedCacheItemPoolInterface::DRIVER_DATA_WRAPPER_INDEX => $item->_getData(),
+			ExtendedCacheItemPoolInterface::DRIVER_EDATE_WRAPPER_INDEX => $item->getExpirationDate(),
+			TaggableCacheItemPoolInterface::DRIVER_TAGS_WRAPPER_INDEX => $item->getTags(),
+		];
+
+		if ($this->getConfig()->isItemDetailedDate()) {
+			$wrap[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX] = new DateTime();// Always on the latest date
+			/**
+			 * If the creation date exists
+			 * reuse it else set a new Date
+			 */
+			$wrap[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX] = $item->getCreationDate();
+		} else {
+			$wrap[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX] = null;
+			$wrap[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX] = null;
+		}
+
+		if ($stringifyDate) {
+			\array_walk($wrap, static function (mixed &$value, string $key): void {
+				if ($value instanceof DateTimeInterface && $key !== ExtendedCacheItemPoolInterface::DRIVER_DATA_WRAPPER_INDEX) {
+					$value = $value->format(DateTimeInterface::W3C);
+				}
+			});
+		}
+
+		return $wrap;
+	}
+
+	/**
+	 * @return ConfigurationOptionInterface
+	 */
+	public function getConfig(): ConfigurationOptionInterface
+	{
+		return $this->config;
+	}
+
+	/**
+	 * @param ConfigurationOptionInterface $config
+	 * @return static
+	 */
+	public function setConfig(ConfigurationOptionInterface $config): static
+	{
+		$this->config = $config;
+
+		return $this;
+	}
+
+	/**
+	 * @param array<string, mixed> $wrapper
+	 * @return mixed
+	 * @throws \Exception
+	 */
+	public function driverUnwrapData(array $wrapper): mixed
+	{
+		return $wrapper[ExtendedCacheItemPoolInterface::DRIVER_DATA_WRAPPER_INDEX];
+	}
+
+	/**
+	 * @param array<string, mixed> $wrapper
+	 * @return DateTimeInterface
+	 */
+	public function driverUnwrapEdate(array $wrapper): \DateTimeInterface
+	{
+		if ($wrapper[ExtendedCacheItemPoolInterface::DRIVER_EDATE_WRAPPER_INDEX] instanceof \DateTimeInterface) {
+			return $wrapper[ExtendedCacheItemPoolInterface::DRIVER_EDATE_WRAPPER_INDEX];
+		}
+
+		return DateTime::createFromFormat(\DateTimeInterface::W3C, $wrapper[ExtendedCacheItemPoolInterface::DRIVER_EDATE_WRAPPER_INDEX]);
+	}
+
+	/**
+	 * @param array<string, mixed> $wrapper
+	 * @return DateTimeInterface|null
+	 */
+	public function driverUnwrapCdate(array $wrapper): ?\DateTimeInterface
+	{
+		if ($wrapper[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX] instanceof \DateTimeInterface) {
+			return $wrapper[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX];
+		}
+
+		return DateTime::createFromFormat(\DateTimeInterface::W3C, $wrapper[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX]);
+	}
+
+	/**
+	 * @param array<string, mixed> $wrapper
+	 * @return DateTimeInterface|null
+	 */
+	public function driverUnwrapMdate(array $wrapper): ?\DateTimeInterface
+	{
+		if ($wrapper[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX] instanceof \DateTimeInterface) {
+			return $wrapper[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX];
+		}
+
+		return DateTime::createFromFormat(\DateTimeInterface::W3C, $wrapper[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX]);
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getInstanceId(): string
+	{
+		return $this->instanceId;
+	}
+
+	/**
+	 * Encode data types such as object/array
+	 * for driver that does not support
+	 * non-scalar value
+	 * @param mixed $data
+	 * @return string
+	 */
+	protected function encode(mixed $data): string
+	{
+		return \serialize($data);
+	}
+
+	/**
+	 * Decode data stored in the cache
+	 * for driver that does not support
+	 * non-scalar value storage.
+	 * @param string|null $value
+	 * @return array<string, mixed>|null
+	 * @throws PhpfastcacheDriverException
+	 */
+	protected function decode(?string $value): ?array
+	{
+		$decoded = $this->unserialize($value);
+
+		if ($decoded === null || is_array($decoded)) {
+			return $decoded;
+		}
+		throw new PhpfastcacheCorruptedDataException(
+			sprintf(
+				'Failed to unserialize data from the cache, expected array or null but got "%s". Stored data may be corrupted.',
+				gettype($decoded)
+			),
+			$value
+		);
+	}
+
+	protected function unserialize(?string $value): mixed
+	{
+		return $value ? \unserialize($value, ['allowed_classes' => true]) : null;
+	}
 }

Spacing +2 added lines, -2 removed lines

@@ -183,7 +183,7 @@ 
         ];
 
         if ($this->getConfig()->isItemDetailedDate()) {
-            $wrap[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX] = new DateTime();// Always on the latest date
+            $wrap[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX] = new DateTime(); // Always on the latest date
             /**
              * If the creation date exists
              * reuse it else set a new Date
@@ -195,7 +195,7 @@ 
         }
 
         if ($stringifyDate) {
-            \array_walk($wrap, static function (mixed &$value, string $key): void {
+            \array_walk($wrap, static function(mixed &$value, string $key): void {
                 if ($value instanceof DateTimeInterface && $key !== ExtendedCacheItemPoolInterface::DRIVER_DATA_WRAPPER_INDEX) {
                     $value = $value->format(DateTimeInterface::W3C);
                 }

Braces +5 added lines, -4 removed lines

@@ -70,8 +70,7 @@ 
      * @throws PhpfastcacheIOException
      * @throws PhpfastcacheInvalidArgumentException
      */
-    public function __construct(#[\SensitiveParameter] ConfigurationOptionInterface $config, string $instanceId, EventManagerInterface $em)
-    {
+    public function __construct(#[\SensitiveParameter] ConfigurationOptionInterface $config, string $instanceId, EventManagerInterface $em) {
         $this->setEventManager($em->getScopedEventManager($this));
         $this->setConfig($config);
         $this->instanceId = $instanceId;
@@ -91,7 +90,8 @@ 
             $this->driverConnect();
             $config->lock($this); // Lock the config only after a successful driver connection.
             $this->eventManager->dispatch(Event::CACHE_DRIVER_CONNECTED, $this, $this->instance ?? null);
-        } catch (Throwable $e) {
+        }
+        catch (Throwable $e) {
             throw new PhpfastcacheDriverConnectException(
                 sprintf(
                     ExtendedCacheItemPoolInterface::DRIVER_CONNECT_FAILURE,
@@ -189,7 +189,8 @@ 
              * reuse it else set a new Date
              */
             $wrap[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX] = $item->getCreationDate();
-        } else {
+        }
+        else {
             $wrap[ExtendedCacheItemPoolInterface::DRIVER_MDATE_WRAPPER_INDEX] = null;
             $wrap[ExtendedCacheItemPoolInterface::DRIVER_CDATE_WRAPPER_INDEX] = null;
         }