VERSION 0.2 doctrine ORM et entités

3 files changed, 327 insertions, 0 deletions

diff --git a/vendor/doctrine/orm/src/Cache/Region/DefaultRegion.php b/vendor/doctrine/orm/src/Cache/Region/DefaultRegion.php
new file mode 100644
index 0000000..0576195
--- /dev/null
+++ b/vendor/doctrine/orm/src/Cache/Region/DefaultRegion.php
@@ -0,0 +1,113 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Cache\Region;
+
+use Doctrine\ORM\Cache\CacheEntry;
+use Doctrine\ORM\Cache\CacheKey;
+use Doctrine\ORM\Cache\CollectionCacheEntry;
+use Doctrine\ORM\Cache\Lock;
+use Doctrine\ORM\Cache\Region;
+use Psr\Cache\CacheItemInterface;
+use Psr\Cache\CacheItemPoolInterface;
+use Traversable;
+
+use function array_map;
+use function iterator_to_array;
+use function strtr;
+
+/**
+ * The simplest cache region compatible with all doctrine-cache drivers.
+ */
+class DefaultRegion implements Region
+{
+    private const REGION_KEY_SEPARATOR = '_';
+    private const REGION_PREFIX        = 'DC2_REGION_';
+
+    public function __construct(
+        private readonly string $name,
+        private readonly CacheItemPoolInterface $cacheItemPool,
+        private readonly int $lifetime = 0,
+    ) {
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function contains(CacheKey $key): bool
+    {
+        return $this->cacheItemPool->hasItem($this->getCacheEntryKey($key));
+    }
+
+    public function get(CacheKey $key): CacheEntry|null
+    {
+        $item  = $this->cacheItemPool->getItem($this->getCacheEntryKey($key));
+        $entry = $item->isHit() ? $item->get() : null;
+
+        if (! $entry instanceof CacheEntry) {
+            return null;
+        }
+
+        return $entry;
+    }
+
+    public function getMultiple(CollectionCacheEntry $collection): array|null
+    {
+        $keys = array_map(
+            $this->getCacheEntryKey(...),
+            $collection->identifiers,
+        );
+        /** @var iterable<string, CacheItemInterface> $items */
+        $items = $this->cacheItemPool->getItems($keys);
+        if ($items instanceof Traversable) {
+            $items = iterator_to_array($items);
+        }
+
+        $result = [];
+        foreach ($keys as $arrayKey => $cacheKey) {
+            if (! isset($items[$cacheKey]) || ! $items[$cacheKey]->isHit()) {
+                return null;
+            }
+
+            $entry = $items[$cacheKey]->get();
+            if (! $entry instanceof CacheEntry) {
+                return null;
+            }
+
+            $result[$arrayKey] = $entry;
+        }
+
+        return $result;
+    }
+
+    public function put(CacheKey $key, CacheEntry $entry, Lock|null $lock = null): bool
+    {
+        $item = $this->cacheItemPool
+            ->getItem($this->getCacheEntryKey($key))
+            ->set($entry);
+
+        if ($this->lifetime > 0) {
+            $item->expiresAfter($this->lifetime);
+        }
+
+        return $this->cacheItemPool->save($item);
+    }
+
+    public function evict(CacheKey $key): bool
+    {
+        return $this->cacheItemPool->deleteItem($this->getCacheEntryKey($key));
+    }
+
+    public function evictAll(): bool
+    {
+        return $this->cacheItemPool->clear(self::REGION_PREFIX . $this->name);
+    }
+
+    private function getCacheEntryKey(CacheKey $key): string
+    {
+        return self::REGION_PREFIX . $this->name . self::REGION_KEY_SEPARATOR . strtr($key->hash, '{}()/\@:', '________');
+    }
+}
diff --git a/vendor/doctrine/orm/src/Cache/Region/FileLockRegion.php b/vendor/doctrine/orm/src/Cache/Region/FileLockRegion.php
new file mode 100644
index 0000000..bedd6a6
--- /dev/null
+++ b/vendor/doctrine/orm/src/Cache/Region/FileLockRegion.php
@@ -0,0 +1,194 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Cache\Region;
+
+use Doctrine\ORM\Cache\CacheEntry;
+use Doctrine\ORM\Cache\CacheKey;
+use Doctrine\ORM\Cache\CollectionCacheEntry;
+use Doctrine\ORM\Cache\ConcurrentRegion;
+use Doctrine\ORM\Cache\Lock;
+use Doctrine\ORM\Cache\Region;
+use InvalidArgumentException;
+
+use function array_filter;
+use function array_map;
+use function chmod;
+use function file_get_contents;
+use function file_put_contents;
+use function fileatime;
+use function glob;
+use function is_dir;
+use function is_file;
+use function is_writable;
+use function mkdir;
+use function sprintf;
+use function time;
+use function unlink;
+
+use const DIRECTORY_SEPARATOR;
+use const LOCK_EX;
+
+/**
+ * Very naive concurrent region, based on file locks.
+ */
+class FileLockRegion implements ConcurrentRegion
+{
+    final public const LOCK_EXTENSION = 'lock';
+
+    /**
+     * @param numeric-string|int $lockLifetime
+     *
+     * @throws InvalidArgumentException
+     */
+    public function __construct(
+        private readonly Region $region,
+        private readonly string $directory,
+        private readonly string|int $lockLifetime,
+    ) {
+        if (! is_dir($directory) && ! @mkdir($directory, 0775, true)) {
+            throw new InvalidArgumentException(sprintf('The directory "%s" does not exist and could not be created.', $directory));
+        }
+
+        if (! is_writable($directory)) {
+            throw new InvalidArgumentException(sprintf('The directory "%s" is not writable.', $directory));
+        }
+    }
+
+    private function isLocked(CacheKey $key, Lock|null $lock = null): bool
+    {
+        $filename = $this->getLockFileName($key);
+
+        if (! is_file($filename)) {
+            return false;
+        }
+
+        $time    = $this->getLockTime($filename);
+        $content = $this->getLockContent($filename);
+
+        if ($content === false || $time === false) {
+            @unlink($filename);
+
+            return false;
+        }
+
+        if ($lock && $content === $lock->value) {
+            return false;
+        }
+
+        // outdated lock
+        if ($time + $this->lockLifetime <= time()) {
+            @unlink($filename);
+
+            return false;
+        }
+
+        return true;
+    }
+
+    private function getLockFileName(CacheKey $key): string
+    {
+        return $this->directory . DIRECTORY_SEPARATOR . $key->hash . '.' . self::LOCK_EXTENSION;
+    }
+
+    private function getLockContent(string $filename): string|false
+    {
+        return @file_get_contents($filename);
+    }
+
+    private function getLockTime(string $filename): int|false
+    {
+        return @fileatime($filename);
+    }
+
+    public function getName(): string
+    {
+        return $this->region->getName();
+    }
+
+    public function contains(CacheKey $key): bool
+    {
+        if ($this->isLocked($key)) {
+            return false;
+        }
+
+        return $this->region->contains($key);
+    }
+
+    public function get(CacheKey $key): CacheEntry|null
+    {
+        if ($this->isLocked($key)) {
+            return null;
+        }
+
+        return $this->region->get($key);
+    }
+
+    public function getMultiple(CollectionCacheEntry $collection): array|null
+    {
+        if (array_filter(array_map($this->isLocked(...), $collection->identifiers))) {
+            return null;
+        }
+
+        return $this->region->getMultiple($collection);
+    }
+
+    public function put(CacheKey $key, CacheEntry $entry, Lock|null $lock = null): bool
+    {
+        if ($this->isLocked($key, $lock)) {
+            return false;
+        }
+
+        return $this->region->put($key, $entry);
+    }
+
+    public function evict(CacheKey $key): bool
+    {
+        if ($this->isLocked($key)) {
+            @unlink($this->getLockFileName($key));
+        }
+
+        return $this->region->evict($key);
+    }
+
+    public function evictAll(): bool
+    {
+        // The check below is necessary because on some platforms glob returns false
+        // when nothing matched (even though no errors occurred)
+        $filenames = glob(sprintf('%s/*.%s', $this->directory, self::LOCK_EXTENSION)) ?: [];
+
+        foreach ($filenames as $filename) {
+            @unlink($filename);
+        }
+
+        return $this->region->evictAll();
+    }
+
+    public function lock(CacheKey $key): Lock|null
+    {
+        if ($this->isLocked($key)) {
+            return null;
+        }
+
+        $lock     = Lock::createLockRead();
+        $filename = $this->getLockFileName($key);
+
+        if (@file_put_contents($filename, $lock->value, LOCK_EX) === false) {
+            return null;
+        }
+
+        chmod($filename, 0664);
+
+        return $lock;
+    }
+
+    public function unlock(CacheKey $key, Lock $lock): bool
+    {
+        if ($this->isLocked($key, $lock)) {
+            return false;
+        }
+
+        return @unlink($this->getLockFileName($key));
+    }
+}
diff --git a/vendor/doctrine/orm/src/Cache/Region/UpdateTimestampCache.php b/vendor/doctrine/orm/src/Cache/Region/UpdateTimestampCache.php
new file mode 100644
index 0000000..aa75a90
--- /dev/null
+++ b/vendor/doctrine/orm/src/Cache/Region/UpdateTimestampCache.php
@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Cache\Region;
+
+use Doctrine\ORM\Cache\CacheKey;
+use Doctrine\ORM\Cache\TimestampCacheEntry;
+use Doctrine\ORM\Cache\TimestampRegion;
+
+/**
+ * Tracks the timestamps of the most recent updates to particular keys.
+ */
+class UpdateTimestampCache extends DefaultRegion implements TimestampRegion
+{
+    public function update(CacheKey $key): void
+    {
+        $this->put($key, new TimestampCacheEntry());
+    }
+}