Containers

Using Pimple

Pimple is a widely used, code-driven, dependency injection container provided as a standalone component by SensioLabs. It features:

  • combined parameter and service storage.
  • ability to define factories for specific classes.
  • lazy-loading via factories.

Pimple only supports programmatic creation at this time.

Installing and configuring Pimple

Pimple implements PSR-11 Container as of version 3.2. To use Pimple as a dependency injection container, we recommend using zendframework/zend-pimple-config, which helps you to configure the PSR-11 container. First install the package:

$ composer require zendframework/zend-pimple-config

Now, create the file config/container.php with the following contents:

<?php
use Zend\Pimple\Config\Config;
use Zend\Pimple\Config\ContainerFactory;

$config  = require __DIR__ . '/config.php';
$factory = new ContainerFactory();

return $factory(new Config($config));

For more information, please see the zend-pimple-config documentation.

Your bootstrap (typically public/index.php) will then look like this:

chdir(dirname(__DIR__));
require 'vendor/autoload.php';

$container = require 'config/container.php';
$app = $container->get(Zend\Expressive\Application::class);

require 'config/pipeline.php';
require 'config/routes.php';

$app->run();

Found a mistake or want to contribute to the documentation? Edit this page on GitHub!