filippo-toso / laravel-domain-library
Build domain driven applications in Laravel
Requires
- php: ^7.2.5|^8.0
- illuminate/support: ^9.0|^10.0
- league/flysystem: ^3.0
- nikic/php-parser: ^4.10
- dev-master
- v4.0.1
- v4.0.0
- v3.0.9
- v3.0.8
- v3.0.7
- v3.0.6
- v3.0.5
- v3.0.4
- v3.0.3
- v3.0.2
- v3.0.1
- v3.0.0
- v2.0.4
- v2.0.3
- v2.0.2
- v2.0.1
- v2.0.0
- v1.0.21
- v1.0.20
- v1.0.19
- v1.0.18
- v1.0.17
- v1.0.16
- v1.0.15
- v1.0.14
- v1.0.13
- v1.0.12
- v1.0.11
- v1.0.10
- v1.0.9
- v1.0.8
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0.0
- v0.0.6
- v0.0.5
- v0.0.4
- v0.0.3
- v0.0.2
- v0.0.1
This package is auto-updated.
Last update: 2024-10-14 21:18:04 UTC
README
I read the Laravel Beyond CRUD series and decided this is the way. But I'm a lazy coder: I really don't like to write a lot of code. So, I needed a toolkit to automate as much coding as possible. And here it is!
Requirements
- PHP 7.2.5+
- Laravel 7+
Laravel 11 support
I'm a little busy in this period. Laravel 11 has some critical changes that impact this package. In the next few days I'll try to find the time to make a new major release with full support for Laravel 11.
What it does?
It provides:
- multiple console commands to create domain driven classes
- traits and classes to speed up development
The commands prefix is domain:
.
How does it work?
Let's start with a clean Laravel installation. From your favorite shell:
composer create-project laravel/laravel project
Then install the library:
cd project
composer require filippo-toso/laravel-domain-library
composer require spatie/laravel-data spatie/laravel-model-states spatie/laravel-query-builder spatie/laravel-view-models
The additional Spatie's packages are required for data transfer objects, model states, query builders and view models.
Now the fun part... First, we are going to build the domain structure:
php artisan domain:setup:structure
This command will create a new src
folder that will contain 3 namespaces App
, Domain
and Support
.
It will also rewire the Laravel application to work with this new directory structure (ie. moving middlewares and providers, updating the bootstrap code, introducing a new Application class, and so on).
At this point you can start building your domain driven application. Let's create the structure for a sample domain named Invoices
php artisan domain:make:domain Invoices
Then we will prepare the administrative application part for this domain:
php artisan domain:make:application Admin\Invoices
Making domain classes
With this library you can make the following classes:
- Models (with support for custom collections, query builders and subscribed events)
- Model's states (using spatie/laravel-model-states)
- Model's subscribers and model events (automagically linked to models)
- Model's query builders (automagically loaded)
- Model's collections (automagically loaded)
- Data transfer objects (using spatie/data-transfer-object)
- HTTP queries (using spatie/laravel-query-builder)
- View models (using spatie/laravel-view-models)
- Actions
- Form requests
All the commands include a --force
option to overwrite existing classes. Please keep in mind that with great power comes great responsibility
Customizing code generation
If you want to customize the generated code, you can publish the stubs and then edit them.
php artisan vendor:publish --tag=stubs --provider="FilippoToso\Domain\Support\ServiceProvider"
Making models
php artisan domain:make:model Invoice --domain=Invoices
Making model's states
php artisan domain:make:states --model=Invoice --domain=Invoices --states="Paid,Pending,Overdue,Cancelled"
Making model's subscribers
php artisan domain:make:subscriber --model=Invoice --domain=Invoices
Making model's events
php artisan domain:make:events --model=Invoice --domain=Invoices --events="saving,created,deleting"
Making model's subscribers and events
php artisan domain:make:subscriber --model=Invoice --domain=Invoices --events="saving,created,deleting"
Making model's collections
php artisan domain:make:collection --model=Invoice --domain=Invoices
Making model's query builders
php artisan domain:make:querybuilder --model=Invoice --domain=Invoices
Making data transfer objects
php artisan domain:make:dto Invoice --domain=Invoices --application=Admin\Invoices
Making HTTP queries
php artisan domain:make:query InvoiceIndex --domain=Invoices --application=Admin\Invoices --model=Invoice
Making view models
php artisan domain:make:viewmodel InvoiceForm --domain=Invoices --application=Admin\Invoices --model=Invoice
Making actions
php artisan domain:make:action InvoiceIndex --domain=Invoices --application=Admin\Invoices --model=Invoice
Making form requests
php artisan domain:make:request Invoice --application=Admin\Invoices
Making exceptions
php artisan domain:make:exception InvalidInvoice --domain=Invoices
Making a suite of classes
This command will create all the classes above in a single sweep:
php artisan domain:make:suite
--domain=Invoices
--application=Admin\Invoices
--model=Invoice
--states="Paid,Pending,Overdue,Cancelled"
--events="saving,created,deleting"
--dtos="Invoice,CreateInvoice"
--queries=InvoiceIndex
--dtos="Invoice,CreateInvoice"
--exceptions=InvalidInvoice
--queries=InvoiceIndex
--requests=Invoice
--viewmodels=InvoiceForm
--actions="CreateInvoice,PayInvoice,CancelInvoice"