A Laravel package to easily generate service modules for your Laravel applications.
To gain a deeper understanding of the architecture and how to effectively use service modules in Laravel, you can read this Medium article:
Simplify External API Integrations in Laravel Using Service Modules
This article provides insights into the benefits and implementation details of using service modules for external API integrations in Laravel applications.
You can install the package via composer:
composer require shreifelagamy/laravel-service-modules
php artisan service:generate UserService
This will create a new service class in the app/Services
directory.
During the generation process, you will be prompted to:
- Generate an exception for the service
- Add methods to the repository
- Include Data Transfer Objects (DTOs) for the service
These prompts allow you to customize the service module according to your needs.
The generated service structure will look like this:
app/Services/UserService/
├── Providers/
│ └── UserServiceProvider.php
├── Repositories/
│ ├── UserServiceInterface.php
│ └── UserServiceRepository.php
├── Facades/
│ └── UserService.php
├── Exceptions/ (optional)
│ └── UserServiceException.php
└── DTOs/ (optional)
└── UserData.php
The package comes with a default configuration file that you can publish to customize the behavior:
php artisan vendor:publish --tag=laravel-service-modules-config
This will create a config/laravel-service-modules.php
file where you can modify the default settings.
You can control the directory name for generated services through the config file. This allows you to customize where your service modules are created within your Laravel application.
We're constantly working to improve this package. Here are some features we're planning to add in the future:
- Support auto-creating PHPDoc for facades to include method definitions.
- Add more customization options for DTOs.
Stay tuned for these upcoming enhancements!
The Laravel Services Generator is open-sourced software licensed under the MIT license.