README

只需编写一次控制器，即可用于所有模型。

是什么？

AdminBundle 帮助您定义可重用的 动作，这些动作可以作为 路由控制器 定义为 任何 模型。

为什么？

当实现多个模型（如 CRUD 后端）的类似控制器行为时，AdminBundle 可提高您的生产力。

如何？

AdminBundle 将动作声明为抽象服务，为每个模型实例化并配置一个实例，并在 Symfony 路由器中注册相应的路由。

您只需说“我需要一个 list 的 user。”AdminBundle 就会注册一个 /users 路由，该路由运行一个配置为处理 User 模型的 ListAction 实例。

设计目标

AdminBundle 的目的是提高您的生产力，同时保持灵活性和可扩展性。

安装

在 Composer 中需要包

$ composer require elao/admin-bundle

在您的 AppKernel 中安装包

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = [
        // ...
        new Elao\Bundle\AdminBundle\ElaoAdminBundle(),
    ];
}

在您的 routing.yml 配置文件中导入路由

// app/config/routing.yml
elao_admin_bundle:
    resource: "@ElaoAdminBundle/Resources/config/routing.yml"
    prefix:   / # You can prefix all actions here

用法

使用一组动作

• HTML Actions：通过使用 Symfony 表单轻松执行 CRUD 操作。
• REST Actions：通过 REST 动作构建 API。

或者 创建您自己的动作集！

配置

在您的 config.yml 中配置一些动作

# app/config/config.yml
elao_admin:
    administrations:
        # Where 'name' is the name of the administration
        name:
            # Administration-level options (optional)
            foo: true
            # (required)
            actions:
                # Where 'alias' is the alias of the action
                alias:
                    # Where 'action_type' is a registered action type.
                    action_type:
                        # Every action has its own options

以下是一个使用 ElaoHtmlActionBundle 提供的一些动作的示例。

# app/config/config.yml
elao_admin:
    administrations:
        post: # The name of the administration (usualy, the model name)
            repository: app.repository.post # The repository to use to access the model
            actions:
                list:               # A "list" action,
                    html_list: ~    # that use default configuration for "html_list".

                create:             # A "create" action,
                    html_create:    # that use "html_create" and specify the form to use.
                        form: BlogBundle\Form\PostType

                update:             # A "update" action,
                    html_update:    # that use "html_update" and specify the form to use.
                        form: BlogBundle\Form\PostType

                read:               # A "read" action,
                    html_read: ~    # that use default configuration for "html_read".

                delete:             # A "delete" action,
                    html_delete:    # that use "html_delete" and adds a security restriction.
                        security: has_role('ROLE_ADMIN')

此配置将生成以下路由

配置详细

要获取您行政的完整详细信息和默认值，请运行

bin/console debug:config ElaoAdminBundle