Container.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Extbase\Object\Container;

class Container implements \TYPO3\CMS\Core\SingletonInterface {

    const SCOPE_PROTOTYPE = 1;
    const SCOPE_SINGLETON = 2;

    private $cache = NULL;

    private $alternativeImplementation;

    private $classInfoFactory = NULL;

    protected $instantiator = NULL;

    private $singletonInstances = array();

    private $prototypeObjectsWhichAreCurrentlyInstanciated;

    public function __construct() {
    }

    protected function getClassInfoFactory() {
        if ($this->classInfoFactory == NULL) {
            $this->classInfoFactory = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Extbase\\Object\\Container\\ClassInfoFactory');
        }
        return $this->classInfoFactory;
    }

    protected function getClassInfoCache() {
        if ($this->cache == NULL) {
            $this->cache = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Extbase\\Object\\Container\\ClassInfoCache');
        }
        return $this->cache;
    }

    protected function getInstantiator() {
        if ($this->instantiator == NULL) {
            $this->instantiator = new \Doctrine\Instantiator\Instantiator();
        }
        return $this->instantiator;
    }

    public function getInstance($className, $givenConstructorArguments = array()) {
        $this->prototypeObjectsWhichAreCurrentlyInstanciated = array();
        return $this->getInstanceInternal($className, $givenConstructorArguments);
    }

    public function getEmptyObject($className) {
        $className = $this->getImplementationClassName($className);
        $classInfo = $this->getClassInfo($className);
        $object = $this->getInstantiator()->instantiate($className);
        if ($classInfo->getIsInitializeable() && is_callable(array($object, 'initializeObject'))) {
            $object->initializeObject();
        }
        $this->injectDependencies($object, $classInfo);
        return $object;
    }

    protected function getInstanceInternal($className, $givenConstructorArguments = array()) {
        // Never instantiate with a beginning backslash, otherwise things like singletons won't work.
        if ($className[0] === '\\') {
            $className = substr($className, 1);
        }
        $className = $this->getImplementationClassName($className);
        if ($className === 'TYPO3\\CMS\\Extbase\\Object\\Container\\Container') {
            return $this;
        }
        if ($className === 'TYPO3\\CMS\\Core\\Cache\\CacheManager') {
            return \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Cache\\CacheManager');
        }
        if ($className === 'TYPO3\\CMS\\Core\\Package\\PackageManager') {
            return \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Package\\PackageManager');
        }
        $className = \TYPO3\CMS\Core\Core\ClassLoader::getClassNameForAlias($className);
        if (isset($this->singletonInstances[$className])) {
            if (count($givenConstructorArguments) > 0) {
                throw new \TYPO3\CMS\Extbase\Object\Exception('Object "' . $className . '" fetched from singleton cache, thus, explicit constructor arguments are not allowed.', 1292857934);
            }
            return $this->singletonInstances[$className];
        }
        $classInfo = $this->getClassInfo($className);
        $classIsSingleton = $classInfo->getIsSingleton();
        if (!$classIsSingleton) {
            if (array_key_exists($className, $this->prototypeObjectsWhichAreCurrentlyInstanciated) !== FALSE) {
                throw new \TYPO3\CMS\Extbase\Object\Exception\CannotBuildObjectException('Cyclic dependency in prototype object, for class "' . $className . '".', 1295611406);
            }
            $this->prototypeObjectsWhichAreCurrentlyInstanciated[$className] = TRUE;
        }
        $instance = $this->instanciateObject($classInfo, $givenConstructorArguments);
        $this->injectDependencies($instance, $classInfo);
        if ($classInfo->getIsInitializeable() && is_callable(array($instance, 'initializeObject'))) {
            $instance->initializeObject();
        }
        if (!$classIsSingleton) {
            unset($this->prototypeObjectsWhichAreCurrentlyInstanciated[$className]);
        }
        return $instance;
    }

    protected function instanciateObject(\TYPO3\CMS\Extbase\Object\Container\ClassInfo $classInfo, array $givenConstructorArguments) {
        $className = $classInfo->getClassName();
        $classIsSingleton = $classInfo->getIsSingleton();
        if ($classIsSingleton && count($givenConstructorArguments) > 0) {
            throw new \TYPO3\CMS\Extbase\Object\Exception('Object "' . $className . '" has explicit constructor arguments but is a singleton; this is not allowed.', 1292858051);
        }
        $constructorArguments = $this->getConstructorArguments($className, $classInfo, $givenConstructorArguments);
        array_unshift($constructorArguments, $className);
        $instance = call_user_func_array(array('TYPO3\\CMS\\Core\\Utility\\GeneralUtility', 'makeInstance'), $constructorArguments);
        if ($classIsSingleton) {
            $this->singletonInstances[$className] = $instance;
        }
        return $instance;
    }

    protected function injectDependencies($instance, \TYPO3\CMS\Extbase\Object\Container\ClassInfo $classInfo) {
        if (!$classInfo->hasInjectMethods() && !$classInfo->hasInjectProperties()) {
            return;
        }
        foreach ($classInfo->getInjectMethods() as $injectMethodName => $classNameToInject) {
            $instanceToInject = $this->getInstanceInternal($classNameToInject);
            if (
                $classInfo->getIsSingleton() && !$instanceToInject instanceof \TYPO3\CMS\Core\SingletonInterface
                && strpos($classNameToInject, 'TYPO3\\CMS') === FALSE
            ) {
                $this->log('The singleton "' . $classInfo->getClassName() . '" needs a prototype in "' . $injectMethodName . '". This is often a bad code smell; often you rather want to inject a singleton.', 1);
            }
            if (is_callable(array($instance, $injectMethodName))) {
                $instance->{$injectMethodName}($instanceToInject);
            }
        }
        foreach ($classInfo->getInjectProperties() as $injectPropertyName => $classNameToInject) {
            $instanceToInject = $this->getInstanceInternal($classNameToInject);
            if ($classInfo->getIsSingleton() && !$instanceToInject instanceof \TYPO3\CMS\Core\SingletonInterface) {
                $this->log('The singleton "' . $classInfo->getClassName() . '" needs a prototype in "' . $injectPropertyName . '". This is often a bad code smell; often you rather want to inject a singleton.', 1);
            }
            $propertyReflection = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Extbase\\Reflection\\PropertyReflection', $instance, $injectPropertyName);

            $propertyReflection->setAccessible(TRUE);
            $propertyReflection->setValue($instance, $instanceToInject);
        }
    }

    protected function log($message, $severity) {
        \TYPO3\CMS\Core\Utility\GeneralUtility::devLog($message, 'extbase', $severity);
    }

    public function registerImplementation($className, $alternativeClassName) {
        $this->alternativeImplementation[$className] = $alternativeClassName;
    }

    private function getConstructorArguments($className, \TYPO3\CMS\Extbase\Object\Container\ClassInfo $classInfo, array $givenConstructorArguments) {
        $parameters = array();
        $constructorArgumentInformation = $classInfo->getConstructorArguments();
        foreach ($constructorArgumentInformation as $index => $argumentInformation) {
            // Constructor argument given AND argument is a simple type OR instance of argument type
            if (array_key_exists($index, $givenConstructorArguments) && (!isset($argumentInformation['dependency']) || is_a($givenConstructorArguments[$index], $argumentInformation['dependency']))) {
                $parameter = $givenConstructorArguments[$index];
            } else {
                if (isset($argumentInformation['dependency']) && !array_key_exists('defaultValue', $argumentInformation)) {
                    $parameter = $this->getInstanceInternal($argumentInformation['dependency']);
                    if ($classInfo->getIsSingleton() && !$parameter instanceof \TYPO3\CMS\Core\SingletonInterface) {
                        $this->log('The singleton "' . $className . '" needs a prototype in the constructor. This is often a bad code smell; often you rather want to inject a singleton.', 1);
                    }
                } elseif (array_key_exists('defaultValue', $argumentInformation)) {
                    $parameter = $argumentInformation['defaultValue'];
                } else {
                    throw new \InvalidArgumentException('not a correct info array of constructor dependencies was passed!');
                }
            }
            $parameters[] = $parameter;
        }
        return $parameters;
    }

    public function getImplementationClassName($className) {
        if (isset($this->alternativeImplementation[$className])) {
            $className = $this->alternativeImplementation[$className];
        }
        if (substr($className, -9) === 'Interface') {
            $className = substr($className, 0, -9);
        }
        return $className;
    }

    private function getClassInfo($className) {
        $classNameHash = md5($className);
        $classInfo = $this->getClassInfoCache()->get($classNameHash);
        if (!$classInfo instanceof \TYPO3\CMS\Extbase\Object\Container\ClassInfo) {
            $classInfo = $this->getClassInfoFactory()->buildClassInfoFromClassName($className);
            $this->getClassInfoCache()->set($classNameHash, $classInfo);
        }
        return $classInfo;
    }

    public function isSingleton($className) {
        return $this->getClassInfo($className)->getIsSingleton();
    }

    public function isPrototype($className) {
        return !$this->isSingleton($className);
    }
}