Download the PHP package savannabits/modular without Composer

Organize your Laravel code into Modules

This package offers you the simplest way to organize your Laravel code into modules. Each module is a separate directory that contains all the necessary files for a complete Laravel package. We have tried as much as possible to use or extend the existing laravel commands and structures to offer the same rich features that Laravel continues to ship, and make it easier to maintain the package as Laravel evolves.

Minimum Requirements

• Laravel 11 or higher
• PHP 8.2 or higher

Installation

You can install the package via composer:

Once the package is installed, run the following command to prepare your app for generation of modules:

Follow the prompts to complete the installation.

Usage

This package offers several commands which allow you to generate standard Laravel files and classes in your modules.

Module Generation

However, first you have to generate a module using the following command:

The above command will generate a directory structure similar to that of a standard laravel App, with an additional service provider to allow registration of the module. The module is generated inside the /modules directory of your project. Additionally, the command will proceed to install the module as a symlinked local package in your composer file so that it can be autoloaded. This process may also be triggered by using the command

Activating a module

Run the following command to activate a module:

This command will symlink the module to the composer file and run composer dump-autoload to make the module available to the application.

Deactivating a module

Run the following command to deactivate a module:

This command will remove the module from the composer file and run composer dump-autoload to remove the module from the application.

Generating a Controller

To generate a controller in a module, run the following command and follow the prompts:

Generating a Model

To generate a model in a module, run the following command and follow the prompts:

Generating a Migration

To generate a migration in a module, run the following command and follow the prompts:

Generating a Factory

To generate a factory in a module, run the following command and follow the prompts:

Generating a Seeder

To generate a seeder in a module, run the following command and follow the prompts:

Generating a Policy

To generate a policy in a module, run the following command and follow the prompts:

Generating a Request

To generate a request in a module, run the following command and follow the prompts:

Generating a Resource

To generate a resource in a module, run the following command and follow the prompts:

Generating a Test

To generate a test in a module, run the following command and follow the prompts:

Generating a Job

To generate a job in a module, run the following command and follow the prompts:

Generating a Console Command

To generate a console command in a module, run the following command and follow the prompts:

Generating a Provider

To generate a provider in a module, run the following command and follow the prompts:

Generating a view

To generate a view in a module, run the following command and follow the prompts:

Helpers

The package also offers a few helper functions to make it easier to work with modules.

Get all modules

To get all modules in the application, you can use the following helper function:

The above code will return a collection of instances of the Savannabits\Modular\Module class for all active modules in the app.

Get a module

To get a specific module in the application, you can use the following helper function:

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Sam Maosa
• All Contributors

License

The MIT License (MIT). Please see License File for more information.