mouf/mvc.silex-mouf

This project is a very simple extension to the Silex microframework. It adds Mouf dependency injection capability to Silex.

1.0.x-dev 2013-09-06 20:02 UTC

This package is auto-updated.

Last update: 2024-10-15 04:53:02 UTC


README

This project is a very simple extension to the Silex microframework. It adds Mouf dependency injection capability to Silex.

Why?

Silex is a microframework. It is designed on top of Pimple, a very simple dependency injection container (DIC) written in about 80 lines of code. Pimple is a nice DIC, but it can become quite verbose as your project grows. And natively, Silex has no way to use another DIC (the Application class of Silex extends the Pimple class).

This project lets you use Mouf, a graphical dependency injection framework directly in your Silex project. Instead of injecting your dependencies by filling the $app variable, you can use Mouf user interface to declare your instances.

How?

The extended Application class has only one additonnal method: registerMoufManager(). This is used to register the Mouf DIC instance into Silex.

When this is done, you can access any instance declared in Mouf using the $app object, just like you would in any Silex project.

Here is a sample about injecting a controller in Pimple.

  • Install this package using Composer.
  • This package depends on Mouf. Once Mouf is downloaded, you need to install Mouf.
  • Then, declare a simple test controller:
    <?php
    namespace Example\Controller;
    
    use Symfony\Component\HttpFoundation\JsonResponse;
    
    class TestController
    {
    	  private $text;
    	  public function __construct($text)
    	  {
    		  $this->text = $text;
    	  }
    
    	  public function testAction()
    	  {
    		  return new JsonResponse(array("hello"=>$this->text));
    	  }
    }
  • Create an instance mycontroller for your controller in Mouf. When this is over, you should see this in Mouf UI:
    Controller's instance
  • Init your application using the extended Mouf\Silex\Application class:
    // Load Mouf (and Composer's autoloader)
    require_once __DIR__.'/mouf/Mouf.php';
    
    // Get Silex app with Mouf support
    $app = new Mouf\Silex\Application();
    
    // Register Silex's controllers support
    $app->register(new Silex\Provider\ServiceControllerServiceProvider());
    
    // Register the Mouf DI container
    $app->registerMoufManager(Mouf\MoufManager::getMoufManager());
    
    // 'mycontroller' instance is declared in Mouf!
    $app->get('/hello', "mycontroller:testAction");
    
    $app->run();  

See how great it is? You can use the simple routing mechanism of Pimple and get rid of all the spaguetti code building your dependencies.

Known limits

This project is a proof-of-concept. It prooves that is it possible to chain 2 DI containers easily (this package contains... 10 lines of code!) It also shows the limits of this technique. Indeed, it is not possible from Mouf to refer to an object declared in Pimple (no possible round-trip). This might however become possible, should a standard about DIC interoperability become true.