Publishing File Groups
Modules and Boxes are all Laravel Service Providers. Therefore you can use all the features Laravel provides for package development.
Concord modules provide several convenience features compared to the base Laravel service providers.
One of those features is that some file groups are published by default.
Concord modules and boxes are publishing their migration, therefore they can be copied to the
application using the
artisan vendor:publish command.
php artisan vendor:publish --provider="Vendor\Module\Providers\ModuleServiceProvider" --tag="migrations"
Using this feature is useful if you want your application to control the migrations. In this case you likely need to turn off the loading of migrations on the module level.
One of such use-cases is when you're using the modules in a multi-tenant environment. Depending on the setup, the tenant migrations have to be separated from the "landlord" migrations.
Difference Between Publishing and Loading Migrations
It might be confusing, what is publishing and what is loading of migrations.
Loading is when a set of migrations are made visible for
artisan migrate command.
These migrations are available to be executed on demand. See https://laravel.com/docs/7.x/packages#migrations
Publishing is when a set of files (eg. migrations) are made visible for the
artisan vendor:publish command. These files can be copied to your application's migrations
folder. See https://laravel.com/docs/7.x/packages#publishing-file-groups
The main differences are:
- If the module loads the migrations, they are ran from the module's own folder.
- If migrations are loaded by the module, newly added migrations are immediately visible for the app.
- If migrations are copied, the files are copied from the module's folder to the app's folder.
- If migrations are copied, the newer migrations added by the module will only be copied if you run the
- If migrations are both copied and loaded, then the migrations will be duplicated and face a conflict.
Differences Between Modules and Boxes
Modules are "solo", therefore they only publish their very own migrations.
Boxes are meant to integrate several submodules, therefore you have 2 options:
- Publish box's own migrations along with the migrations of all submodules (default)
php artisan vendor:publish --provider="Vendor\Box\Providers\ModuleServiceProvider" --tag="migrations"
- Publish box's own migrations only. To do so, use the tag "own-migrations-only":
php artisan vendor:publish --provider="Vendor\Box\Providers\ModuleServiceProvider" --tag="own-migrations-only"