README

An easy way to add a good dependency injection container to Cakephp 2 applications.

This installs League's Container, injects it into controllers, and adds it into CakeRegistry so you can access it as a singleton from anywhere else you may need it.

Why?

I support a number of legacy CakePHP applications, and the lack of a container or a nice way to do DI was annoying.

Installation

Install with composer.

composer require burriko/cake-container

Load the plugin in Config/bootstrap.php. Bootstrap needs to be set to true.

CakePlugin::loadAll(['CakeContainer' => ['bootstrap' => true]]);

Usage

Create a file at Config/container.php to contain your container config. In here you can specify anything from the League Container docs. For example, to load a service provider your config file would contain something like:

<?php
$container->addServiceProvider(new Jobsoc\ServiceProvider\DocumentManagementServiceProvider);

Check the League Container docs for more useful examples.

Change AppController so that it implements League\Container\ContainerAwareInterface and uses the League\Container\ContainerAwareTrait trait.

class AppController extends Controller implements League\Container\ContainerAwareInterface
{
    use League\Container\ContainerAwareTrait;
}

Usage within Controllers

You can access the container from within a controller by calling $this->getContainer(). So to get an instance of a class named DocumentManagement that was set up by your service provider you could do this in your controller.

$this->getContainer()->get(Jobsoc\DocumentSearch\DocumentManagement::class);

Usage within Shells

You can access the container in a shell the same way you'd use it in a controller by extending ContainerAwareShell. The easiest way to do this is to change AppShell to extend ContainerAwareShell.

<?php
App::uses('ContainerAwareShell', 'CakeContainer.Shell');

class AppShell extends ContainerAwareShell {}

Usage from other places

If you really need to use the container outside of a controller you can get an instance of it from the ClassRegistry.

ClassRegistry::getObject('container')->get('Jobsoc\DocumentSearch\DocumentManagement');