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.
I support a number of legacy CakePHP applications, and the lack of a container or a nice way to do DI was annoying.
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]]);
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;
}
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);
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 {}
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');