Chapters

9 Chapters | 48:01 |

01

Creating a Container in the Wild

5:44
02

Definitions: Teach the Container

4:14
03

Definition Unlocked

4:05
04

Yaml for Service Definitions

5:01
05

Parameters

3:29
06

The Container Dumper

6:04
07

How Symfony Builds the Container

6:42
08

Dependency Injection Extensions

7:08
09

Compiler Passes

5:34

> Symfony 3 > Journey to the Center of Symfony: The Dependency Injection Container

Buy Access to Course

06.

The Container Dumper

Autoplay

Keep on Learning!

If you liked what you've learned so far, dive in! Subscribe to get
access to this tutorial plus video, code and script downloads.

Start your All-Access Pass

Buy just this tutorial for $10.00

Previous Chapter

Next Chapter

With a Subscription, click any sentence in the script to jump to that part of the video!

After a container is built, you should compile it:

            Copy Code

                            Show All Lines

                        24 lines
            |
            dino_container/roar.php
        
                Show Lines

                                                    // ... lines 1 - 10
                            
            $container = new ContainerBuilder();
        
                Show Lines

                                                    // ... lines 12 - 16
                            
            $container->compile();
        
            runApp($container);
        
                Show Lines

                                                    // ... lines 19 - 24

This starts one final layer to the build process, which anyone can hook into to make final adjustments. For now, it's not doing anything - but it's really important inside the framework.

In a big project - parsing Yaml files and collecting all this service Definition stuff can start to take a lot of time. Our container is nice, but it's coming at a performance cost.

Let's see how much by adding some really basic profiling code. Up top, add a $startTime variable. And down below, figure out how much time elapsed, multiply it by 1000 to get microseconds, and while we're here, round it. And hey, let's use our container to get out the logger and debug a message about this:

            Copy Code

                            Show All Lines

                        29 lines
            |
            dino_container/roar.php
        
                Show Lines

                                                    // ... lines 1 - 8
                            
            $start = microtime(true);
        
                Show Lines

                                                    // ... lines 10 - 19
                            
            runApp($container);
        
            $elapsed = round((microtime(true) - $start) * 1000);
        
            $container->get('logger')->debug('Elapsed Time: '.$elapsed.'ms');
        
                Show Lines

                                                    // ... lines 24 - 29

So let's see how long this takes:

php dino_container/roar.php

37ms at first, but then it settles to about 19ms after running a few times. Not bad, but this is a tiny project. Just keep that 19ms number in mind.

Caching the Container

Here's the question: can we take all of this metadata about the container and cache it somehow? Absolutely - and the way it caches is incredible.

After compiling, create a new variable called $dumper and set it to a new PhpDumper object. Pass the $container to the dumper:

            Copy Code

                            Show All Lines

                        33 lines
            |
            dino_container/roar.php
        
                Show Lines

                                                    // ... lines 1 - 19
                            
            $container->compile();
        
            $dumper = new PhpDumper($container);
        
                Show Lines

                                                    // ... lines 22 - 33

This guy is an expert at taking that metadata and caching it to a file. To do that, use the good ol' fashioned file_put_contents - pass it some new file path - how about cached_container.php and for the contents, call $dumper->dump():

            Copy Code

                            Show All Lines

                        33 lines
            |
            dino_container/roar.php
        
                Show Lines

                                                    // ... lines 1 - 19
                            
            $container->compile();
        
            $dumper = new PhpDumper($container);
        
            file_put_contents(__DIR__.'/cached_container.php', $dumper->dump());
        
                Show Lines

                                                    // ... lines 23 - 33

Let's see what this does! Run the script again:

php dino_container/roar.php

Now the cached_container.php file pops into existence. And it's awesome.

The Cached Container

Oh, so many good things to see. First, notice that this dumps a PHP class that extends Container:

            Copy Code

                            Show All Lines

                        142 lines
            |
            dino_container/cached_container.php
        
                Show Lines

                                                    // ... lines 1 - 3
                            
            use Symfony\Component\DependencyInjection\Container;
        
                Show Lines

                                                    // ... lines 5 - 16
                            
            class ProjectServiceContainer extends Container
        
            {
        
                Show Lines

                                                    // ... lines 19 - 140
                            
            }

That's actually the same base class as the ContainerBuilder we've been working with, and it houses the all-important get() function that fetches out services. In other words, this ProjectServiceContainer looks and acts just like the $container we're using now.

Next, this has our two parameter values sitting on top. And if you call getParameter() to fetch one, it just uses this array:

            Copy Code

                            Show All Lines

                        142 lines
            |
            dino_container/cached_container.php
        
                Show Lines

                                                    // ... lines 1 - 16
                            
            class ProjectServiceContainer extends Container
        
            {
        
                private static $parameters = array(
        
                        'root_dir' => '/Users/weaverryan/Sites/knp/knpu-repos/symfony-journey-to-center/dino_container',
        
                        'logger_startup_message' => 'Logger just got started!!!',
        
                    );
        
                Show Lines

                                                    // ... lines 23 - 100
                            
                public function getParameter($name)
        
                {
        
                    $name = strtolower($name);
        
                    if (!(isset(self::$parameters[$name]) || array_key_exists($name, self::$parameters))) {
        
                        throw new InvalidArgumentException(sprintf('The parameter "%s" must be defined.', $name));
        
                    }
        
                    return self::$parameters[$name];
        
                }
        
                Show Lines

                                                    // ... lines 111 - 140
                            
            }

And now, the most important thing to notice: for each of our three services, there's a concrete method that's called when we ask for that service:

            Copy Code

                            Show All Lines

                        142 lines
            |
            dino_container/cached_container.php
        
                Show Lines

                                                    // ... lines 1 - 53
                            
                /**
        
                 * Gets the 'logger' service.
        
                Show Lines

                                                    // ... lines 56 - 60
                            
                 */
        
                protected function getLoggerService()
        
                {
        
                    $this->services['logger'] = $instance = new \Monolog\Logger('main', array(0 => $this->get('logger.stream_handler')));
        
                    $instance->pushHandler($this->get('logger.std_out_handler'));
        
                    $instance->debug('Logger just got started!!!');
        
                    return $instance;
        
                }
        
                Show Lines

                                                    // ... line 71
                            
                /**
        
                 * Gets the 'logger.std_out_handler' service.
        
                Show Lines

                                                    // ... lines 74 - 78
                            
                 */
        
                protected function getLogger_StdOutHandlerService()
        
                {
        
                    return $this->services['logger.std_out_handler'] = new \Monolog\Handler\StreamHandler('php://stdout');
        
                }
        
                Show Lines

                                                    // ... line 84
                            
                /**
        
                 * Gets the 'logger.stream_handler' service.
        
                Show Lines

                                                    // ... lines 87 - 91
                            
                 */
        
                protected function getLogger_StreamHandlerService()
        
                {
        
                    return $this->services['logger.stream_handler'] = new \Monolog\Handler\StreamHandler('/Users/weaverryan/Sites/knp/knpu-repos/symfony-journey-to-center/dino_container/dino.log');
        
                }
        
                Show Lines

                                                    // ... lines 97 - 142

Seriously, if you look at the get() function in the parent class, you'll find that calling $container->get('logger.std_out_logger') will ultimately execute this getLogger_StdOutLoggerService() method.

And these methods use the exact PHP code we would write to instantiate these objects directly. We pass the container Definition objects, and it dumps the raw PHP code that those represent.

This is even more incredible when you look at the getLoggerService() method:

            Copy Code

                            Show All Lines

                        142 lines
            |
            dino_container/cached_container.php
        
                Show Lines

                                                    // ... lines 1 - 61
                            
                protected function getLoggerService()
        
                {
        
                    $this->services['logger'] = $instance = new \Monolog\Logger('main', array(0 => $this->get('logger.stream_handler')));
        
                    $instance->pushHandler($this->get('logger.std_out_handler'));
        
                    $instance->debug('Logger just got started!!!');
        
                    return $instance;
        
                }
        
                Show Lines

                                                    // ... lines 71 - 142

Look closely: it creates the new Logger object, passes main and then passes an array, with a call to $this->get('logger.stream_handler') to fetch that service from itself - the container. The second arguments key in the Yaml file causes this.

Next, it has our two method calls: pushHandler() with $this->get('logger.std_out_logger') and then a call to debug(). Everything we put into those Definitions are dumped into a real PHP file that contains the raw code we would've written anyways.

So, if we use this container class directly, then fetching objects out of it could not be faster. Let's do it!

Using the Cached Container

Copy the path to the file and create a new $cachedContainer variable way up top before we even start with the ContainerBuilder. Our app now has two options: we can create the ContainerBuilder, load it up with the Definition config and then use it, OR, if that cached container is available, we can skip everything and just use it. After all. if we call get('logger') on it, it'll give us the exact same Logger.

So, if (!file_exists($cachedContainer)), then we do need to do all the building work to dump the container:

            Copy Code

                            Show All Lines

                        39 lines
            |
            dino_container/roar.php
        
                Show Lines

                                                    // ... lines 1 - 12
                            
            require __DIR__.'/../vendor/autoload.php';
        
            $cachedContainer = __DIR__.'/cached_container.php';
        
            if (!file_exists($cachedContainer)) {
        
                $container = new ContainerBuilder();
        
                $container->setParameter('root_dir', __DIR__);
        
                $loader = new YamlFileLoader($container, new FileLocator(__DIR__ . '/config'));
        
                $loader->load('services.yml');
        
                $container->compile();
        
                $dumper = new PhpDumper($container);
        
                file_put_contents(__DIR__ . '/cached_container.php', $dumper->dump());
        
            }
        
                Show Lines

                                                    // ... lines 27 - 39

But one way or another, that file eventually exists. So if we require it, we can say $container = new \ProjectServiceContainer(), which is the class name used in the cache file:

            Copy Code

                            Show All Lines

                        39 lines
            |
            dino_container/roar.php
        
                Show Lines

                                                    // ... lines 1 - 14
                            
            $cachedContainer = __DIR__.'/cached_container.php';
        
            if (!file_exists($cachedContainer)) {
        
                Show Lines

                                                    // ... lines 17 - 25
                            
            }
        
            require $cachedContainer;
        
            $container = new \ProjectServiceContainer();
        
            runApp($container);
        
                Show Lines

                                                    // ... lines 31 - 39

We're still passing this $container into runApp(), and even though it's technically a different object, it's not going to make any difference. The only thing we need to change is that runApp() is type-hinted with ContainerBuilder. Well, it turns out that what we really need is Container, which is the base class for the builder and our cached class.

So I'll change the type-hint to Container. And we can go a step further: the Container class implements an interface called ContainerInterface:

            Copy Code

                            Show All Lines

                        39 lines
            |
            dino_container/roar.php
        
                Show Lines

                                                    // ... lines 1 - 6
                            
            use Symfony\Component\DependencyInjection\ContainerInterface;
        
                Show Lines

                                                    // ... lines 8 - 34
                            
            function runApp(ContainerInterface $container)
        
            {
        
                $container->get('logger')->info('ROOOOAR');
        
            }

Ok, try out the brand new cached container!

php dino_container/roar.php

It works! And woh - check out that elapsed time: 4ms, down from 19. If you delete the cached_container.php file, the next run takes 22ms because it needs to rebuild it. Then we're right back down to 4ms. This is one reason why Symfony is able to be so fast, even in big systems.

Now that you've got the real story of how container building works, let's see how things look inside Symfony.

6 Comments

Sort By

Andrew Grudin 6 years ago

If to compare var_export ($container) before
$container->compile();
and var_export ($container) after that ,
we see a big difference. Last one became more puffy.
What technically is the sense of ->compile() ?
Is this step must be made just to prepare $container for consuming by new PhpDumper() and further dumping?

From the other hand, look, if to comment this line out:

$loader->load('services.yml');
//$container->compile();
$dumper = new PhpDumper($container);
file_put_contents(__DIR__.'/cached_container.php', $dumper->dump());
runApp($container);

and then commit in bash: php dino_container/roar.php
we get all the same nice cached_container.php file , but even quicker (24 ms versus 38ms).
Could you clarify all this for me?

1 | Reply |

weaverryan SFCASTS Andrew Grudin 6 years ago

Hi Andrew!

Wow, this is really interesting what you've done! The compile() step runs the "compiler pass" process (https://knpuniversity.com/s... - a series of functions that make final changes to the container before it's dumped. So, as you saw, you can dump it before, but you're skipping these compiler pass functions.

What do they do? Well, any bundle can add compiler passes, so it depends. But most *are* important. The most common thing a compiler pass does is process dependency injection tags. For example, if you created an event listener/subscriber by adding a service and tagging it with kernel.event_listener (or kernel.event_subscriber), that won't work until a compiler pass runs that processes that (it's called the RegisterListenersPass). If you want to see what other compiler passes are registered, they are added inside bundle classes - e.g. FrameworkBundle adds most of them to the system.

My guess is that the faster response is due to the fact that these "extra" things aren't hooked up. But, you need them :). Probably, in a large application, the difference between a compiled and non-compiled container would *still* be quite small - like the 14ms you're seeing. So, if your app takes 250ms to load, you won't notice much difference.

Anyways, very interesting detective work on this! I would not have expected a performance difference (the 14ms) of this size.

Cheers!

| Reply |

Junaid Farooq 6 years ago

Hi There,

I have one question here. If i add a new service to my services.yml after caching the container, how will that be loaded automatically while the container is already compiled and dumped and i have a check in my code to complie and dump the container only if there is no cached container.

Thanks in advance.
Cheers!

1 | Reply |

MolloKhan SFCASTS Junaid Farooq 6 years ago edited

Hey Junaid Farooq

It depends, if you are on dev environment, then you have nothing to worry about, because Symfony is smart enough to detect that you require a fresh container, but if you are on prod environment, then, after doing a change, you will have to clear the cache, so you can see your changes reflected.


php bin/console cache:clear -e prod --no-warmup
php bin/console cache:warmup -e prod

Cheers!

1 | Reply |

Junaid Farooq MolloKhan 6 years ago edited

Thanks MolloKhan

I was thinking of clearing the cache too but didnt know about this automatic behavior of Symfony in Dev Environment.

Cheers!

1 | Reply |

elkuku 4 years ago edited

I remember something about services being private by default in some changelog...
Things are good until you actually compile the container. Instead of roaring, the script screams an exception about the "logger" service or alias being removed or inlined when the container was compiled.
Setting the logger service public: true in services.yaml fixes the issue ;)

Thanks for another insight on Symfony.

| Reply |

Symfony 2

What PHP libraries does this tutorial use?

// composer.json
{
    "require": {
        "php": ">=5.3.3",
        "symfony/symfony": "2.6.x-dev", // 2.6.x-dev
        "doctrine/orm": "~2.2,>=2.2.3", // v2.4.6
        "doctrine/doctrine-bundle": "~1.2", // v1.2.0
        "twig/extensions": "~1.0", // v1.2.0
        "symfony/assetic-bundle": "~2.3", // v2.5.0
        "symfony/swiftmailer-bundle": "~2.3", // v2.3.7
        "symfony/monolog-bundle": "~2.4", // v2.6.1
        "sensio/distribution-bundle": "~3.0", // v3.0.9
        "sensio/framework-extra-bundle": "~3.0", // v3.0.3
        "incenteev/composer-parameter-handler": "~2.0", // v2.1.0
        "hautelook/alice-bundle": "~0.2" // 0.2
    },
    "require-dev": {
        "sensio/generator-bundle": "~2.3" // v2.4.0
    }
}

Previous Chapter

Next Chapter

The Container Dumper

Share this awesome video!

Keep on Learning!

Caching the Container

The Cached Container

Using the Cached Container

6 Comments

Delete comment?

What PHP libraries does this tutorial use?

Show Lines	// ... lines 1 - 10
	$container = new ContainerBuilder();
Show Lines	// ... lines 12 - 16
	$container->compile();
	runApp($container);
Show Lines	// ... lines 19 - 24

Show Lines	// ... lines 1 - 8
	$start = microtime(true);
Show Lines	// ... lines 10 - 19
	runApp($container);

	$elapsed = round((microtime(true) - $start) * 1000);
	$container->get('logger')->debug('Elapsed Time: '.$elapsed.'ms');
Show Lines	// ... lines 24 - 29

Show Lines	// ... lines 1 - 19
	$container->compile();
	$dumper = new PhpDumper($container);
Show Lines	// ... lines 22 - 33

Show Lines	// ... lines 1 - 3
	use Symfony\Component\DependencyInjection\Container;
Show Lines	// ... lines 5 - 16
	class ProjectServiceContainer extends Container
	{
Show Lines	// ... lines 19 - 140
	}

Show Lines	// ... lines 1 - 16
	class ProjectServiceContainer extends Container
	{
	private static $parameters = array(
	'root_dir' => '/Users/weaverryan/Sites/knp/knpu-repos/symfony-journey-to-center/dino_container',
	'logger_startup_message' => 'Logger just got started!!!',
	);
Show Lines	// ... lines 23 - 100
	public function getParameter($name)
	{
	$name = strtolower($name);

	if (!(isset(self::$parameters[$name]) \|\| array_key_exists($name, self::$parameters))) {
	throw new InvalidArgumentException(sprintf('The parameter "%s" must be defined.', $name));
	}

	return self::$parameters[$name];
	}
Show Lines	// ... lines 111 - 140
	}

Show Lines	// ... lines 1 - 53
	/**
	* Gets the 'logger' service.
Show Lines	// ... lines 56 - 60
	*/
	protected function getLoggerService()
	{
	$this->services['logger'] = $instance = new \Monolog\Logger('main', array(0 => $this->get('logger.stream_handler')));

	$instance->pushHandler($this->get('logger.std_out_handler'));
	$instance->debug('Logger just got started!!!');

	return $instance;
	}
Show Lines	// ... line 71
	/**
	* Gets the 'logger.std_out_handler' service.
Show Lines	// ... lines 74 - 78
	*/
	protected function getLogger_StdOutHandlerService()
	{
	return $this->services['logger.std_out_handler'] = new \Monolog\Handler\StreamHandler('php://stdout');
	}
Show Lines	// ... line 84
	/**
	* Gets the 'logger.stream_handler' service.
Show Lines	// ... lines 87 - 91
	*/
	protected function getLogger_StreamHandlerService()
	{
	return $this->services['logger.stream_handler'] = new \Monolog\Handler\StreamHandler('/Users/weaverryan/Sites/knp/knpu-repos/symfony-journey-to-center/dino_container/dino.log');
	}
Show Lines	// ... lines 97 - 142

Show Lines	// ... lines 1 - 61
	protected function getLoggerService()
	{
	$this->services['logger'] = $instance = new \Monolog\Logger('main', array(0 => $this->get('logger.stream_handler')));

	$instance->pushHandler($this->get('logger.std_out_handler'));
	$instance->debug('Logger just got started!!!');

	return $instance;
	}
Show Lines	// ... lines 71 - 142

Show Lines	// ... lines 1 - 12
	require __DIR__.'/../vendor/autoload.php';

	$cachedContainer = __DIR__.'/cached_container.php';
	if (!file_exists($cachedContainer)) {
	$container = new ContainerBuilder();
	$container->setParameter('root_dir', __DIR__);

	$loader = new YamlFileLoader($container, new FileLocator(__DIR__ . '/config'));
	$loader->load('services.yml');

	$container->compile();
	$dumper = new PhpDumper($container);
	file_put_contents(__DIR__ . '/cached_container.php', $dumper->dump());
	}
Show Lines	// ... lines 27 - 39

Show Lines	// ... lines 1 - 14
	$cachedContainer = __DIR__.'/cached_container.php';
	if (!file_exists($cachedContainer)) {
Show Lines	// ... lines 17 - 25
	}
	require $cachedContainer;
	$container = new \ProjectServiceContainer();

	runApp($container);
Show Lines	// ... lines 31 - 39

Show Lines	// ... lines 1 - 6
	use Symfony\Component\DependencyInjection\ContainerInterface;
Show Lines	// ... lines 8 - 34
	function runApp(ContainerInterface $container)
	{
	$container->get('logger')->info('ROOOOAR');
	}