README

使用 ExtJs 与 Symfony 2

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

本包旨在简化 Symfony 2 和 ExtJS 客户端框架之间的集成。它支持

• 基于服务器端实体/模型动态生成 Ext.data.Model。
• 自动集成 Ext Remoting 与 Symfony 2 控制器。
• 根据实体生成 Rest 控制器代码，支持 GET、POST、PUT、PATCH 和 DELETE。

要求

必需

• Symfony ~2.3
• JMS 序列化库 ~1.0
• Doctrine ORM 或 ODM
• Sensio 生成器 ~2.3

可选

• Rest 控制器代码生成需要 FOSRestBundle ~1.0

安装

使用 composer

$ composer require amstaffix/extjs-bundle

启用包

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new JMS\SerializerBundle\JMSSerializerBundle(),
        new \Tpg\ExtjsBundle\TpgExtjsBundle(),
    );
}

添加路由规则

# app/config/routing.yml
tpg_extjs:
  resource: "@TpgExtjsBundle/Resources/config/routing.yml"
  prefix:   /extjs

以下所有文档假设所有 ExtJs 控制器路径都以 /extjs 前缀。

配置

tpg_extjs:
    entities:
        - @AcmeDemoBundle/Entity/
        - @AcmeDemoBundle/Model/Auto
    remoting:
        bundles:
            - AcmeDemoBundle

测试运行

单元测试使用 PHPUnit 和 Jasmine JS 编写。如何运行单元测试在 .travis.yml 文件中。

模型/实体代码生成

您可能需要为该功能配置额外的路由规则。要生成 Ext.data.Model 代码，只需包含指向 generateModel.js 的脚本标签即可。

要生成配置中配置的所有实体和文档

<script type="text/javascript" src="/extjs/generateModel.js"></script>

要生成一些特定的实体

<script type="text/javascript" src="/extjs/generateModel.js?model[]=Acme.DemoBundle.Entity.Person&model[]=Test.TestBundle.Model.Book"></script>

Acme.DemoBundle.Entity.Person 和 Test.TestBundle.Model.Book 是模型的完整命名空间，只需将斜杠（/）替换为点（.）即可。

实体类必须使用 Tpg\ExtjsBundle\Annotation\Model 注释，请参阅 Tpg/ExtjsBundle/Tests/Fixtures/Test/TestBundle/Model/*.php 的示例用法。

有一个 Twig 扩展（extjs_model），可以轻松地将模型包含/加载到当前页面。

要生成和注入当前页面的 ExtJS 代码

{{ extjs_model(true, 'Acme.DemoBundle.Entity.Person', 'Test.TestBundle.Model.Book') }}

要通过脚本标签引用和加载 ExtJS 代码

{{ extjs_model(false, 'Acme.DemoBundle.Entity.Person', 'Test.TestBundle.Model.Book') }}

远程集成

您需要配置远程参数以使 ExtJs Remoting 与控制器一起工作。

要生成页面上的远程集成粘合剂，只需包含

<script type="text/javascript" src="/extjs/remoteapi.js"></script>

要使控制器动作可远程访问，您需要使用 Tpg\ExtjsBundle\Annotation\Direct 注释函数。

如果控制器参数期望 Symfony\Component\HttpFoundation\Request 对象，则您需要用单个参数调用远程 API。您需要将参数包装在数组中。

public function testRequestParamAction(Symfony\Component\HttpFoundation\Request $request) {
    $idResult = $request->query->get("id");
    $nameResult = $request->query->get("name");
}

$idResult 将包含 12，$nameResult 将包含 "EFG"。

要调用该远程 API，您需要使用。

Test.testRequestParam({"id":12, "name":"EFG"});

Rest Controller 代码生成

Rest Controller 代码生成是 Sensio 的控制器生成器的扩展。生成的控制器将扩展 FOS\RestBundle\Controller\FOSRestController 类。

您需要启用以下包。

new \JMS\SerializerBundle\JMSSerializerBundle(),
new \FOS\RestBundle\FOSRestBundle(),

您还需要确保 fos_rest 的以下配置。

fos_rest:
    service:
        serializer: tpg_extjs.serializer
    routing_loader:
        default_format: json
    param_fetcher_listener: true

生成的控制器在序列化和反序列化过程中为 JMS 序列化器上下文设置了不同的组。

• get：在 GET、POST、PUT、PATCH 动作中对单个实体进行序列化。
• list：在 GET 动作中对实体列表进行序列化。
• post：在 POST 动作中对单个实体进行反序列化。
• put：在 PUT 动作中对单个实体进行反序列化。
• patch：在 PATCH 动作中对单个实体进行反序列化。

例如，

为了为 Acme.DemoBundle.Entity.Person 实体生成一个 Rest Controller（PeopleController），

php app/console generate:rest:controller --controller AcmeDemoBundle:People --entity AcmeDemoBundle:Person

实体中的属性需要指定 JMS 类型，以便反序列化可以工作。

只需要控制器和实体选项，所有其他选项都可以留为默认值。生成器将创建/更新 2 个文件，

• Acme\DemoBundle\Controller\PeopleControler 将被生成。
• Acme\DemoBundle\Resources\config\routing.rest.yml 将被更新或创建

要将生成的 Rest Controller 包含到路由表中，只需包含

# app/config/routing.yml
acmedemo_api_rest:
  resource: "@AcemeDemoBundle/Resources/config/routing.rest.yml"
  prefix: /api
  type: rest

使用 generate:rest:controller 命令并带有 --trait 选项时，生成器将为您生成 2 个类，

• 特质控制器类
• 实际控制器类

将生成的代码和控制器上的自定义实现分开。这将允许您在不影响自定义实现的情况下重新生成控制器。

将 ExtJS Rest Proxy 连接到 Symfony 中的 Rest Controller

为了在 extjs 模型中指定 rest 代理，您需要

// in file Acme\TestBundle\Entity\Car.php
/**
 * @Extjs\Model
 * @Extjs\ModelProxy("/api/cars")
 * @ORM\Entity
 * @ORM\Table(name="car")
 */
class Car {
...