Update website

vendor/doctrine/dbal/src/Cache/ArrayResult.php

@@ -0,0 +1,116 @@
+<?php
+
+namespace Doctrine\DBAL\Cache;
+
+use Doctrine\DBAL\Driver\FetchUtils;
+use Doctrine\DBAL\Driver\Result;
+
+use function array_values;
+use function count;
+use function reset;
+
+/** @internal The class is internal to the caching layer implementation. */
+final class ArrayResult implements Result
+{
+    /** @var list<array<string, mixed>> */
+    private array $data;
+
+    private int $columnCount = 0;
+    private int $num         = 0;
+
+    /** @param list<array<string, mixed>> $data */
+    public function __construct(array $data)
+    {
+        $this->data = $data;
+        if (count($data) === 0) {
+            return;
+        }
+
+        $this->columnCount = count($data[0]);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fetchNumeric()
+    {
+        $row = $this->fetch();
+
+        if ($row === false) {
+            return false;
+        }
+
+        return array_values($row);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fetchAssociative()
+    {
+        return $this->fetch();
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fetchOne()
+    {
+        $row = $this->fetch();
+
+        if ($row === false) {
+            return false;
+        }
+
+        return reset($row);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fetchAllNumeric(): array
+    {
+        return FetchUtils::fetchAllNumeric($this);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fetchAllAssociative(): array
+    {
+        return FetchUtils::fetchAllAssociative($this);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fetchFirstColumn(): array
+    {
+        return FetchUtils::fetchFirstColumn($this);
+    }
+
+    public function rowCount(): int
+    {
+        return count($this->data);
+    }
+
+    public function columnCount(): int
+    {
+        return $this->columnCount;
+    }
+
+    public function free(): void
+    {
+        $this->data = [];
+    }
+
+    /** @return array<string, mixed>|false */
+    private function fetch()
+    {
+        if (! isset($this->data[$this->num])) {
+            return false;
+        }
+
+        return $this->data[$this->num++];
+    }
+}

vendor/doctrine/dbal/src/Cache/CacheException.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Doctrine\DBAL\Cache;
+
+use Doctrine\DBAL\Exception;
+
+/** @psalm-immutable */
+class CacheException extends Exception
+{
+    /** @return CacheException */
+    public static function noCacheKey()
+    {
+        return new self('No cache key was set.');
+    }
+
+    /** @return CacheException */
+    public static function noResultDriverConfigured()
+    {
+        return new self('Trying to cache a query but no result driver is configured.');
+    }
+}

vendor/doctrine/dbal/src/Cache/QueryCacheProfile.php

@@ -0,0 +1,176 @@
+<?php
+
+namespace Doctrine\DBAL\Cache;
+
+use Doctrine\Common\Cache\Cache;
+use Doctrine\Common\Cache\Psr6\CacheAdapter;
+use Doctrine\Common\Cache\Psr6\DoctrineProvider;
+use Doctrine\DBAL\Types\Type;
+use Doctrine\Deprecations\Deprecation;
+use Psr\Cache\CacheItemPoolInterface;
+use TypeError;
+
+use function get_class;
+use function hash;
+use function serialize;
+use function sha1;
+use function sprintf;
+
+/**
+ * Query Cache Profile handles the data relevant for query caching.
+ *
+ * It is a value object, setter methods return NEW instances.
+ */
+class QueryCacheProfile
+{
+    private ?CacheItemPoolInterface $resultCache = null;
+
+    /** @var int */
+    private $lifetime;
+
+    /** @var string|null */
+    private $cacheKey;
+
+    /**
+     * @param int                               $lifetime
+     * @param string|null                       $cacheKey
+     * @param CacheItemPoolInterface|Cache|null $resultCache
+     */
+    public function __construct($lifetime = 0, $cacheKey = null, ?object $resultCache = null)
+    {
+        $this->lifetime = $lifetime;
+        $this->cacheKey = $cacheKey;
+        if ($resultCache instanceof CacheItemPoolInterface) {
+            $this->resultCache = $resultCache;
+        } elseif ($resultCache instanceof Cache) {
+            Deprecation::trigger(
+                'doctrine/dbal',
+                'https://github.com/doctrine/dbal/pull/4620',
+                'Passing an instance of %s to %s as $resultCache is deprecated. Pass an instance of %s instead.',
+                Cache::class,
+                __METHOD__,
+                CacheItemPoolInterface::class,
+            );
+
+            $this->resultCache = CacheAdapter::wrap($resultCache);
+        } elseif ($resultCache !== null) {
+            throw new TypeError(sprintf(
+                '$resultCache: Expected either null or an instance of %s or %s, got %s.',
+                CacheItemPoolInterface::class,
+                Cache::class,
+                get_class($resultCache),
+            ));
+        }
+    }
+
+    public function getResultCache(): ?CacheItemPoolInterface
+    {
+        return $this->resultCache;
+    }
+
+    /**
+     * @deprecated Use {@see getResultCache()} instead.
+     *
+     * @return Cache|null
+     */
+    public function getResultCacheDriver()
+    {
+        Deprecation::trigger(
+            'doctrine/dbal',
+            'https://github.com/doctrine/dbal/pull/4620',
+            '%s is deprecated, call getResultCache() instead.',
+            __METHOD__,
+        );
+
+        return $this->resultCache !== null ? DoctrineProvider::wrap($this->resultCache) : null;
+    }
+
+    /** @return int */
+    public function getLifetime()
+    {
+        return $this->lifetime;
+    }
+
+    /**
+     * @return string
+     *
+     * @throws CacheException
+     */
+    public function getCacheKey()
+    {
+        if ($this->cacheKey === null) {
+            throw CacheException::noCacheKey();
+        }
+
+        return $this->cacheKey;
+    }
+
+    /**
+     * Generates the real cache key from query, params, types and connection parameters.
+     *
+     * @param string                                                               $sql
+     * @param list<mixed>|array<string, mixed>                                     $params
+     * @param array<int, Type|int|string|null>|array<string, Type|int|string|null> $types
+     * @param array<string, mixed>                                                 $connectionParams
+     *
+     * @return array{string, string}
+     */
+    public function generateCacheKeys($sql, $params, $types, array $connectionParams = [])
+    {
+        if (isset($connectionParams['password'])) {
+            unset($connectionParams['password']);
+        }
+
+        $realCacheKey = 'query=' . $sql .
+            '&params=' . serialize($params) .
+            '&types=' . serialize($types) .
+            '&connectionParams=' . hash('sha256', serialize($connectionParams));
+
+        // should the key be automatically generated using the inputs or is the cache key set?
+        $cacheKey = $this->cacheKey ?? sha1($realCacheKey);
+
+        return [$cacheKey, $realCacheKey];
+    }
+
+    public function setResultCache(CacheItemPoolInterface $cache): QueryCacheProfile
+    {
+        return new QueryCacheProfile($this->lifetime, $this->cacheKey, $cache);
+    }
+
+    /**
+     * @deprecated Use {@see setResultCache()} instead.
+     *
+     * @return QueryCacheProfile
+     */
+    public function setResultCacheDriver(Cache $cache)
+    {
+        Deprecation::trigger(
+            'doctrine/dbal',
+            'https://github.com/doctrine/dbal/pull/4620',
+            '%s is deprecated, call setResultCache() instead.',
+            __METHOD__,
+        );
+
+        return new QueryCacheProfile($this->lifetime, $this->cacheKey, CacheAdapter::wrap($cache));
+    }
+
+    /**
+     * @param string|null $cacheKey
+     *
+     * @return QueryCacheProfile
+     */
+    public function setCacheKey($cacheKey)
+    {
+        return new QueryCacheProfile($this->lifetime, $cacheKey, $this->resultCache);
+    }
+
+    /**
+     * @param int $lifetime
+     *
+     * @return QueryCacheProfile
+     */
+    public function setLifetime($lifetime)
+    {
+        return new QueryCacheProfile($lifetime, $this->cacheKey, $this->resultCache);
+    }
+}