一、安装

composer require nwidart/laravel-modules

在composer 中配置：

配置完成后执行：

composer dump-autoload

二、基本使用

创建module：

php artisan module:make Blog

会在 Modules 目录下创建出一个类似APP的目录来，创建一个干净的module可以使用 --plain 或者 -p 标记。Lang View Config 在每个module中都有独立的命名空间，例如：

三、配置文件

框架自身带有一些配置选项，首先发布配置文件：
发布配置文件 php artisan vendor:publish --provider="Nwidart\Modules\LaravelModulesServiceProvider"

Default namespace生成模块时默认的命名空间
Overwrite the generated files覆盖生成模块时使用的默认生成存根。这对于定制不同文件的输出非常有用。
Overwrite the paths覆盖包中使用的默认路径。
Scan additional folders for modules这是默认禁用的。一旦启用，包将在指定的路径数组中查找模块。
Composer file template文件模板composer
Caching如果您有许多模块，那么最好缓存这些信息(比如多个模块)。例如多个module.json文件)。
Registering custom namespace决定哪一个自定义命名空间需要使用package来注册。如果某个设置为false，package不会处理它的注册。

四、辅助方法

$path = module_path('Blog'); 获取模块路径

五、命令行工具

实用命令：

module:make 创建一个新模块
module:use 使用一个模块（这允许执行其他命令时不用输入模块名）
module:unuse 和上面相反
module:list 列出所有可用模块
module:migrate 执行某个模块的数据迁移（或者所有模块的）
php artisan module:migrate-rollback Blog 执行模块最近一次迁移的回滚
php artisan module:migrate-refresh Blog 执行模块所有回滚后执行所有迁移
php artisan module:migrate-reset Blog 执行模块所有回滚
php artisan module:seed Blog 执行模块数据填充
php artisan module:publish-migration Blog 发布迁移
php artisan module:publish-config Blog 发布配置
php artisan module:publish-translation Blog 发布语言包
php artisan module:enable Blog 开启模块
php artisan module:disable Blog 关闭模块
php artisan module:update Blog 升级模块

生成器命令：

php artisan module:make-command CreatePostCommand Blog
php artisan module:make-migration create_posts_table Blog
php artisan module:make-seed seed_fake_blog_posts Blog
php artisan module:make-controller PostsController Blog
php artisan module:make-model Post Blog （可以使用-m同步生成迁移文件）
php artisan module:make-provider BlogServiceProvider Blog
php artisan module:make-middleware CanReadPostsMiddleware Blog
php artisan module:make-mail SendWeeklyPostsEmail Blog
php artisan module:make-notification NotifyAdminOfNewComment Blog
php artisan module:make-listener NotifyUsersOfANewPost Blog
php artisan module:make-listener NotifyUsersOfANewPost Blog --event=PostWasCreated
php artisan module:make-listener NotifyUsersOfANewPost Blog --event=PostWasCreated --queued
php artisan module:make-request CreatePostRequest Blog
php artisan module:make-event BlogPostWasUpdated Blog
php artisan module:make-job JobName Blog（可以使用-sync生成同步任务）
php artisan module:route-provider Blog 为指定的模块生成给定的路由服务提供程序。
php artisan module:make-factory FactoryName Blog
php artisan module:make-policy PolicyName Blog
php artisan module:make-rule ValidationRule Blog
php artisan module:make-resource PostResource Blog
php artisan module:make-resource PostResource Blog --collection
php artisan module:make-test EloquentPostRepositoryTest Blog

六、门面方法

Module::all(); 获取所有模块
Module::getCached() 获取所有缓存的模块
Module::getOrdered(); 获取排序后的所有模块（按照module.json文件中的priority排序）
Module::scan(); 获取扫描过的模块
Module::find('name'); 查询某个模块（返回Module类）
Module::get('name');
Module::findOrFail('module-name');
Module::getScanPaths(); 获取扫描的路径
Module::toCollection(); 获取模块集合
Module::getByStatus(1); 按照状态获取模块（1可用0不可用）
Module::has('blog'); 判断模块是否存在
Module::allEnabled(); 获取所有可用模块
Module::allDisabled();
Module::count(); 统计模块数量
Module::getPath(); 获取模块路径
Module::register(); 注册模块
Module::boot(); 初始化模块
Module::collections(); 获取所有可用模块的集合
Module::getModulePath('name'); 获取某个模块路径
Module::assetPath('name'); 获取某个模块的资源路径
Module::config('composer.vendor'); 从这个包中获取配置值。
Module::getUsedStoragePath(); 获取使用的存储路径。
Module::getUsedNow(); 获取cli会话正在使用的模块。
Module::getUsed();
Module::setUsed('name'); 设置会话使用的模块
Module::asset('blog:img/logo.img'); 从某个模块获取资源路径
Module::install('nwidart/hello'); 根据给定的模块名称安装指定的模块。
Module::update('hello'); 更新指定模块的依赖项。
将宏添加到模块存储库。

Module::macro('hello', function() {
    echo "I'm a macro";
});

Module::hello(); 调用宏
Module::getRequirements('module name'); 获取依赖的其他模块

七、模块Module方法

$module = Module::find('blog');
$module->getName();
$module->getLowerName();
$module->getStudlyName();
$module->getPath(); 模块路径
$module->getExtraPath('Assets'); 模块其他路劲
$module->disable();
$module->enable();
$module->delete();
$module->getRequires(); 获取模块依赖的其他模块

八、发布模块

将模块以composer包的形式发布

创建一个模块
确保 type 属性在 composer.json 文件中申明为 laravel-module
包名必须以 -module 结尾，例如 /-module，将会被自动安装到 Module/ 目录
发布到packagist

你需要执行额外一步确保模块安装到 Modules 目录下
安装 joshbrw/laravel-module-installer 插件，它会将文件自动移动到 Modules 目录

九、发布模块资源文件

模块可以像其他包一样发布文件（创建模块时不能使用 -plain 标志）

发布配置：

发布视图：

核心部分是loadViewsFrom方法的调用

发布语言包：

如果你想使用laravel工厂，你必须在你的服务提供商中添加以下内容：

十、模块命令行指令

回顾一下创建模块命令：
php artisan module:make-command CreatePostCommand Blog

您可以使用commands为laravel方法注册命令，该方法在服务提供者类中可用。

十一、模块事件

回顾一下创建模块事件和监听器：

php artisan module:make-event BlogPostWasUpdated Blog
php artisan module:make-listener NotifyAdminOfNewPost Blog

之后需要在laravel中注册他们，有两种办法：

手动在模块的服务提供者中调用
$this->app['events']->listen(BlogPostWasUpdated::class, NotifyAdminOfNewPost::class);
在app/命名空间下为模块创建一个事件服务提供者（EventServiceProvider）包含他的所有事件

不要忘记加载此服务提供者，将其添加到module.json文件中。

Laravel 模块化开发