Skip to content

快速入门

插件是基于EduSoho系统下可自由安装卸载掉的程序。在不影响EduSoho系统代码的情况下,可自由扩展新功能。那么如何创建插件呢,EduSoho系统提供了一组插件命令,可以对插件进行快速操作。

创建插件

创建插件的初始目录结构:

bash
app/console plugin:create Example

使用此命令会在plugins目录下创建名为Example的插件初始目录结构,参见目录结构

注册插件

注册插件:

bash
app/console plugin:register Example

注册插件,但不创建数据库:

bash
app/console plugin:register Example --without-database

开发模式下,建议使用--without-database选项。您可在执行此命令之后,使用:bin/phpmig migrate命令来创建数据库,这样数据库的变更就纳入了phpmig的管理,方便开发过程中调整数据库。
插件注册后,即可在后台->教育云->ES应用->已购项目中查看。

卸载插件

卸载插件(默认不删除数据库):

bash
app/console plugin:remove Example

卸载插件,删除数据库:

bash
app/console plugin:remove Example --with-deleting-database

卸载插件,删除数据库及插件源码目录:

bash
app/console plugin:remove Example --with-deleting-database --with-deleting-source

目录结构

如果您的插件名称为Demo那么目录结构为:

plugins/
  DemoPlugin/
    Biz/                       ----业务目录 
      Dao/
      Service/
    Controller/                ----控制层目录
    DependencyInjection
      Configuration.php
      DemoPluginExtension.php
    Migrations/                ----升级脚本目录
    Resources/             
      config
      static-dist              ----静态资源(编译后)
      static-src               ----静态资源js,less,img,font
      views                    ----视图层(twig页面)
    Scripts/                   ----安装脚本目录
      BaseInstallScript.php
      InstallScript.php
    DemoPlugin.php
    plugin.json                ----插件相关信息文件

元信息文件

即插件目录下的plugin.json

json
{
    "code": "Demo",
    "name": "演示插件",
    "description": "这是一个演示插件",
    "author": "EduSoho官方",
    "version": "1.0.0",                 
    "support_version": "8.0.0"          
}
  • version:插件版本
  • support_version: 支持EduSoho系统的版本

引导文件

即插件目录下的DemoPlugin.php

php
<?php
namespace DemoPlugin;

use Codeages\PluginBundle\System\PluginBase;

class DemoPlugin extends PluginBase
{
    /*
    public function boot()
    {
        $biz = $this->container->get('biz');
        parent::boot();
    }
    */
}
  • DemoPlugin类必须继承自Codeages\PluginBundle\System\PluginBase类。
  • 可以通复写boot()方法往biz中注入自定义服务。

Migrations 目录

该目录是多人协同开发时的脚本文件目录,方便开发时数据库的修改。可在EduSoho根目录通过命令行生成脚本文件:

bash
  bin/phpmig generate create_demo_table plugins/DemoPlugin/Migrations/
  • create_demo_table:类名,以_分隔。
  • plugins/DemoPlugin/Migrations/:插件Migrations目录路径