lassehaslev/laravel-modules

lassehaslev/laravel-modules

Use Package development in your local projects., _(*1)

Structure your applications functionality into modules and autoload the packages ServiceProviders., _(*2)

Install and Setup

1. Run composer require lassehaslev/laravel-modules.
2. (Not needed in laravel 5.5) Add the following line to providers in config/app.php LasseHaslev\LaravelModules\Providers\ServiceProvider::class,

3. Ok, this step is very important: Add the following to your projects composer.json. If you do not, we cannot find out where your modules are loaded from., _(*3)

   "extra": {
       ...
       "merge-plugin": {
           "include": [
               "Modules/*/composer.json"
           ],
           "recurse": true,
           "replace": false,
           "merge-dev": true,
           "merge-extra": false,
           "merge-extra-deep": false
       }
   }
   

4. Now, run php artisan modules:make-folder to create modules folder.

Discover packages

Run php artisan package:discover-modules to find all packages., _(*4)

This will discover vendor packages and package modules., _(*5)

You should replace the discover function in composer to auto update every time you run a composer command., _(*6)

"post-autoload-dump": [
    ...
    "@php artisan package:discover-modules"
]

Remember to run this command every time you create a new module., _(*7)

Create local packages

I recommend you to use LasseHaslev/laravel-package-template to get a flying start to your local package., _(*8)

Go to LasseHaslev/laravel-package-template quick package setup., _(*9)

Configuration

If you deside to change the place where your modules lives you must change path in composer.json extra.merge-plugin.include., _(*10)

You must also overwrite the config for modules Config::set( 'modules.path', base_dir( 'your/new/path' ) ), _(*11)

Development

``` bash, <sub>(*12)</sub>

Install dependencies

composer install, <sub>(*13)</sub>

Install for running automatic tests

yarn, <sub>(*14)</sub>

Make Modules folders in orcestra to make tests work

mkdir vendor/orchestra/testbench-core/laravel/Modules, <sub>(*15)</sub>

Run one time

npm run test, <sub>(*16)</sub>

Automaticly run test on changes

npm run dev ```, <sub>(*17)</sub>