103 lines
3.9 KiB
Markdown
103 lines
3.9 KiB
Markdown
# Laravel-Modules
|
|
|
|
[](https://packagist.org/packages/nwidart/laravel-modules)
|
|
[](LICENSE.md)
|
|
[](https://scrutinizer-ci.com/g/nWidart/laravel-modules/?branch=master)
|
|
[](https://packagist.org/packages/nwidart/laravel-modules)
|
|
|
|
| **Laravel** | **laravel-modules** |
|
|
|-------------|---------------------|
|
|
| 5.4 | ^1.0 |
|
|
| 5.5 | ^2.0 |
|
|
| 5.6 | ^3.0 |
|
|
| 5.7 | ^4.0 |
|
|
| 5.8 | ^5.0 |
|
|
| 6.0 | ^6.0 |
|
|
| 7.0 | ^7.0 |
|
|
| 8.0 | ^8.0 |
|
|
| 9.0 | ^9.0 |
|
|
| 10.0 | ^10.0 |
|
|
| 11.0 | ^11.0 |
|
|
| 12.0 | ^12.0 |
|
|
|
|
`nwidart/laravel-modules` is a Laravel package created to manage your large Laravel app using modules. A Module is like a Laravel package, it has some views, controllers or models. This package is supported and tested in Laravel 11.
|
|
|
|
This package is a re-published, re-organised and maintained version of [pingpong/modules](https://github.com/pingpong-labs/modules), which isn't maintained anymore.
|
|
|
|
With one big bonus that the original package didn't have: **tests**.
|
|
|
|
## Sponsors
|
|
|
|
For those who are interested in becoming a sponsor, please visit Laravel Modules Sponsor page at **[laravelmodules.com/become-a-sponsor](https://laravelmodules.com/become-a-sponsor)**.
|
|
|
|
See the website traffic at https://app.usefathom.com/share/sdinlflk/laravel+modules
|
|
|
|
### Sponsors
|
|
|
|
<a href="https://nativephp.com/mobile"><img src="https://laravelmodules.com/images/sponsors/NativePHP-mobile-light.svg" alt="NativePHP for Mobile" title="NativePHP for Mobile" width="200"/></a>
|
|
|
|
<a href="https://dcblog.dev"><img src="https://laravelmodules.com/images/sponsors/dcblog.png" alt="David Carr" title="David Carr" width="200"/></a>
|
|
|
|
## upgrade
|
|
To upgrade to version V12 follow [Upgrade Guide](https://laravelmodules.com/docs/12/getting-started/upgrade) on official document.
|
|
|
|
## Install
|
|
|
|
To install via Composer, run:
|
|
|
|
``` bash
|
|
composer require nwidart/laravel-modules
|
|
```
|
|
|
|
The package will automatically register a service provider and alias.
|
|
|
|
Optionally, publish the package's configuration file by running:
|
|
|
|
``` bash
|
|
php artisan vendor:publish --provider="Nwidart\Modules\LaravelModulesServiceProvider"
|
|
```
|
|
|
|
### Autoloading
|
|
|
|
By default, the module classes are not loaded automatically. You can autoload your modules by adding merge-plugin to the extra section:
|
|
|
|
```json
|
|
"extra": {
|
|
"laravel": {
|
|
"dont-discover": []
|
|
},
|
|
"merge-plugin": {
|
|
"include": [
|
|
"Modules/*/composer.json"
|
|
]
|
|
}
|
|
},
|
|
```
|
|
|
|
**Tip: don't forget to run `composer dump-autoload` afterwards.**
|
|
|
|
## Documentation
|
|
|
|
You'll find installation instructions and full documentation on [https://laravelmodules.com/](https://laravelmodules.com/docs).
|
|
|
|
## Demo
|
|
|
|
You can see a demo using Laravel Breeze at https://github.com/laravel-modules-com/breeze-demo
|
|
|
|
This is a complete application using Auth, Base and Profile modules.
|
|
|
|
## Community
|
|
|
|
We also have a Discord community. [https://discord.gg/hkF7BRvRZK](https://discord.gg/hkF7BRvRZK) For quick help, ask questions in the appropriate channel.
|
|
|
|
## Credits
|
|
|
|
- [Nicolas Widart](https://github.com/nwidart)
|
|
- [David Carr](https://github.com/dcblogdev)
|
|
- [gravitano](https://github.com/gravitano)
|
|
- [All Contributors](../../contributors)
|
|
|
|
## License
|
|
|
|
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
|