Bundle to add MVVM capabilities to Symfony2
Bundle to add View Model capabilities to Symfony2
Requires
symfony/symfony >=2.3.0
In your project root:
composer require aequasi/view-model-bundle ~4.0.0
In your app/AppKernel.php
public function registerBundles()
{
$bundles = array(
// ...
new Aequasi\Bundle\ViewModelBundle\AequasiViewModelBundle(),
);
// ...
}
To make a view model, create a new class that implements the ViewModelInterface
.
There are some other classes in that namespace that make it easy to make your own view model. I heavily suggest extending the AbstractViewModel
.
There are also two classes in that namespace that extend the abstract class:
HtmlViewModel
- Sets a content type of text/html
and doesnt do anything fancy to build the viewJsonViewModel
- Sets a content type of application/json
and doesnt do anything fancy to build the viewExample:
<?php
namespace Acme\DemoBundle\View\Index;
use Aequasi\Bundle\ViewModelBundle\View\Model\HtmlViewModel;
class IndexViewModel extends HtmlViewModel
{
protected $template = 'AcmeDemoBundle:Index:index.html.twig';
public function buildView($data)
{
// Do some stuff with data, and then return what you want in the view
return $data; // Does this by default in the ViewModel
}
}
You don't have to follow the same namespace structure, but it allows for a cleaner structure. This view model would be the view model for the IndexController's indexAction.
Use the @ViewModel
Annotation in your action OR you can use the @ViewModelFactory
Annotation:
namespace Acme\DemoBundle\Controller;
use Aequasi\Bundle\ViewModelBundle\Annotation\ViewModel;
use Aequasi\Bundle\ViewModelBundle\Service\ViewModelService;
use Aequasi\Bundle\ViewModelBundle\Controller\ViewModelControllerInterface;
class IndexController
{
/**
* @var ViewModelService
*/
private $view;
/**
* @ViewModel("Acme\DemoBundle\View\Model\Index\IndexViewModel")
* OR
* @ViewModel("@some.service.name")
* @ViewModelFactory("@service.id", {"argumentOne", "argumentTwo"}) // You can also use a class name. The arguments are for you to decide what view model to use
*/
public function indexAction()
{
$this->view = $this->container->get('aequasi.view_model.service.view');
$this->getView()->add('someParameter', 'someValue');
return $this->getView()->render(/*$templatName, $response*/);
// You can also not return anything and it will create the response for you
// It will also let you return an array that gets set as your view parameters
return array('someParameter', 'someValue');
}
public function setView(ViewModelService $service)
{
$this->view = $service;
}
public function getView()
{
return $this->view;
}
}