https://github.com/lassehaslev/laravel-modules
Use Package Development in your local projects.
https://github.com/lassehaslev/laravel-modules
hacktoberfest laravel laravel-modules modules package-development
Last synced: 3 months ago
JSON representation
Use Package Development in your local projects.
- Host: GitHub
- URL: https://github.com/lassehaslev/laravel-modules
- Owner: LasseHaslev
- Created: 2016-12-11T18:07:29.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-09-24T11:28:29.000Z (over 7 years ago)
- Last Synced: 2025-01-05T09:29:17.842Z (5 months ago)
- Topics: hacktoberfest, laravel, laravel-modules, modules, package-development
- Language: PHP
- Size: 55.7 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# lassehaslev/laravel-modules
> Use [Package development]( https://laravel.com/docs/5.3/packages ) in your local projects.
Structure your applications functionality into modules and autoload the packages ServiceProviders.
## 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.
```json
"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.
This will discover vendor packages and package modules.
> You should replace the discover function in composer to auto update every time you run a composer command.
```
"post-autoload-dump": [
...
"@php artisan package:discover-modules"
]
```
> Remember to run this command every time you create a new module.
## Create local packages
I recommend you to use [LasseHaslev/laravel-package-template](https://github.com/LasseHaslev/laravel-package-template) to get a flying start to your local package.
Go to [LasseHaslev/laravel-package-template](https://github.com/LasseHaslev/laravel-package-template) quick package setup.
## Configuration
If you deside to change the place where your modules lives you must change path in composer.json ```extra.merge-plugin.include```.
You must also overwrite the config for modules
```Config::set( 'modules.path', base_dir( 'your/new/path' ) )```
## Development
``` bash
# Install dependencies
composer install
# Install for running automatic tests
yarn
# Make Modules folders in orcestra to make tests work
mkdir vendor/orchestra/testbench-core/laravel/Modules
# Run one time
npm run test
# Automaticly run test on changes
npm run dev
```