2015-08-24 02:36:41 +01:00
< ? php
/*
* This file is part of the Symfony package .
*
* ( c ) Fabien Potencier < fabien @ symfony . com >
*
* For the full copyright and license information , please view the LICENSE
* file that was distributed with this source code .
*/
namespace Symfony\Component\DependencyInjection\Compiler ;
use Symfony\Component\DependencyInjection\ContainerBuilder ;
use Symfony\Component\DependencyInjection\Definition ;
use Symfony\Component\DependencyInjection\Exception\RuntimeException ;
use Symfony\Component\DependencyInjection\Reference ;
/**
* Guesses constructor arguments of services definitions and try to instantiate services if necessary .
*
* @ author Kévin Dunglas < dunglas @ gmail . com >
*/
class AutowirePass implements CompilerPassInterface
{
private $container ;
private $reflectionClasses = array ();
private $definedTypes = array ();
private $types ;
private $notGuessableTypes = array ();
/**
* { @ inheritdoc }
*/
public function process ( ContainerBuilder $container )
{
2016-04-20 13:06:08 +01:00
$throwingAutoloader = function ( $class ) { throw new \ReflectionException ( sprintf ( 'Class %s does not exist' , $class )); };
spl_autoload_register ( $throwingAutoloader );
try {
$this -> container = $container ;
foreach ( $container -> getDefinitions () as $id => $definition ) {
if ( $definition -> isAutowired ()) {
$this -> completeDefinition ( $id , $definition );
}
2015-08-24 02:36:41 +01:00
}
2016-04-20 13:06:08 +01:00
} catch ( \Exception $e ) {
2016-05-12 16:11:08 +01:00
} catch ( \Throwable $e ) {
2015-08-24 02:36:41 +01:00
}
2016-04-20 13:06:08 +01:00
spl_autoload_unregister ( $throwingAutoloader );
2015-08-24 02:36:41 +01:00
// Free memory and remove circular reference to container
$this -> container = null ;
$this -> reflectionClasses = array ();
$this -> definedTypes = array ();
$this -> types = null ;
$this -> notGuessableTypes = array ();
2016-04-20 13:06:08 +01:00
if ( isset ( $e )) {
throw $e ;
}
2015-08-24 02:36:41 +01:00
}
/**
* Wires the given definition .
*
* @ param string $id
* @ param Definition $definition
*
* @ throws RuntimeException
*/
private function completeDefinition ( $id , Definition $definition )
{
if ( ! $reflectionClass = $this -> getReflectionClass ( $id , $definition )) {
return ;
}
$this -> container -> addClassResource ( $reflectionClass );
if ( ! $constructor = $reflectionClass -> getConstructor ()) {
return ;
}
$arguments = $definition -> getArguments ();
foreach ( $constructor -> getParameters () as $index => $parameter ) {
2016-02-29 00:33:45 +00:00
if ( array_key_exists ( $index , $arguments ) && '' !== $arguments [ $index ]) {
2015-08-24 02:36:41 +01:00
continue ;
}
try {
if ( ! $typeHint = $parameter -> getClass ()) {
2016-02-22 01:17:09 +00:00
// no default value? Then fail
if ( ! $parameter -> isOptional ()) {
2016-02-29 00:33:45 +00:00
throw new RuntimeException ( sprintf ( 'Unable to autowire argument index %d ($%s) for the service "%s". If this is an object, give it a type-hint. Otherwise, specify this argument\'s value explicitly.' , $index , $parameter -> name , $id ));
2016-02-22 01:17:09 +00:00
}
// specifically pass the default value
$arguments [ $index ] = $parameter -> getDefaultValue ();
2015-08-24 02:36:41 +01:00
continue ;
}
if ( null === $this -> types ) {
$this -> populateAvailableTypes ();
}
2016-05-02 16:12:26 +01:00
if ( isset ( $this -> types [ $typeHint -> name ]) && ! isset ( $this -> notGuessableTypes [ $typeHint -> name ])) {
2015-08-24 02:36:41 +01:00
$value = new Reference ( $this -> types [ $typeHint -> name ]);
} else {
try {
$value = $this -> createAutowiredDefinition ( $typeHint , $id );
} catch ( RuntimeException $e ) {
2015-10-13 17:59:07 +01:00
if ( $parameter -> allowsNull ()) {
$value = null ;
} elseif ( $parameter -> isDefaultValueAvailable ()) {
$value = $parameter -> getDefaultValue ();
} else {
2015-08-24 02:36:41 +01:00
throw $e ;
}
}
}
2016-04-20 13:06:08 +01:00
} catch ( \ReflectionException $e ) {
2015-08-24 02:36:41 +01:00
// Typehint against a non-existing class
if ( ! $parameter -> isDefaultValueAvailable ()) {
2016-04-20 13:06:08 +01:00
throw new RuntimeException ( sprintf ( 'Cannot autowire argument %s for %s because the type-hinted class does not exist (%s).' , $index + 1 , $definition -> getClass (), $e -> getMessage ()), 0 , $e );
2015-08-24 02:36:41 +01:00
}
$value = $parameter -> getDefaultValue ();
}
2016-02-21 23:51:49 +00:00
$arguments [ $index ] = $value ;
2015-08-24 02:36:41 +01:00
}
2016-02-21 23:51:49 +00:00
// it's possible index 1 was set, then index 0, then 2, etc
// make sure that we re-order so they're injected as expected
ksort ( $arguments );
$definition -> setArguments ( $arguments );
2015-08-24 02:36:41 +01:00
}
/**
* Populates the list of available types .
*/
private function populateAvailableTypes ()
{
$this -> types = array ();
foreach ( $this -> container -> getDefinitions () as $id => $definition ) {
$this -> populateAvailableType ( $id , $definition );
}
}
/**
* Populates the list of available types for a given definition .
*
* @ param string $id
* @ param Definition $definition
*/
private function populateAvailableType ( $id , Definition $definition )
{
2015-11-04 00:40:26 +00:00
// Never use abstract services
if ( $definition -> isAbstract ()) {
return ;
}
2015-08-24 02:36:41 +01:00
foreach ( $definition -> getAutowiringTypes () as $type ) {
$this -> definedTypes [ $type ] = true ;
$this -> types [ $type ] = $id ;
}
2016-02-23 09:13:51 +00:00
if ( ! $reflectionClass = $this -> getReflectionClass ( $id , $definition )) {
2015-11-03 19:42:49 +00:00
return ;
}
2016-02-23 09:13:51 +00:00
foreach ( $reflectionClass -> getInterfaces () as $reflectionInterface ) {
$this -> set ( $reflectionInterface -> name , $id );
2015-08-24 02:36:41 +01:00
}
2016-02-23 09:13:51 +00:00
do {
$this -> set ( $reflectionClass -> name , $id );
} while ( $reflectionClass = $reflectionClass -> getParentClass ());
2015-08-24 02:36:41 +01:00
}
/**
* Associates a type and a service id if applicable .
*
* @ param string $type
* @ param string $id
*/
private function set ( $type , $id )
{
2016-05-02 16:12:26 +01:00
if ( isset ( $this -> definedTypes [ $type ])) {
2015-08-24 02:36:41 +01:00
return ;
}
2016-05-02 16:12:26 +01:00
if ( ! isset ( $this -> types [ $type ])) {
$this -> types [ $type ] = $id ;
2015-08-24 02:36:41 +01:00
2016-05-02 16:12:26 +01:00
return ;
}
2015-08-24 02:36:41 +01:00
2016-05-02 16:12:26 +01:00
if ( $this -> types [ $type ] === $id ) {
2015-08-24 02:36:41 +01:00
return ;
}
2016-05-02 16:12:26 +01:00
if ( ! isset ( $this -> notGuessableTypes [ $type ])) {
$this -> notGuessableTypes [ $type ] = true ;
$this -> types [ $type ] = ( array ) $this -> types [ $type ];
}
$this -> types [ $type ][] = $id ;
2015-08-24 02:36:41 +01:00
}
/**
* Registers a definition for the type if possible or throws an exception .
*
* @ param \ReflectionClass $typeHint
* @ param string $id
*
* @ return Reference A reference to the registered definition
*
* @ throws RuntimeException
*/
private function createAutowiredDefinition ( \ReflectionClass $typeHint , $id )
{
2016-05-02 16:12:26 +01:00
if ( isset ( $this -> notGuessableTypes [ $typeHint -> name ])) {
throw new RuntimeException ( sprintf ( 'Unable to autowire argument of type "%s" for the service "%s". Several services implementing this type have been declared: "%s".' , $typeHint -> name , $id , implode ( '", "' , $this -> types [ $typeHint -> name ])));
}
$noAvailableDefinitionMessage = sprintf ( 'Unable to autowire argument of type "%s" for the service "%s". This type cannot be instantiated automatically and no service implementing this type is declared.' , $typeHint -> name , $id );
if ( ! $typeHint -> isInstantiable ()) {
throw new RuntimeException ( $noAvailableDefinitionMessage );
2015-08-24 02:36:41 +01:00
}
$argumentId = sprintf ( 'autowired.%s' , $typeHint -> name );
$argumentDefinition = $this -> container -> register ( $argumentId , $typeHint -> name );
$argumentDefinition -> setPublic ( false );
$this -> populateAvailableType ( $argumentId , $argumentDefinition );
2016-05-02 16:12:26 +01:00
try {
$this -> completeDefinition ( $argumentId , $argumentDefinition );
} catch ( RuntimeException $e ) {
throw new RuntimeException ( $noAvailableDefinitionMessage , 0 , $e );
}
2015-08-24 02:36:41 +01:00
return new Reference ( $argumentId );
}
/**
* Retrieves the reflection class associated with the given service .
*
* @ param string $id
* @ param Definition $definition
*
2016-04-20 07:44:03 +01:00
* @ return \ReflectionClass | false
2015-08-24 02:36:41 +01:00
*/
private function getReflectionClass ( $id , Definition $definition )
{
if ( isset ( $this -> reflectionClasses [ $id ])) {
return $this -> reflectionClasses [ $id ];
}
2016-02-23 09:13:51 +00:00
// Cannot use reflection if the class isn't set
2015-08-24 02:36:41 +01:00
if ( ! $class = $definition -> getClass ()) {
2016-04-20 07:44:03 +01:00
return false ;
2015-08-24 02:36:41 +01:00
}
$class = $this -> container -> getParameterBag () -> resolveValue ( $class );
try {
2016-04-20 07:44:03 +01:00
$reflector = new \ReflectionClass ( $class );
2016-04-20 13:06:08 +01:00
} catch ( \ReflectionException $e ) {
2016-04-20 07:44:03 +01:00
$reflector = false ;
2015-08-24 02:36:41 +01:00
}
2016-04-20 07:44:03 +01:00
return $this -> reflectionClasses [ $id ] = $reflector ;
2015-08-24 02:36:41 +01:00
}
}