Download the PHP package tpg/extjs-bundle without Composer

extjs-bundle

Use ExtJs with Symfony 2

Packagist: https://packagist.org/packages/amstaffix/extjs-bundle

The aim of this bundle is to ease the intergration between Symfony 2 and ExtJS client side framework. It support

• Dynamic runtime generation of Ext.data.Model based on entities/models implement on the server side.
• Auto integrate of Ext Remoting integration with Symfony 2 Controller.
• Code generation of Rest Controller per entities, support GET, POST, PUT, PATCH and DELETE.

Requirement

Mandatory

• Symfony ~2.3
• Serializer library from JMS ~1.0
• Doctrine ORM or ODM
• Generator from Sensio ~2.3

Optional

• Rest Controller code generator need FOSRestBundle ~1.0

Installation

Using composer

Enabling bundle

Add routing rules

All documentation below, we assume all ExtJs controller path is prefix with /extjs.

Configuration

Testing Run

Unit Test are written with PHPUnit and Jasmine JS. How to run unit test is in .travis.yml file.

Model/Entities Code Generation

You may need to configure the additional routing rule for this feature to work. To generate Ext.data.Model code, you just need to include script tag pointing to generateModel.js

To generate all entities and document configured in the configuration,

To generate some specific entities,

Acme.DemoBundle.Entity.Person and Test.TestBundle.Model.Book is the full namespace of the model, just replace slash () with dot (.).

The entity class must annotate with Tpg\ExtjsBundle\Annotation\Model, please check out Tpg/ExtjsBundle/Tests/Fixtures/Test/TestBundle/Model/*.php for example usage.

There is a Twig extension (extjs_model) to make it easy to include/load model onto/from the current page.

To generate and inject the ExtJS code onto the current page,

To reference and load ExtJS code through script tag,

Remoting integration

You will need to configure remoting parameter to get ExtJs Remoting working with Controller.

To generate the glue for the remoting intergation on the page, just include

To enable a controller's action remotable, you need to annotate the function with Tpg\ExtjsBundle\Annotation\Direct.

If controller parameter is expecting Symfony\Component\HttpFoundation\Request object then you need to call the remote api with only 1 parameters. You need to wrap parameters in array.

$idResult will contain 12 and $nameResult will contain "EFG".

To call that remote api, you need to use.

Code generation of Rest Controller

The rest controller code generation is an extension of Sensio's controller generator. The generated controller will extend FOS\RestBundle\Controller\FOSRestController class.

You will need to enable the following bundles.

You also need to make sure the following configuration for fos_rest.

Generated controller set different groups on JMS serializer context during serialization and deserialization process.

• get: Serialization on individual entity during GET, POST, PUT, PATCH action.
• list: Serialization on list of entity during GET action.
• post: Deserialization on individual entity during POST action.
• put: Deserialization on individual entity during PUT action.
• patch: Deserialization on individual entity during PATCH action.

For example,

To generate a rest controller (PeopleController) for entity Acme.DemoBundle.Entity.Person,

Attributes in entity need to be have JMS type specify for deserializing to work.

Only controller and entity option is require, all the rest of the option can be left as default. The generator will create/update 2 files,

• Acme\DemoBundle\Controller\PeopleControler will be generated.
• Acme\DemoBundle\Resources\config\routing.rest.yml will be updated or created

To include this generated rest controller into the routing table, just include

PHP 5.4 Trait Support Using generate:rest:controller with --trait option the generator will generate 2 class for you,

• Trait Controller Class
• Actual Controller Class

Seperating the generated code and the your custom implementation on the controller. This will allow you to regenerate the controller without affecting your custom implementation.

Connecting ExtJS Rest Proxy with Rest Controller in Symfony

To specify rest proxy in extjs model, you need