xcms/modules

Laravel Module Manager

Introduction

When you work on small project, you will feel laravel default structure is enough. When your project grows up, you will think to divide your app into module where each module will contain all of it resources such as Controllers, Models, Views, Migrations, Config etc. This laravel-module-manager package will help you to manage laravel modular application easily., _(*1)

Installation

composer require mrabbani/laravel-module-manager, _(*2)

Add the module manager service provider to config/app.php file, _(*3)

Mrabbani\ModuleManager\Providers\ModuleProvider::class,, _(*4)

To create new module run the bellow command:, _(*5)

php artisan module:create name-of-your-module
php artisan module:install {module_alias_name}

If your module name is module1 the module structure will be, _(*6)

, _(*7)

Configuration

By default, all of your module will be placed inside modules directory into your application's base directory. If you want to change publish module_manager config file by, _(*8)

php artisan vendor:publish, _(*9)

Now you can change the default modules directory by changing module_directory value of config/module_manager.php file., _(*10)

Available commands

To see all module related commands run php artisan into terminal. Available commands are:, _(*11)

• php artisan module:create {alias}
• php artisan module:make:controller {alias} {ControllerName}
• php artisan module:make:controller {alias} {ControllerName} --resource
• php artisan module:make:command {alias} {CommandName}
• php artisan module:make:facade {alias} {FacadeName}
• php artisan module:make:middleware {alias} {MiddlewareName}
• php artisan module:make:migration {alias} {migration_name} --create --table=table_name
• php artisan module:make:migration {alias} {migration_name} --table=table_name
• php artisan module:make:model {alias} {ModelName}
• php artisan module:make:model {alias} {ModelName} --migration
• php artisan module:make:provider {alias} {ProviderName}
• php artisan module:make:request {alias} {RequestName}
• php artisan module:make:service {alias} {ServiceClassName}
• php artisan module:make:support {alias} {SupportClassName}
• php artisan module:migrate {alias}
• php artisan module:migrate:rollback {alias}
• php artisan module:routes
• php artisan module:install {alias}
• php artisan module:uninstall {alias}
• php artisan module:enable {alias}
• php artisan module:disable {alias}

'alias' is your module's alias name. you can find module's alias name in module.json file of module directory, _(*12)

You must install your module to activate, _(*13)

php artisan module:install {alias}, _(*14)

Loading Component

You have to load views, config and translation by following laravel package, _(*15)

Loading view

view(module_alias::view_file)

you may load the module1 module's index.blade.php view like so:, _(*16)

view('module1::index');

Loading translation

you may load the module1 module's welcome line from the messages file like so:, _(*17)

trans('module1::messages.welcome');

Loading config file

you may load the module1 module's welcome line from the messages file like so:, _(*18)

config('messages.welcome');, _(*19)

You have to merge the configurations, use the mergeConfigFrom method within your ModuleServiceProvider provider's register method:, _(*20)

public function register()
{
    $this->mergeConfigFrom(
        __DIR__.'/../../config/messages.php', 'messages'
    );
}

You should register all of your module's custom provider in ModuleServiceProvider provider's register method instead application's config/app.php file., _(*21)

Credit

WebEd, _(*22)