Laravel Modules 项目教程

项目介绍

nwidart/laravel-modules 是一个用于管理大型 Laravel 应用程序的 Laravel 包。通过使用模块，可以将应用程序分解成更小、更易管理的组件。每个模块类似于一个 Laravel 包，包含视图、控制器和模型等。该包支持并测试于 Laravel 5 及以上版本，是 pingpong/modules 的重新发布、重新组织和维护版本。

项目快速启动

安装

首先，通过 Composer 安装 nwidart/laravel-modules：

composer require nwidart/laravel-modules

配置

安装完成后，可以发布配置文件：

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

创建模块

使用以下命令创建一个新的模块：

php artisan module:make Blog

这将生成一个名为 Blog 的模块，包含以下结构：

Modules/
├── Blog/
│   ├── Assets/
│   ├── Config/
│   ├── Console/
│   ├── Database/
│   │   ├── Migrations/
│   │   ├── Seeders/
│   ├── Entities/
│   ├── Http/
│   │   ├── Controllers/
│   │   ├── Middleware/
│   │   ├── Requests/
│   ├── Providers/
│   │   ├── BlogServiceProvider.php
│   │   ├── RouteServiceProvider.php
│   ├── Resources/
│   │   ├── assets/
│   │   ├── js/
│   │   ├── sass/
│   │   ├── lang/
│   │   ├── views/
│   ├── Routes/
│   │   ├── api.php
│   │   ├── web.php
│   ├── Repositories/

启用模块

默认情况下，模块类不会自动加载。可以通过在 composer.json 中添加 merge-plugin 来实现自动加载：

"extra": {
    "laravel": {
        "dont-discover": []
    },
    "merge-plugin": {
        "include": [
            "Modules/*/composer.json"
        ]
    }
}

然后运行：

composer dump-autoload

应用案例和最佳实践

应用案例

nwidart/laravel-modules 被广泛应用于需要高度模块化的项目中，例如 AsgardCMS。通过将应用程序分解成模块，可以更容易地进行代码组织和维护。

最佳实践

1. 模块命名：使用有意义的名称来命名模块，以便于理解和维护。
2. 模块分离：确保每个模块尽可能独立，减少模块间的依赖。
3. 版本控制：为每个模块单独进行版本控制，便于管理和升级。

典型生态项目

Laravel Breeze Demo

一个使用 Laravel Breeze 的完整应用程序示例，展示了如何使用 nwidart/laravel-modules 构建模块化应用：

Laravel Breeze Demo

社区支持

加入交流社区以获取快速帮助和交流：

交流社区

通过这些资源，可以更好地理解和应用 nwidart/laravel-modules，构建出更加模块化和可维护的 Laravel 应用程序。