VERSION 0.2 doctrine ORM et entités

14 files changed, 426 insertions, 0 deletions

diff --git a/vendor/doctrine/orm/src/Event/ListenersInvoker.php b/vendor/doctrine/orm/src/Event/ListenersInvoker.php
new file mode 100644
index 0000000..c0c327e
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/ListenersInvoker.php
@@ -0,0 +1,98 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\Common\EventArgs;
+use Doctrine\Common\EventManager;
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\ORM\Mapping\ClassMetadata;
+use Doctrine\ORM\Mapping\EntityListenerResolver;
+
+/**
+ * A method invoker based on entity lifecycle.
+ */
+class ListenersInvoker
+{
+    final public const INVOKE_NONE      = 0;
+    final public const INVOKE_LISTENERS = 1;
+    final public const INVOKE_CALLBACKS = 2;
+    final public const INVOKE_MANAGER   = 4;
+
+    /** The Entity listener resolver. */
+    private readonly EntityListenerResolver $resolver;
+
+    /** The EventManager used for dispatching events. */
+    private readonly EventManager $eventManager;
+
+    public function __construct(EntityManagerInterface $em)
+    {
+        $this->eventManager = $em->getEventManager();
+        $this->resolver     = $em->getConfiguration()->getEntityListenerResolver();
+    }
+
+    /**
+     * Get the subscribed event systems
+     *
+     * @param ClassMetadata $metadata  The entity metadata.
+     * @param string        $eventName The entity lifecycle event.
+     *
+     * @psalm-return int-mask-of<self::INVOKE_*> Bitmask of subscribed event systems.
+     */
+    public function getSubscribedSystems(ClassMetadata $metadata, string $eventName): int
+    {
+        $invoke = self::INVOKE_NONE;
+
+        if (isset($metadata->lifecycleCallbacks[$eventName])) {
+            $invoke |= self::INVOKE_CALLBACKS;
+        }
+
+        if (isset($metadata->entityListeners[$eventName])) {
+            $invoke |= self::INVOKE_LISTENERS;
+        }
+
+        if ($this->eventManager->hasListeners($eventName)) {
+            $invoke |= self::INVOKE_MANAGER;
+        }
+
+        return $invoke;
+    }
+
+    /**
+     * Dispatches the lifecycle event of the given entity.
+     *
+     * @param ClassMetadata $metadata  The entity metadata.
+     * @param string        $eventName The entity lifecycle event.
+     * @param object        $entity    The Entity on which the event occurred.
+     * @param EventArgs     $event     The Event args.
+     * @psalm-param int-mask-of<self::INVOKE_*> $invoke Bitmask to invoke listeners.
+     */
+    public function invoke(
+        ClassMetadata $metadata,
+        string $eventName,
+        object $entity,
+        EventArgs $event,
+        int $invoke,
+    ): void {
+        if ($invoke & self::INVOKE_CALLBACKS) {
+            foreach ($metadata->lifecycleCallbacks[$eventName] as $callback) {
+                $entity->$callback($event);
+            }
+        }
+
+        if ($invoke & self::INVOKE_LISTENERS) {
+            foreach ($metadata->entityListeners[$eventName] as $listener) {
+                $class    = $listener['class'];
+                $method   = $listener['method'];
+                $instance = $this->resolver->resolve($class);
+
+                $instance->$method($entity, $event);
+            }
+        }
+
+        if ($invoke & self::INVOKE_MANAGER) {
+            $this->eventManager->dispatchEvent($eventName, $event);
+        }
+    }
+}
diff --git a/vendor/doctrine/orm/src/Event/LoadClassMetadataEventArgs.php b/vendor/doctrine/orm/src/Event/LoadClassMetadataEventArgs.php
new file mode 100644
index 0000000..b450616
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/LoadClassMetadataEventArgs.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\ORM\Mapping\ClassMetadata;
+use Doctrine\Persistence\Event\LoadClassMetadataEventArgs as BaseLoadClassMetadataEventArgs;
+
+/**
+ * Class that holds event arguments for a loadMetadata event.
+ *
+ * @extends BaseLoadClassMetadataEventArgs<ClassMetadata<object>, EntityManagerInterface>
+ */
+class LoadClassMetadataEventArgs extends BaseLoadClassMetadataEventArgs
+{
+    /**
+     * Retrieve associated EntityManager.
+     */
+    public function getEntityManager(): EntityManagerInterface
+    {
+        return $this->getObjectManager();
+    }
+}
diff --git a/vendor/doctrine/orm/src/Event/OnClassMetadataNotFoundEventArgs.php b/vendor/doctrine/orm/src/Event/OnClassMetadataNotFoundEventArgs.php
new file mode 100644
index 0000000..762c083
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/OnClassMetadataNotFoundEventArgs.php
@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\ManagerEventArgs;
+use Doctrine\Persistence\Mapping\ClassMetadata;
+use Doctrine\Persistence\ObjectManager;
+
+/**
+ * Class that holds event arguments for a `onClassMetadataNotFound` event.
+ *
+ * This object is mutable by design, allowing callbacks having access to it to set the
+ * found metadata in it, and therefore "cancelling" a `onClassMetadataNotFound` event
+ *
+ * @extends ManagerEventArgs<EntityManagerInterface>
+ */
+class OnClassMetadataNotFoundEventArgs extends ManagerEventArgs
+{
+    private ClassMetadata|null $foundMetadata = null;
+
+    /** @param EntityManagerInterface $objectManager */
+    public function __construct(
+        private readonly string $className,
+        ObjectManager $objectManager,
+    ) {
+        parent::__construct($objectManager);
+    }
+
+    public function setFoundMetadata(ClassMetadata|null $classMetadata): void
+    {
+        $this->foundMetadata = $classMetadata;
+    }
+
+    public function getFoundMetadata(): ClassMetadata|null
+    {
+        return $this->foundMetadata;
+    }
+
+    /**
+     * Retrieve class name for which a failed metadata fetch attempt was executed
+     */
+    public function getClassName(): string
+    {
+        return $this->className;
+    }
+}
diff --git a/vendor/doctrine/orm/src/Event/OnClearEventArgs.php b/vendor/doctrine/orm/src/Event/OnClearEventArgs.php
new file mode 100644
index 0000000..29a42f2
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/OnClearEventArgs.php
@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\OnClearEventArgs as BaseOnClearEventArgs;
+
+/**
+ * Provides event arguments for the onClear event.
+ *
+ * @link        www.doctrine-project.org
+ *
+ * @extends BaseOnClearEventArgs<EntityManagerInterface>
+ */
+class OnClearEventArgs extends BaseOnClearEventArgs
+{
+}
diff --git a/vendor/doctrine/orm/src/Event/OnFlushEventArgs.php b/vendor/doctrine/orm/src/Event/OnFlushEventArgs.php
new file mode 100644
index 0000000..b0594ca
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/OnFlushEventArgs.php
@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\ManagerEventArgs;
+
+/**
+ * Provides event arguments for the preFlush event.
+ *
+ * @link        www.doctrine-project.org
+ *
+ * @extends ManagerEventArgs<EntityManagerInterface>
+ */
+class OnFlushEventArgs extends ManagerEventArgs
+{
+}
diff --git a/vendor/doctrine/orm/src/Event/PostFlushEventArgs.php b/vendor/doctrine/orm/src/Event/PostFlushEventArgs.php
new file mode 100644
index 0000000..ca41ba8
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/PostFlushEventArgs.php
@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\ManagerEventArgs;
+
+/**
+ * Provides event arguments for the postFlush event.
+ *
+ * @link        www.doctrine-project.org
+ *
+ * @extends ManagerEventArgs<EntityManagerInterface>
+ */
+class PostFlushEventArgs extends ManagerEventArgs
+{
+}
diff --git a/vendor/doctrine/orm/src/Event/PostLoadEventArgs.php b/vendor/doctrine/orm/src/Event/PostLoadEventArgs.php
new file mode 100644
index 0000000..8344e68
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/PostLoadEventArgs.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\LifecycleEventArgs;
+
+/** @extends LifecycleEventArgs<EntityManagerInterface> */
+final class PostLoadEventArgs extends LifecycleEventArgs
+{
+}
diff --git a/vendor/doctrine/orm/src/Event/PostPersistEventArgs.php b/vendor/doctrine/orm/src/Event/PostPersistEventArgs.php
new file mode 100644
index 0000000..926ac1c
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/PostPersistEventArgs.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\LifecycleEventArgs;
+
+/** @extends LifecycleEventArgs<EntityManagerInterface> */
+final class PostPersistEventArgs extends LifecycleEventArgs
+{
+}
diff --git a/vendor/doctrine/orm/src/Event/PostRemoveEventArgs.php b/vendor/doctrine/orm/src/Event/PostRemoveEventArgs.php
new file mode 100644
index 0000000..8bf857e
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/PostRemoveEventArgs.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\LifecycleEventArgs;
+
+/** @extends LifecycleEventArgs<EntityManagerInterface> */
+final class PostRemoveEventArgs extends LifecycleEventArgs
+{
+}
diff --git a/vendor/doctrine/orm/src/Event/PostUpdateEventArgs.php b/vendor/doctrine/orm/src/Event/PostUpdateEventArgs.php
new file mode 100644
index 0000000..c9ff004
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/PostUpdateEventArgs.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\LifecycleEventArgs;
+
+/** @extends LifecycleEventArgs<EntityManagerInterface> */
+final class PostUpdateEventArgs extends LifecycleEventArgs
+{
+}
diff --git a/vendor/doctrine/orm/src/Event/PreFlushEventArgs.php b/vendor/doctrine/orm/src/Event/PreFlushEventArgs.php
new file mode 100644
index 0000000..671535c
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/PreFlushEventArgs.php
@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\ManagerEventArgs;
+
+/**
+ * Provides event arguments for the preFlush event.
+ *
+ * @link        www.doctrine-project.com
+ *
+ * @extends ManagerEventArgs<EntityManagerInterface>
+ */
+class PreFlushEventArgs extends ManagerEventArgs
+{
+}
diff --git a/vendor/doctrine/orm/src/Event/PrePersistEventArgs.php b/vendor/doctrine/orm/src/Event/PrePersistEventArgs.php
new file mode 100644
index 0000000..e70c3cf
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/PrePersistEventArgs.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\LifecycleEventArgs;
+
+/** @extends LifecycleEventArgs<EntityManagerInterface> */
+final class PrePersistEventArgs extends LifecycleEventArgs
+{
+}
diff --git a/vendor/doctrine/orm/src/Event/PreRemoveEventArgs.php b/vendor/doctrine/orm/src/Event/PreRemoveEventArgs.php
new file mode 100644
index 0000000..3af0d02
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/PreRemoveEventArgs.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\Persistence\Event\LifecycleEventArgs;
+
+/** @extends LifecycleEventArgs<EntityManagerInterface> */
+final class PreRemoveEventArgs extends LifecycleEventArgs
+{
+}
diff --git a/vendor/doctrine/orm/src/Event/PreUpdateEventArgs.php b/vendor/doctrine/orm/src/Event/PreUpdateEventArgs.php
new file mode 100644
index 0000000..090487b
--- /dev/null
+++ b/vendor/doctrine/orm/src/Event/PreUpdateEventArgs.php
@@ -0,0 +1,100 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\ORM\Event;
+
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\ORM\PersistentCollection;
+use Doctrine\Persistence\Event\LifecycleEventArgs;
+use InvalidArgumentException;
+
+use function get_debug_type;
+use function sprintf;
+
+/**
+ * Class that holds event arguments for a preUpdate event.
+ *
+ * @extends LifecycleEventArgs<EntityManagerInterface>
+ */
+class PreUpdateEventArgs extends LifecycleEventArgs
+{
+    /** @var array<string, array{mixed, mixed}|PersistentCollection> */
+    private array $entityChangeSet;
+
+    /**
+     * @param mixed[][] $changeSet
+     * @psalm-param array<string, array{mixed, mixed}|PersistentCollection> $changeSet
+     */
+    public function __construct(object $entity, EntityManagerInterface $em, array &$changeSet)
+    {
+        parent::__construct($entity, $em);
+
+        $this->entityChangeSet = &$changeSet;
+    }
+
+    /**
+     * Retrieves entity changeset.
+     *
+     * @return mixed[][]
+     * @psalm-return array<string, array{mixed, mixed}|PersistentCollection>
+     */
+    public function getEntityChangeSet(): array
+    {
+        return $this->entityChangeSet;
+    }
+
+    /**
+     * Checks if field has a changeset.
+     */
+    public function hasChangedField(string $field): bool
+    {
+        return isset($this->entityChangeSet[$field]);
+    }
+
+    /**
+     * Gets the old value of the changeset of the changed field.
+     */
+    public function getOldValue(string $field): mixed
+    {
+        $this->assertValidField($field);
+
+        return $this->entityChangeSet[$field][0];
+    }
+
+    /**
+     * Gets the new value of the changeset of the changed field.
+     */
+    public function getNewValue(string $field): mixed
+    {
+        $this->assertValidField($field);
+
+        return $this->entityChangeSet[$field][1];
+    }
+
+    /**
+     * Sets the new value of this field.
+     */
+    public function setNewValue(string $field, mixed $value): void
+    {
+        $this->assertValidField($field);
+
+        $this->entityChangeSet[$field][1] = $value;
+    }
+
+    /**
+     * Asserts the field exists in changeset.
+     *
+     * @throws InvalidArgumentException
+     */
+    private function assertValidField(string $field): void
+    {
+        if (! isset($this->entityChangeSet[$field])) {
+            throw new InvalidArgumentException(sprintf(
+                'Field "%s" is not a valid field of the entity "%s" in PreUpdateEventArgs.',
+                $field,
+                get_debug_type($this->getObject()),
+            ));
+        }
+    }
+}