ViewBundle Bundle

, _(*1)

The Thruster ViewBundle Bundle. A simple addition to Symfony to provide ability to define views for simple data mappings similar to Elixir Phoenix Views., _(*2)

Install

Via Composer, _(*3)

$ composer require thruster/view-bundle

Enable Bundle, _(*4)

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Thruster\Bundle\ViewBundle(),
        // ...
    );
}

Usage

Views works similary to Symfony Controllers, all view classes should resident in Bundle/View/ folder. Some real life examples, _(*5)

View

<?php
// src/AppBundle/View/DefaultView.php

namespace AppBundle\View;

use Thruster\Bundle\ViewsBundle\View\View;
use AppBundle\Entity\User;

class DefaultView extends View
{
    public function welcome($name)
    {
        return [
            'msg' => 'Hello, ' . $name
        ];
    }

    public function me(User $user)
    {
          return [
            'name' => $user->getName(),
            'email' => $user->getEmail()
          ];
     }

     public function friend(User $friend)
     {
          $friend = $this->renderOne([$this, 'me'], $friend);
          // Also possible just $this->me($friend);

          unset($friend['email']);

          $friend['items'] = $this->renderMany('AppBundle:Item:public_view', $friend->getItems());

          return $friend;
     }

     public function friends(array $friends)
     {
          return [
              'data' => $this->renderMany([$this, 'friend'], $friends)
          ];
     }
}

Controller

<?php

namespace AppBundle\Controller;

use Thruster\Bundle\ViewsBundle\Controller\Controller;

class DefaultController extends Controller
{
    public function indexAction()
    {
        return $this->jsonView('welcome', 'guest');
    }

    public function meAction()
    {
        return $this->jsonView('AppBundle:Default:me', $this->getUser());
    }

    public function friendAction($id)
    {
        $friend = $this->getRepository('AppBundle:User')->find($id);

        $data = $this->view('AppBundle\View\DefaultView::friend', $friend);

        return new JsonReponse($data);
    }

    public function friendsAction()
    {
        $friends = $this->getRepository('AppBundle:User')->findAll();

        return $this->jsonView('friends', $friends);
    }    
}