README

Draggy 是一个代码开发工具和模板引擎，使用户能够创建并维护一个应用程序的功能骨架。

此处提供的安装说明是用于在现有的 Symfony2 安装上作为供应商安装 Draggy。如果您正在启动一个新项目，有一个更简单的方法，即下载一个已经捆绑了 Draggy 的 Symfony2 安装。有关详细信息，请访问 https://github.com/j-d/symfony-standard-draggy

下载该捆绑包等同于创建一个新的 Symfony2 项目，并按照以下步骤操作。

如果您想查看演示，可以在此处下载： https://github.com/j-d/draggy-demo

安装（作为现有 Symfony2 安装上的供应商）

编辑您的 composer.json 文件，并添加 draggy 作为依赖项

sudo nano composer.json

    "require-dev": {
        ...
        "jd/draggy": "dev-master"
        ...

更改 Incenteev 依赖项的版本，因为它目前（2.3）不支持在 parameters.yml 文件上添加额外参数

    "require": {
        ...
        "incenteev/composer-parameter-handler": "2.1.*@dev"
        ...

运行 composer update 以下载最近添加的依赖项

sudo composer update

将 vendor/jd/draggy/app/config/ 下的 parameters_draggy.yml.dist 文件复制到 app/config/ 作为 parameters_draggy.yml

sudo cp vendor/jd/draggy/app/config/parameters_draggy.yml.dist app/config/parameters_draggy.yml

编辑您的 parameters.yml 文件以添加对 parameters_draggy.yml 文件的导入

sudo nano app/config/parameters.yml

    imports:
        - { resource: parameters_draggy.yml }
        ...
    
    parameters:
    ...

编辑 parameters_draggy.yml 并配置模型文件名和其他参数

sudo nano app/config/parameters_draggy.yml

parameters:
    draggy.model_filename:      <your_model_name>.xml
    draggy.model_path:          %kernel.root_dir%/../doc/
    draggy.model_history_path:  %kernel.root_dir%/../doc/history/
    draggy.model_xml_extension: .xml
    draggy.autocode.src_path:   %kernel.root_dir%/../src/

创建您将要保存模型的文件夹，如果它不存在的话

mkdir doc

创建您将要保存模型历史的路径，如果它不存在的话

mkdir doc/history

给 www-data 那些文件夹写权限

sudo apt-get install acl

sudo setfacl -R  -m u:www-data:rwx -m u:`whoami`:rwx doc doc/history
sudo setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx doc doc/history

将 doc/history 添加到 .gitignore

sudo nano .gitignore

...
/doc/history/*
!.gitkeep

在 app\AppKernel.php 中注册 DraggyBundle（建议在 dev 部分添加它）

sudo nano app/AppKernel.php

if (in_array($this->getEnvironment(), array('dev', 'test'))) {
    ...
    $bundles[] = new Draggy\Bundle\DraggyBundle\DraggyBundle();
    $bundles[] = new Draggy\Bundle\MockBundle\MockBundle();
    ...

修改 routing_dev.yml 文件以添加 Draggy 路由

sudo nano app/config/routing_dev.yml

... 
_draggy:
    resource: "@DraggyBundle/Resources/config/routing.yml"
    prefix:   /_draggy/

如果您要使用默认的 Draggy 模拟模板，请将自定义的 form_div_layout.html.twig 复制到资源文件夹

mkdir app/Resources/views/Form
cp vendor/jd/draggy/src/Draggy/Bundle/MockBundle/Resources/views/Form/form_div_layout.html.twig app/Resources/views/Form/form_div_layout.html.twig

并修改您的 config.yml 文件以使用此 Twig 模板，并将 MockBundle 添加到 assetic

sudo nano app/config/config.yml

... 
twig:
    ...
    form:
        resources:
            - ':Form:form_div_layout.html.twig'
...
assetic:
    ...
    bundles:        [MockBundle]
    ...

安装 Draggy 资产

sudo php app/console assets:install --symlink

就这些了！要使用它，只需浏览到您创建的路径，例如 http://myproject.local/app_dev.php/_draggy

祝您使用 Draggy 愉快！