代码拉取完成，页面将自动刷新
通过使用模块来管理大型Laravel项目，模块就像一个laravel包非常方便的进行添加或移除。
这个包是在 nwidart.com/laravel-modules 和 laravel-permission 组件基础上扩展了一些功能，所以需要先安装laravel-module，laravel-permission这两个组件。
laravel-modules 和 laravel-permission 组件的功能都可以正常使用
laravel5 请使用：
composer require georgie/laravel-module 1.0
laravel8 请使用:
composer require georgie/laravel-module 2.0
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="Georgie\Module\LaravelServiceProvider"
配置 composer.json 设置自动加载目录
{
"autoload": {
"psr-4": {
"App\\": "app/",
"Modules\\": "Modules/"
}
}
}
配置 Kernel.php
'api' => [
\App\Http\Middleware\AcceptHeader::class,
],
下面的命令是安装 Admin 模块
php artisan g:module Admin
创建模块会同时执行以下操作：
menus.php 配置文件permission.php 权限文件新建模块时系统会自动创建配置，一般情况下不需要执行以下命令生成配置文件（除组件添加新配置功能外）
php artisan g:config Admin
文件说明
获取配置
下面是获取 Admin/config/config.php 文件中的name值，支持 . 从深度嵌套的数组中检索值。
\GModule::config('admin.config.name')
保存配置
function saveConfig(array $data = [], $name = 'config')
系统会根据模块配置文件 menus.php 生成后台菜单项
当 menus.php 文件不存在时，执行 php artisan g:config Admin 系统会为模块 Admin 创建菜单。
获取菜单
获取系统可使用的所有菜单，以集合形式返回数据。可用于后台显示菜单列表。
\GModule::getMenus()
首先需要安装 laravel-permission 组件，安装方式在上面已经介绍。
系统根据 Admin 模块配置文件 permission.php 重新生成权限，执行以下命令会创建权限配置文件。
php artisan g:permission Admin
不指定模块时生成所有模块的权限表
php artisan g:permission
文件存在时不会覆盖
生成的配置文件结构如下：
<?php return [
[
'group' => '文章管理',
'permissions' => [
['title' => '添加栏目', 'name' => 'Modules\Admin\Http\Controllers\CategoryController@create', 'guard' => 'admin'],
],
],
];
name 指用于验证时的 权限标识 ，可以使用任何字符定义。如果以 控制器@方法 形式定义的，在使用中间件验证时会比较容易。
根据 guard 获取权限数据，可用于后台配置设置表单。
\GModule::getPermissionByGuard('admin');
laravel-permission 组件提供了中间件功能，但处理不够灵活并对资源控制器支持不好。所以georgie/laravel-module 组件提供了中间件的功能扩展，你也可以使用 laravel-permission 中间件的所有功能。
以下都是对 georgie/laravel-module扩展中间件的说明，laravel-permission 中间件使用请查看组件手册。
使用中间件路由需要模块 permission.php 配置文件中的权限标识为 控制器@方法形式。
配置
在 app/Http/Kernel.php 文件的 $routeMiddleware 段添加中间件
protected $routeMiddleware = [
...
'permission' => \Georgie\Module\Middlewares\PermissionMiddleware::class,
...
];
配置文件 config/georgie_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 模块标识
\GModule::module($module = null)
获取当前请求使用的模块名
\GModule::currentModule()
获取模块菜单，参数为模块标识，不传参数时获取当前模块菜单
\GModule::getMenuByModule('Admin')
验证权限如果用户是站长直接放行
\GModule::hadPermission()
获取模块列表，参数为不需要返回的模块，不传参数获取所有模块
\GModule::getModulesLists(['Admin','Article'])
获取模块路径
#$module——模块标识
\GModule::getModulePath($module = null);
大部分业务由 Controller控制器、Request请求难、Model模型、View视图、Handle处理器构成，很多时间这些工作都是重复的，系统支持通过一行命令生成业务需要的大部功能。
生成工作是根据模型和数据表完成的，所以必须先创建模型在数据库中创建模型表。
执行以下命令系统会为 Article 模块创建 Category模型和对应的数据迁移文件。
php artisan g:model Category Article
首先安装组件
composer require georgie/laravel-autocreate
下面是根据 Article 模块的 Category 模型生成业务框架，系统同时会创建模型表单处理器，请查看 https://github.com/houdunwang/laravel-autocreate 学习。
php artisan g:autocreate Modules/Article/Entities/Category.php 文章
执行以下命令会创建下列文件
必须保存模型与数据表存在，某个文件存在时忽略这个文件继续向下执行
The Laravel framework is open-sourced software licensed under the MIT license.
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
马建仓 AI 助手
