fys/datatable-bundle

provide datatable server side request easily

Datatable Bundle for Symfony

Datatable Bundle provides you a capabilitiy to handle Server Side Processing Datatables, _(*1)

Installation

install via composer, _(*2)

composer require fys/datatable-bundle

activate the bundle in AppKernel.php, _(*3)

$bundles = [
    ....
    new FYS\DatatableBundle\FYSDatatableBundle(),
]

Creating your first Datatable Server Side

lets say you have an entity class like this, _(*4)

<?php
// src/AppBundle/Entity/People.php

namespace AppBundle\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * People
 *
 * @ORM\Table(name="people")
 * @ORM\Entity(repositoryClass="AppBundle\Repository\PeopleRepository")
 */
class People
{
    /**
     * @var int
     *
     * @ORM\Column(name="id", type="integer")
     * @ORM\Id
     * @ORM\GeneratedValue(strategy="AUTO")
     */
    private $id;

    /**
     * @var string
     *
     * @ORM\Column(name="name", type="string", length=255)
     */
    private $name;

    /**
     * @var string
     *
     * @ORM\Column(name="address", type="string", length=255)
     */
    private $address;


    /**
     * Get id
     *
     * @return int
     */
    public function getId()
    {
        return $this->id;
    }

    /**
     * Set name
     *
     * @param string $name
     *
     * @return People
     */
    public function setName($name)
    {
        $this->name = $name;

        return $this;
    }

    /**
     * Get name
     *
     * @return string
     */
    public function getName()
    {
        return $this->name;
    }

    /**
     * Set address
     *
     * @param string $address
     *
     * @return People
     */
    public function setAddress($address)
    {
        $this->address = $address;

        return $this;
    }

    /**
     * Get address
     *
     * @return string
     */
    public function getAddress()
    {
        return $this->address;
    }
}

now, let's create some table. At this point, please make sure you already import jquery, datatable css and datatable js, _(*5)

// src/AppBundle/Resources/views/people.html.twig

Ok, now we move to the Controller, _(*6)

// src/AppBundle/Controller/DefaultController.php

use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Method;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpFoundation\JsonResponse;

class DefaultController extends Controller
{
    /**
     * @Route("/people", name="people")
     */
    public function indexAction(Request $request)
    {
        return $this->render('AppBundle::people.html.twig', array());
    }

    /**
     * @Route("/people/data", name="people_data")
     * @Method("POST")
     */
    public function peopleDataAction(Request $request)
    {
        // call the service first.
        $datatable = $this->get('fys.dt.handle_request');

        // this is where the magic starts.
        // process() method has 3 parameters that should be filled.
        // first, Request $request Symfony\Component\HttpFoundation\Request Object
        // second, String Entity Class
        // third, array $columns, the ordered lists of field in the datatable table
        $response = $datatable->process($request, 'AppBundle:People', array('name', 'address'));

        // return JsonResponse object
        return new JsonResponse($response);
    }
}

you just create your first datatable server side, _(*7)