README

使用模块来管理大型Laravel项目，模块就像一个laravel包一样，可以方便地添加或移除。

该包已在HDCMS中使用。

模块基于nwidart.com/laravel-modules和laravel-permission组件扩展了一些功能，因此需要先安装这两个组件。

laravel-modules和laravel-permission组件的功能都可以正常使用

安装组件

composer require houdunwang/laravel-module

php artisan vendor:publish --provider="Nwidart\Modules\LaravelModulesServiceProvider"

php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="migrations"

php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="config"

php artisan vendor:publish --provider="Houdunwang\Module\LaravelServiceProvider"

php artisan migrate

配置composer.json设置自动加载目录

{
  "autoload": {
    "psr-4": {
      "App\\": "app/",
      "Modules\\": "Modules/"
    }
  }
}

创建模块

以下命令是安装Admin模块

php artisan hd:module Admin

创建模块会同时执行以下操作：

生成menus.php配置文件
生成permission.php权限文件

模块配置

新建模块时系统会自动创建配置，一般情况下不需要执行以下命令生成配置文件（除非组件添加新配置功能）

php artisan hd:config Admin

文件说明

config——基础配置，用于配置模块的中文描述等信息
permission.php——权限设置
menus.php——后台管理菜单

获取配置

以下是获取Admin/config/config.php文件中的name值，支持.从深度嵌套的数组中检索值。

\HDModule::config('admin.config.name')

保存配置

function saveConfig(array $data = [], $name = 'config')

$data——配置数据
$name——配置文件

后台菜单

系统会根据模块配置文件menus.php生成后台菜单项

当menus.php文件不存在时，执行php artisan hd:config Admin系统会为模块Admin创建菜单。

获取菜单

获取系统可使用的所有菜单，以集合形式返回数据。可用于后台显示菜单列表。

\HDModule::getMenus()

权限管理

首先需要安装laravel-permission组件，安装方式在上面已经介绍。

创建权限配置

系统根据Admin模块配置文件permission.php重新生成权限，执行以下命令会创建权限配置文件。

php artisan hd:permission Admin

不指定模块时生成所有模块的权限表

php artisan hd:permission

文件存在时不会覆盖

生成的配置文件结构如下：

<?php return [
    [
        'group' => '文章管理',
        'permissions' => [
            ['title' => '添加栏目', 'name' => 'Modules\Admin\Http\Controllers\CategoryController@create', 'guard' => 'admin'],
        ],
    ],
];

name 指用于验证时的权限标识，可以使用任何字符定义。如果以控制器@方法形式定义的，在使用中间件验证时会比较容易。

获取权限配置

根据guard获取权限数据，可用于后台配置设置表单。

\HDModule::getPermissionByGuard('admin');

中间件

laravel-permission组件提供了中间件功能，但处理不够灵活并对资源控制器支持不好。所以houdunwang/laravel-module组件提供了中间件的功能扩展，你也可以使用laravel-permission中间件的所有功能。

以下都是对houdunwang/laravel-module扩展中间件的说明，laravel-permission中间件使用请查看组件手册。

使用中间件路由需要模块permission.php配置文件中的权限标识为控制器@方法形式。

配置

在app/Http/Kernel.php文件的$routeMiddleware段添加中间件

protected $routeMiddleware = [
	...
	'permission'    => \Houdunwang\Module\Middlewares\PermissionMiddleware::class,
	...
];

站长特权

配置文件config/hd_module.php文件中定义站长使用的角色。

'webmaster' => 'webmaster'

在使用中间件验证时，如果不前用户所在角色为站长角色，系统不进行验证直接放行。

普通路由

系统根据控制器方法检查是否存在权限规则，然后自动进行验证。

因此必须正确设置路由配置文件，下面是对编辑文章的权限设置

<?php
#config/permisson.php
return [
    [
        'group'       => '文章管理',
        'permissions' => [
            ['title' => '编辑管理', 'name' => 'Modules\Admin\Http\Controllers\ArticleController@edit', 'guard' => 'admin'],
        ],
    ],
];

以下是编辑文章的路由定义，必须保存Modules\Admin\Http\Controllers\ArticleController@edit规则已经在权限配置文件中定义，否则系统不验证。

Route::group([
    'middleware' => ['web', 'auth:admin'],'prefix'     => 'admin','namespace'  => 'Modules\Admin\Http\Controllers'], function () {
	Route::resource('edit_article', 'ArticleController@edit')->middleware("permission:admin");
});

上面的permission中间件的admin参数是权限guard。

资源路由

资源路由新增资源由create与store方法完成，更新资源由edit与update方法完成。权限规则只需要设置create与edit方法即可，在执行store动作时系统会自动使用create方法规则，update动作会使用create方法规则，以下是用户管理的资源控制器规则设置

<?php
#config/permisson.php
return [
    [
        'group'       => '会员管理',
        'permissions' => [
            ['title' => '会员管理', 'name' => 'Modules\Admin\Http\Controllers\UserController@index', 'guard' => 'admin'],
            ['title' => '添加会员', 'name' => 'Modules\Admin\Http\Controllers\UserController@create', 'guard' => 'admin'],
            ['title' => '编辑会员', 'name' => 'Modules\Admin\Http\Controllers\UserController@edit', 'guard' => 'admin'],
            ['title' => '删除会员', 'name' => 'Modules\Admin\Http\Controllers\UserController@destory', 'guard' => 'admin'],
            ['title' => '查看会员', 'name' => 'Modules\Admin\Http\Controllers\UserController@show', 'guard' => 'admin'],
        ],
    ],
];

资源路由中间件的使用

Route::resource('role', 'RoleController')->middleware("permission:admin,resource");

上面的permission中间件的admin参数是权限guard，中间件permission的第二个参数resource表示这是一个资源路由验证。

模块方法

获取模块对象

#$module 模块标识
\HDModule::module($module = null)

获取当前请求使用的模块名

\HDModule::currentModule()

获取模块菜单，参数为模块标识，不传参数时获取当前模块菜单

\HDModule::getMenuByModule('Admin')

验证权限如果用户是站长直接放行

\HDModule::hadPermission()

获取模块列表，参数为不需要返回的模块，不传参数获取所有模块

\HDModule::getModulesLists(['Admin','Article'])

获取模块路径

#$module——模块标识
\HDModule::getModulePath($module = null);

自动化构建

大部分业务由Controller控制器、Request请求、Model模型、View视图、Handle处理器构成，很多时间这些工作都是重复的，系统支持通过一行命令生成业务需要的大部分功能。

生成工作是根据模型和数据表完成的，因此必须先创建模型在数据库中创建模型表。

创建模型和迁移

执行以下命令系统会为Article模块创建Category模型和对应的数据迁移文件。

php artisan hd:model Category Article

执行自动化构建

首先安装组件

composer require houdunwang/laravel-autocreate

以下是根据Article模块的Category模型生成业务框架，系统同时会创建模型表单处理器，请查看https://github.com/houdunwang/laravel-autocreate学习。

php artisan hd:autocreate Modules/Article/Entities/Category.php 文章

执行以下命令会创建以下文件

创建控制器Http/Controllers/CategoryController
表单验证请求Http/Request/CategoryRequest
添加路由规则routes.php
生成模版视图

必须保存模型与数据表存在，某个文件存在时忽略这个文件继续向下执行

许可证

The Laravel framework is open-sourced software licensed under the MIT license.

hetao / hetao-module

维护者

详细信息