thecodingmachine / funky

src/ServiceProvider.php

<?php
declare(strict_types=1);

namespace TheCodingMachine\Funky;

use Doctrine\Common\Annotations\AnnotationReader;
use Doctrine\Common\Annotations\AnnotationRegistry;
use Interop\Container\ServiceProviderInterface;
use ReflectionClass;
use TheCodingMachine\Funky\Annotations\Extension;
use TheCodingMachine\Funky\Annotations\Factory;
use TheCodingMachine\Funky\Annotations\Tag;
use TheCodingMachine\Funky\Utils\FileSystem;

class ServiceProvider implements ServiceProviderInterface
{
    /**
     * @var ReflectionClass
     */
    private $refClass;
    /**
     * @var string
     */
    private $className;

    private static $annotationReader;


    private static function getAnnotationReader() : AnnotationReader
    {
        if (self::$annotationReader === null) {
            AnnotationRegistry::registerLoader('class_exists');

The function Doctrine\Common\Annotations\AnnotationRegistry::registerLoader() has been deprecated: this method is deprecated and will be removed in doctrine/annotations 2.0 autoloading should be deferred to the globally registered autoloader by then. For now, use @example AnnotationRegistry::registerLoader('class_exists')

            self::$annotationReader = new AnnotationReader();
        }
        return self::$annotationReader;
    }

    /**
     * @return FactoryDefinition[]
     */
    private function getFactoryDefinitions(): array
    {
        $refClass = $this->getRefClass();
        $factories = [];

        foreach ($refClass->getMethods() as $method) {
            $factoryAnnotation = self::getAnnotationReader()->getMethodAnnotation($method, Factory::class);
            if ($factoryAnnotation instanceof Factory) {
                $factories[] = new FactoryDefinition($method, $factoryAnnotation);
            }
        }

        return $factories;
    }

    /**
     * @return ExtensionDefinition[]
     */
    private function getExtensionDefinitions(): array
    {
        $refClass = $this->getRefClass();
        $extensions = [];

        foreach ($refClass->getMethods() as $method) {
            $extensionAnnotation = self::getAnnotationReader()->getMethodAnnotation($method, Extension::class);
            if ($extensionAnnotation instanceof Extension) {
                $extensions[] = new ExtensionDefinition($method, $extensionAnnotation);
            }
        }

        return $extensions;
    }

    private function init(): void
    {
        if ($this->className === null) {
            [$className, $fileName] = $this->getFileAndClassName();
            if (!file_exists($fileName) || filemtime($this->getRefClass()->getFileName()) > filemtime($fileName)) {
                $this->dumpHelper();
            }

            require_once $fileName;

            $this->className = $className;
        }
    }

    /**
     * Returns a list of all container entries registered by this service provider.
     *
     * - the key is the entry name
     * - the value is a callable that will return the entry, aka the **factory**
     *
     * Factories have the following signature:
     *        function(\Psr\Container\ContainerInterface $container)
     *
     * @return callable[]
     */
    public function getFactories()
    {
        $this->init();
        $factoriesCallable = $this->className.'::getFactories';
        return $factoriesCallable();
    }

    /**
     * Returns a list of all container entries extended by this service provider.
     *
     * - the key is the entry name
     * - the value is a callable that will return the modified entry
     *
     * Callables have the following signature:
     *        function(Psr\Container\ContainerInterface $container, $previous)
     *     or function(Psr\Container\ContainerInterface $container, $previous = null)
     *
     * About factories parameters:
     *
     * - the container (instance of `Psr\Container\ContainerInterface`)
     * - the entry to be extended. If the entry to be extended does not exist and the parameter is nullable,
     *   `null` will be passed.
     *
     * @return callable[]
     */
    public function getExtensions()
    {
        $this->init();
        $extensionsCallable = $this->className.'::getExtensions';
        return $extensionsCallable();
    }

    /**
     * Writes the helper class and returns the file path.
     *
     * @return string
     * @throws \TheCodingMachine\Funky\IoException
     */
    public function dumpHelper(): string
    {
        [$className, $tmpFile] = $this->getFileAndClassName();

        FileSystem::mkdir(dirname($tmpFile));
        $result = file_put_contents($tmpFile, $this->dumpServiceProviderHelper($className));
        if ($result === false) {
            throw IoException::cannotWriteFile($tmpFile);
        }
        return $tmpFile;
    }

    /**
     * @return string[] Returns an array with 2 items: the class name and the file name.
     */
    private function getFileAndClassName(): array
    {
        $className = $this->getClassName();

        $fileName = \ComposerLocator::getPath('thecodingmachine/funky').'/generated/'.

The method getPath() does not exist on ComposerLocator.

            str_replace('\\', '/', $className).'.php';

        return [$className, $fileName];
    }

    private function getRefClass(): ReflectionClass
    {
        if ($this->refClass === null) {
            $this->refClass = new ReflectionClass($this);
        }
        return $this->refClass;
    }

    private function getClassName(): string
    {
        $className = 'FunkyGenerated\\'.\get_class($this).'Helper';
        if ($this->getRefClass()->isAnonymous()) {
            $className = preg_replace("/[^A-Za-z0-9_\x7f-\xff ]/", '', $className);
        }
        return $className;
    }

    /**
     * Returns the code of a "service provider helper class" that contains generated factory code.
     *
     * @return string
     */
    private function dumpServiceProviderHelper(string $className): string
    {
        $slashPos = strrpos($className, '\\');
        if ($slashPos !== false) {
            $namespace = 'namespace '.substr($className, 0, $slashPos).";\n";
            $shortClassName = substr($className, $slashPos+1);
        } else {
            $namespace = null;
            $shortClassName = $className;
        }

        $factoriesArrayCode = [];
        $factories = [];
        $factoryCount = 0;

        $extensionsArrayCode = [];
        $extensions = [];
        $extensionCount = 0;

        $factoriesDefinitions = $this->getFactoryDefinitions();

        foreach ($factoriesDefinitions as $definition) {
            if ($definition->isPsrFactory()) {
                $factoriesArrayCode[] = '            '.var_export($definition->getName(), true).
                    ' => ['.var_export($definition->getReflectionMethod()->getDeclaringClass()->getName(), true).
                    ', '.var_export($definition->getReflectionMethod()->getName(), true)."],\n";
            } else {
                $factoryCount++;
                $localFactoryName = 'factory'.$factoryCount;
                $factoriesArrayCode[] = '            '.var_export($definition->getName(), true).
                    ' => [self::class, '.var_export($localFactoryName, true)."],\n";
                $factories[] = $definition->buildFactoryCode($localFactoryName);
            }
            foreach ($definition->getAliases() as $alias) {
                $factoriesArrayCode[] = '            '.var_export($alias, true).
                    ' => new Alias('.var_export($definition->getName(), true)."),\n";
            }
        }

        $extensionsDefinitions = $this->getExtensionDefinitions();

        foreach ($extensionsDefinitions as $definition) {
            $extensionCount++;
            $localExtensionName = 'extension'.$extensionCount;
            $extensionsArrayCode[] = '            '.var_export($definition->getName(), true).
                ' => [self::class, '.var_export($localExtensionName, true)."],\n";
            $extensions[] = $definition->buildExtensionCode($localExtensionName);
        }

        // Now, let's handle tags.
        // Let's build an array of tags with a list of services in it.
        $tags = [];
        foreach ($factoriesDefinitions as $factoryDefinition) {
            foreach ($factoryDefinition->getTags() as $tag) {
                $tags[$tag->getName()][] = [
                    'taggedService' => $factoryDefinition->getName(),
                    'priority' => $tag->getPriority()
                ];
            }
        }
        foreach ($extensionsDefinitions as $extensionDefinition) {
            foreach ($extensionDefinition->getTags() as $tag) {
                $tags[$tag->getName()][] = [
                    'taggedService' => $extensionDefinition->getName(),
                    'priority' => $tag->getPriority()
                ];
            }
        }

        foreach ($tags as $tagName => $taggedServices) {
            $tagMethodName = 'tag__'.$tagName;
            $tagMethodName = preg_replace("/[^A-Za-z0-9_\x7f-\xff ]/", '', $tagMethodName);

            $extensionsArrayCode[] = '            '.var_export($tagName, true).
                ' => [self::class, '.var_export($tagMethodName, true)."],\n";
            $extensions[] = $this->buildTagsCode($tagMethodName, $taggedServices);
        }

        $factoriesArrayStr = implode("\n", $factoriesArrayCode);
        $factoriesStr = implode("\n", $factories);

        $extensionsArrayStr = implode("\n", $extensionsArrayCode);
        $extensionsStr = implode("\n", $extensions);

        $code = <<<EOF
<?php
$namespace

use Interop\Container\Factories\Alias;
use Psr\Container\ContainerInterface;

final class $shortClassName
{
    public static function getFactories(): array
    {
        return [
$factoriesArrayStr
        ];
    }
    
    public static function getExtensions(): array
    {
        return [
$extensionsArrayStr
        ];
    }
    
$factoriesStr
$extensionsStr
}
EOF;

        return $code;
    }

    /**
     * @param string $tagMethodName
     * @param array[] $taggedServices
     * @return string
     */
    private function buildTagsCode(string $tagMethodName, array $taggedServices): string
    {
        $inserts = [];

        foreach ($taggedServices as $tag) {
            ['taggedService' => $taggedService, 'priority' => $priority] = $tag;
            $inserts[] = sprintf(
                '        $queue->insert($container->get(%s), %s);',
                var_export($taggedService, true),
                var_export($priority, true)
            );
        }


        return sprintf(
            <<<EOF
    public static function %s(ContainerInterface \$container, ?\SplPriorityQueue \$queue = null): \SplPriorityQueue
    {
        \$queue = \$queue ?: new \SplPriorityQueue();
%s
        return \$queue;
    }
    
EOF
            ,
            $tagMethodName,
            implode("\n", $inserts)
        );
    }
}