README

安装

composer require bmsrox/yii2-module-autoloader

或

"bmsrox/yii2-module-autoloader":"dev-master"

使用说明

在你的应用程序中创建一个模块，并在模块根路径中添加config.php

config.php

use app\modules\admin\AdminModule;

return [
    'id' => 'admin',
    'class' => AdminModule::className(),
    'urlManagerRules' => [
        '/admin' => '/admin/default/index'
    ]
];

在你的web.php或main.php中设置组件。

'components' => [
        ...
        'moduleLoader' => [
            'class' => 'bmsrox\autoloader\ModuleLoader',
            'modules_paths' => [
                '@backend/modules', 
                '@frontend/modules', 
                '@common/modules'
                ]
        ],
        ...
 ]

PS：如果你使用的是基本模板，默认的modules_paths是@app/modules，但你可以指定任何路径。

设置引导方式

'bootstrap' => [
    ...
    'moduleLoader'
    ...
 ],

使用事件

使用事件的示例

我已经创建了一个名为SidebarMenu的事件，用于在创建新模块时动态添加菜单。

use yii\base\Component;

class SidebarMenu extends Component {

    const REGISTER = 'register';

    private $items = [];

    public function init() {
        $this->trigger(self::REGISTER);
        return parent::init();
    }

    public function setItem($item) {
        if (!isset($item['sortOrder']))
            $item['sortOrder'] = 1000;
        $this->items[] = $item;
    }

    public function getItem() {
        $this->sortItems();
        return $this->items;
    }

    /**
     * Sorts the item attribute by sortOrder
     */
    private function sortItems() {
        usort($this->items, function ($a, $b) {
            if ($a['sortOrder'] == $b['sortOrder']) {
                return 0;
            } else
            if ($a['sortOrder'] < $b['sortOrder']) {
                return - 1;
            } else {
                return 1;
            }
        });
    }

}

在你的模块根路径中创建一个名为Events的类

    use yii\base\Object;
    use yii\helpers\Html;
    
    class Events extends Object {
    
        public static function onMenuRegister($event) {
            $event->sender->setItem([
                'label' => 'example',
                'url' => ['/example/default/index'],
                'visible' => !Yii::$app->user->isGuest,
                'sortOrder' => 2
            ]);
        }
    
    }

在你的模块/config.php中，向config数组中添加一个键

    'events' => [
        ['class' => SidebarMenu::className(), 'event' => SidebarMenu::REGISTER, 'callback' => [Events::className(), 'onMenuRegister']],
    ],

调用Menu类以渲染动态菜单

        echo Menu::widget([
            'items' => (new \app\components\SidebarMenu())->getItem(),
        ]);

因此，你可以在模块中添加许多事件，它们将被自动添加。