allow vendord

vendor/doctrine/common/src/Proxy/AbstractProxyFactory.php

@@ -0,0 +1,246 @@
+<?php
+
+namespace Doctrine\Common\Proxy;
+
+use Doctrine\Common\Proxy\Exception\InvalidArgumentException;
+use Doctrine\Common\Proxy\Exception\OutOfBoundsException;
+use Doctrine\Common\Util\ClassUtils;
+use Doctrine\Persistence\Mapping\ClassMetadata;
+use Doctrine\Persistence\Mapping\ClassMetadataFactory;
+
+use function class_exists;
+use function file_exists;
+use function filemtime;
+use function in_array;
+
+/**
+ * Abstract factory for proxy objects.
+ *
+ * @deprecated The AbstractProxyFactory class is deprecated since doctrine/common 3.5.
+ */
+abstract class AbstractProxyFactory
+{
+    /**
+     * Never autogenerate a proxy and rely that it was generated by some
+     * process before deployment.
+     */
+    public const AUTOGENERATE_NEVER = 0;
+
+    /**
+     * Always generates a new proxy in every request.
+     *
+     * This is only sane during development.
+     */
+    public const AUTOGENERATE_ALWAYS = 1;
+
+    /**
+     * Autogenerate the proxy class when the proxy file does not exist.
+     *
+     * This strategy causes a file_exists() call whenever any proxy is used the
+     * first time in a request.
+     */
+    public const AUTOGENERATE_FILE_NOT_EXISTS = 2;
+
+    /**
+     * Generate the proxy classes using eval().
+     *
+     * This strategy is only sane for development, and even then it gives me
+     * the creeps a little.
+     */
+    public const AUTOGENERATE_EVAL = 3;
+
+    /**
+     * Autogenerate the proxy class when the proxy file does not exist or
+     * when the proxied file changed.
+     *
+     * This strategy causes a file_exists() call whenever any proxy is used the
+     * first time in a request. When the proxied file is changed, the proxy will
+     * be updated.
+     */
+    public const AUTOGENERATE_FILE_NOT_EXISTS_OR_CHANGED = 4;
+
+    private const AUTOGENERATE_MODES = [
+        self::AUTOGENERATE_NEVER,
+        self::AUTOGENERATE_ALWAYS,
+        self::AUTOGENERATE_FILE_NOT_EXISTS,
+        self::AUTOGENERATE_EVAL,
+        self::AUTOGENERATE_FILE_NOT_EXISTS_OR_CHANGED,
+    ];
+
+    /** @var ClassMetadataFactory */
+    private $metadataFactory;
+
+    /** @var ProxyGenerator the proxy generator responsible for creating the proxy classes/files. */
+    private $proxyGenerator;
+
+    /** @var int Whether to automatically (re)generate proxy classes. */
+    private $autoGenerate;
+
+    /** @var ProxyDefinition[] */
+    private $definitions = [];
+
+    /**
+     * @param bool|int $autoGenerate
+     *
+     * @throws InvalidArgumentException When auto generate mode is not valid.
+     */
+    public function __construct(ProxyGenerator $proxyGenerator, ClassMetadataFactory $metadataFactory, $autoGenerate)
+    {
+        $this->proxyGenerator  = $proxyGenerator;
+        $this->metadataFactory = $metadataFactory;
+        $this->autoGenerate    = (int) $autoGenerate;
+
+        if (! in_array($this->autoGenerate, self::AUTOGENERATE_MODES, true)) {
+            throw InvalidArgumentException::invalidAutoGenerateMode($autoGenerate);
+        }
+    }
+
+    /**
+     * Gets a reference proxy instance for the entity of the given type and identified by
+     * the given identifier.
+     *
+     * @param  string       $className
+     * @param  array<mixed> $identifier
+     *
+     * @return Proxy
+     *
+     * @throws OutOfBoundsException
+     */
+    public function getProxy($className, array $identifier)
+    {
+        $definition = $this->definitions[$className] ?? $this->getProxyDefinition($className);
+        $fqcn       = $definition->proxyClassName;
+        $proxy      = new $fqcn($definition->initializer, $definition->cloner);
+
+        foreach ($definition->identifierFields as $idField) {
+            if (! isset($identifier[$idField])) {
+                throw OutOfBoundsException::missingPrimaryKeyValue($className, $idField);
+            }
+
+            $definition->reflectionFields[$idField]->setValue($proxy, $identifier[$idField]);
+        }
+
+        return $proxy;
+    }
+
+    /**
+     * Generates proxy classes for all given classes.
+     *
+     * @param ClassMetadata[] $classes  The classes (ClassMetadata instances)
+     *  for which to generate proxies.
+     * @param string          $proxyDir The target directory of the proxy classes. If not specified, the
+     *                                  directory configured on the Configuration of the EntityManager used
+     *                                  by this factory is used.
+     *
+     * @return int Number of generated proxies.
+     */
+    public function generateProxyClasses(array $classes, $proxyDir = null)
+    {
+        $generated = 0;
+
+        foreach ($classes as $class) {
+            if ($this->skipClass($class)) {
+                continue;
+            }
+
+            $proxyFileName = $this->proxyGenerator->getProxyFileName($class->getName(), $proxyDir);
+
+            $this->proxyGenerator->generateProxyClass($class, $proxyFileName);
+
+            $generated += 1;
+        }
+
+        return $generated;
+    }
+
+    /**
+     * Reset initialization/cloning logic for an un-initialized proxy
+     *
+     * @return Proxy
+     *
+     * @throws InvalidArgumentException
+     */
+    public function resetUninitializedProxy(Proxy $proxy)
+    {
+        if ($proxy->__isInitialized()) {
+            throw InvalidArgumentException::unitializedProxyExpected($proxy);
+        }
+
+        $className  = ClassUtils::getClass($proxy);
+        $definition = $this->definitions[$className] ?? $this->getProxyDefinition($className);
+
+        $proxy->__setInitializer($definition->initializer);
+        $proxy->__setCloner($definition->cloner);
+
+        return $proxy;
+    }
+
+    /**
+     * Get a proxy definition for the given class name.
+     *
+     * @param string $className
+     * @psalm-param class-string $className
+     *
+     * @return ProxyDefinition
+     */
+    private function getProxyDefinition($className)
+    {
+        $classMetadata = $this->metadataFactory->getMetadataFor($className);
+        $className     = $classMetadata->getName(); // aliases and case sensitivity
+
+        $this->definitions[$className] = $this->createProxyDefinition($className);
+        $proxyClassName                = $this->definitions[$className]->proxyClassName;
+
+        if (! class_exists($proxyClassName, false)) {
+            $fileName = $this->proxyGenerator->getProxyFileName($className);
+
+            switch ($this->autoGenerate) {
+                case self::AUTOGENERATE_NEVER:
+                    require $fileName;
+                    break;
+
+                case self::AUTOGENERATE_FILE_NOT_EXISTS:
+                    if (! file_exists($fileName)) {
+                        $this->proxyGenerator->generateProxyClass($classMetadata, $fileName);
+                    }
+
+                    require $fileName;
+                    break;
+
+                case self::AUTOGENERATE_ALWAYS:
+                    $this->proxyGenerator->generateProxyClass($classMetadata, $fileName);
+                    require $fileName;
+                    break;
+
+                case self::AUTOGENERATE_EVAL:
+                    $this->proxyGenerator->generateProxyClass($classMetadata, false);
+                    break;
+
+                case self::AUTOGENERATE_FILE_NOT_EXISTS_OR_CHANGED:
+                    if (! file_exists($fileName) || filemtime($fileName) < filemtime($classMetadata->getReflectionClass()->getFileName())) {
+                        $this->proxyGenerator->generateProxyClass($classMetadata, $fileName);
+                    }
+
+                    require $fileName;
+                    break;
+            }
+        }
+
+        return $this->definitions[$className];
+    }
+
+    /**
+     * Determine if this class should be skipped during proxy generation.
+     *
+     * @return bool
+     */
+    abstract protected function skipClass(ClassMetadata $metadata);
+
+    /**
+     * @param string $className
+     * @psalm-param class-string $className
+     *
+     * @return ProxyDefinition
+     */
+    abstract protected function createProxyDefinition($className);
+}

vendor/doctrine/common/src/Proxy/Autoloader.php

@@ -0,0 +1,100 @@
+<?php
+
+namespace Doctrine\Common\Proxy;
+
+use Closure;
+use Doctrine\Common\Proxy\Exception\InvalidArgumentException;
+
+use function call_user_func;
+use function file_exists;
+use function is_callable;
+use function ltrim;
+use function spl_autoload_register;
+use function str_replace;
+use function strlen;
+use function strpos;
+use function substr;
+
+use const DIRECTORY_SEPARATOR;
+
+/**
+ * Special Autoloader for Proxy classes, which are not PSR-0 compliant.
+ *
+ * @internal
+ * @deprecated The Autoloader class is deprecated since doctrine/common 3.5.
+ */
+class Autoloader
+{
+    /**
+     * Resolves proxy class name to a filename based on the following pattern.
+     *
+     * 1. Remove Proxy namespace from class name.
+     * 2. Remove namespace separators from remaining class name.
+     * 3. Return PHP filename from proxy-dir with the result from 2.
+     *
+     * @param string $proxyDir
+     * @param string $proxyNamespace
+     * @param string $className
+     * @psalm-param class-string $className
+     *
+     * @return string
+     *
+     * @throws InvalidArgumentException
+     */
+    public static function resolveFile($proxyDir, $proxyNamespace, $className)
+    {
+        if (strpos($className, $proxyNamespace) !== 0) {
+            throw InvalidArgumentException::notProxyClass($className, $proxyNamespace);
+        }
+
+        // remove proxy namespace from class name
+        $classNameRelativeToProxyNamespace = substr($className, strlen($proxyNamespace));
+
+        // remove namespace separators from remaining class name
+        $fileName = str_replace('\\', '', $classNameRelativeToProxyNamespace);
+
+        return $proxyDir . DIRECTORY_SEPARATOR . $fileName . '.php';
+    }
+
+    /**
+     * Registers and returns autoloader callback for the given proxy dir and namespace.
+     *
+     * @param string        $proxyDir
+     * @param string        $proxyNamespace
+     * @param callable|null $notFoundCallback Invoked when the proxy file is not found.
+     *
+     * @return Closure
+     *
+     * @throws InvalidArgumentException
+     */
+    public static function register($proxyDir, $proxyNamespace, $notFoundCallback = null)
+    {
+        $proxyNamespace = ltrim($proxyNamespace, '\\');
+
+        if ($notFoundCallback !== null && ! is_callable($notFoundCallback)) {
+            throw InvalidArgumentException::invalidClassNotFoundCallback($notFoundCallback);
+        }
+
+        $autoloader = static function ($className) use ($proxyDir, $proxyNamespace, $notFoundCallback) {
+            if ($proxyNamespace === '') {
+                return;
+            }
+
+            if (strpos($className, $proxyNamespace) !== 0) {
+                return;
+            }
+
+            $file = Autoloader::resolveFile($proxyDir, $proxyNamespace, $className);
+
+            if ($notFoundCallback && ! file_exists($file)) {
+                call_user_func($notFoundCallback, $proxyDir, $proxyNamespace, $className);
+            }
+
+            require $file;
+        };
+
+        spl_autoload_register($autoloader);
+
+        return $autoloader;
+    }
+}

vendor/doctrine/common/src/Proxy/Exception/InvalidArgumentException.php

@@ -0,0 +1,110 @@
+<?php
+
+namespace Doctrine\Common\Proxy\Exception;
+
+use Doctrine\Persistence\Proxy;
+use InvalidArgumentException as BaseInvalidArgumentException;
+
+use function get_class;
+use function gettype;
+use function is_object;
+use function sprintf;
+
+/**
+ * Proxy Invalid Argument Exception.
+ *
+ * @deprecated The InvalidArgumentException class is deprecated since doctrine/common 3.5.
+ */
+class InvalidArgumentException extends BaseInvalidArgumentException implements ProxyException
+{
+    /** @return self */
+    public static function proxyDirectoryRequired()
+    {
+        return new self('You must configure a proxy directory. See docs for details');
+    }
+
+    /**
+     * @param string $className
+     * @param string $proxyNamespace
+     * @psalm-param class-string $className
+     *
+     * @return self
+     */
+    public static function notProxyClass($className, $proxyNamespace)
+    {
+        return new self(sprintf('The class "%s" is not part of the proxy namespace "%s"', $className, $proxyNamespace));
+    }
+
+    /**
+     * @param string $name
+     *
+     * @return self
+     */
+    public static function invalidPlaceholder($name)
+    {
+        return new self(sprintf('Provided placeholder for "%s" must be either a string or a valid callable', $name));
+    }
+
+    /** @return self */
+    public static function proxyNamespaceRequired()
+    {
+        return new self('You must configure a proxy namespace');
+    }
+
+    /** @return self */
+    public static function unitializedProxyExpected(Proxy $proxy)
+    {
+        return new self(sprintf('Provided proxy of type "%s" must not be initialized.', get_class($proxy)));
+    }
+
+    /**
+     * @param mixed $callback
+     *
+     * @return self
+     */
+    public static function invalidClassNotFoundCallback($callback)
+    {
+        $type = is_object($callback) ? get_class($callback) : gettype($callback);
+
+        return new self(sprintf('Invalid \$notFoundCallback given: must be a callable, "%s" given', $type));
+    }
+
+    /**
+     * @param string $className
+     * @psalm-param class-string $className
+     *
+     * @return self
+     */
+    public static function classMustNotBeAbstract($className)
+    {
+        return new self(sprintf('Unable to create a proxy for an abstract class "%s".', $className));
+    }
+
+    /**
+     * @param string $className
+     * @psalm-param class-string $className
+     *
+     * @return self
+     */
+    public static function classMustNotBeFinal($className)
+    {
+        return new self(sprintf('Unable to create a proxy for a final class "%s".', $className));
+    }
+
+    /**
+     * @param string $className
+     * @psalm-param class-string $className
+     *
+     * @return self
+     */
+    public static function classMustNotBeReadOnly($className)
+    {
+        return new self(sprintf('Unable to create a proxy for a readonly class "%s".', $className));
+    }
+
+    /** @param mixed $value */
+    public static function invalidAutoGenerateMode($value): self
+    {
+        return new self(sprintf('Invalid auto generate mode "%s" given.', $value));
+    }
+}

vendor/doctrine/common/src/Proxy/Exception/OutOfBoundsException.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Doctrine\Common\Proxy\Exception;
+
+use OutOfBoundsException as BaseOutOfBoundsException;
+
+use function sprintf;
+
+/**
+ * Proxy Invalid Argument Exception.
+ *
+ * @deprecated The OutOfBoundsException class is deprecated since doctrine/common 3.5.
+ */
+class OutOfBoundsException extends BaseOutOfBoundsException implements ProxyException
+{
+    /**
+     * @param string $className
+     * @param string $idField
+     * @psalm-param class-string $className
+     *
+     * @return self
+     */
+    public static function missingPrimaryKeyValue($className, $idField)
+    {
+        return new self(sprintf('Missing value for primary key %s on %s', $idField, $className));
+    }
+}

vendor/doctrine/common/src/Proxy/Exception/ProxyException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Doctrine\Common\Proxy\Exception;
+
+/**
+ * Base exception interface for proxy exceptions.
+ *
+ * @deprecated The ProxyException interface is deprecated since doctrine/common 3.5.
+ */
+interface ProxyException
+{
+}

vendor/doctrine/common/src/Proxy/Exception/UnexpectedValueException.php

@@ -0,0 +1,72 @@
+<?php
+
+namespace Doctrine\Common\Proxy\Exception;
+
+use Throwable;
+use UnexpectedValueException as BaseUnexpectedValueException;
+
+use function sprintf;
+
+/**
+ * Proxy Unexpected Value Exception.
+ *
+ * @deprecated The UnexpectedValueException class is deprecated since doctrine/common 3.5.
+ */
+class UnexpectedValueException extends BaseUnexpectedValueException implements ProxyException
+{
+    /**
+     * @param string $proxyDirectory
+     *
+     * @return self
+     */
+    public static function proxyDirectoryNotWritable($proxyDirectory)
+    {
+        return new self(sprintf('Your proxy directory "%s" must be writable', $proxyDirectory));
+    }
+
+    /**
+     * @param string $className
+     * @param string $methodName
+     * @param string $parameterName
+     * @psalm-param class-string $className
+     *
+     * @return self
+     */
+    public static function invalidParameterTypeHint(
+        $className,
+        $methodName,
+        $parameterName,
+        ?Throwable $previous = null
+    ) {
+        return new self(
+            sprintf(
+                'The type hint of parameter "%s" in method "%s" in class "%s" is invalid.',
+                $parameterName,
+                $methodName,
+                $className
+            ),
+            0,
+            $previous
+        );
+    }
+
+    /**
+     * @param string $className
+     * @param string $methodName
+     * @psalm-param class-string $className
+     *
+     * @return self
+     */
+    public static function invalidReturnTypeHint($className, $methodName, ?Throwable $previous = null)
+    {
+        return new self(
+            sprintf(
+                'The return type of method "%s" in class "%s" is invalid.',
+                $methodName,
+                $className
+            ),
+            0,
+            $previous
+        );
+    }
+}

vendor/doctrine/common/src/Proxy/Proxy.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace Doctrine\Common\Proxy;
+
+use Closure;
+use Doctrine\Persistence\Proxy as BaseProxy;
+
+/**
+ * Interface for proxy classes.
+ *
+ * @deprecated The Proxy interface is deprecated since doctrine/common 3.5.
+ *
+ * @template T of object
+ * @template-extends BaseProxy<T>
+ */
+interface Proxy extends BaseProxy
+{
+    /**
+     * Marks the proxy as initialized or not.
+     *
+     * @param bool $initialized
+     *
+     * @return void
+     */
+    public function __setInitialized($initialized);
+
+    /**
+     * Sets the initializer callback to be used when initializing the proxy. That
+     * initializer should accept 3 parameters: $proxy, $method and $params. Those
+     * are respectively the proxy object that is being initialized, the method name
+     * that triggered initialization and the parameters passed to that method.
+     *
+     * @return void
+     */
+    public function __setInitializer(?Closure $initializer = null);
+
+    /**
+     * Retrieves the initializer callback used to initialize the proxy.
+     *
+     * @see __setInitializer
+     *
+     * @return Closure|null
+     */
+    public function __getInitializer();
+
+    /**
+     * Sets the callback to be used when cloning the proxy. That initializer should accept
+     * a single parameter, which is the cloned proxy instance itself.
+     *
+     * @return void
+     */
+    public function __setCloner(?Closure $cloner = null);
+
+    /**
+     * Retrieves the callback to be used when cloning the proxy.
+     *
+     * @see __setCloner
+     *
+     * @return Closure|null
+     */
+    public function __getCloner();
+
+    /**
+     * Retrieves the list of lazy loaded properties for a given proxy
+     *
+     * @return array<string, mixed> Keys are the property names, and values are the default values
+     *                              for those properties.
+     */
+    public function __getLazyProperties();
+}

vendor/doctrine/common/src/Proxy/ProxyDefinition.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Doctrine\Common\Proxy;
+
+use ReflectionProperty;
+
+/**
+ * Definition structure how to create a proxy.
+ *
+ * @deprecated The ProxyDefinition class is deprecated since doctrine/common 3.5.
+ */
+class ProxyDefinition
+{
+    /** @var string */
+    public $proxyClassName;
+
+    /** @var array<string> */
+    public $identifierFields;
+
+    /** @var ReflectionProperty[] */
+    public $reflectionFields;
+
+    /** @var callable */
+    public $initializer;
+
+    /** @var callable */
+    public $cloner;
+
+    /**
+     * @param string                            $proxyClassName
+     * @param array<string>                     $identifierFields
+     * @param array<string, ReflectionProperty> $reflectionFields
+     * @param callable                          $initializer
+     * @param callable                          $cloner
+     */
+    public function __construct($proxyClassName, array $identifierFields, array $reflectionFields, $initializer, $cloner)
+    {
+        $this->proxyClassName   = $proxyClassName;
+        $this->identifierFields = $identifierFields;
+        $this->reflectionFields = $reflectionFields;
+        $this->initializer      = $initializer;
+        $this->cloner           = $cloner;
+    }
+}