Download the PHP package vandarpay/service-repository without Composer
On this page you can find all versions of the php package vandarpay/service-repository. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vandarpay/service-repository
More information about vandarpay/service-repository
Files in vandarpay/service-repository
Package service-repository
Short Description Service Repository Design Pattern In Laravel
License MIT
Informations about the package service-repository
Service Repository Pattern
This package is designed to implement the service structure on Laravel projects.
Installation
composer require vandarpay/service-repository
Requirement
- Laravel 9.*
Generator Commands
php artisan make:dto
php artisan make:service-exception {service-name}
php artisan make:service-exception-language {service-name} --language=fa
php artisan make:service-repository {service-name} --grpc
php artisan make:service-transformer {service-name}
php artisan make:service {service-name} --grpc --language=fa --transformer
Service Structure
Each service contains 5 files that are located in a folder with the same name as the service in the services folder, listed below
- Exception: To collect the service exception with the following specific structure
exception class must be extends from ServiceException class and each class contains several errors that contain a constant variable and the definition of this variable. In defining the parameters, the exception error code, the machine-readable code and the error message must be defined please attention to below example
- Exception Language: This file is the translation of the exceptions in the service, which sends the text related to the exception error to the user according to the language specified in the request of the error handling section.
- Repository: Service interface for implement service repository structure
- Transformer: It is the class between service methods and other microservices, which can be provided in different versions and include calling several methods from several service.
- Service: A class that extends from the repository and all the logic of the service is placed in this class
Register Services
There are two ways to connect the repository to the services, which you can do in the service providers
.
or
The difference between bind and singleton
The difference between these two methods is that they persist in memory. If you use the singleton method, your instance of the service class will persist in memory and one instance will be used for all requests. Therefore, use Singleton for high-visit services and make sure that this feature does not interfere with the performance of your service.
Handel Service Exception
Please put the following code sample in the report
method of the exception handler file (app/Exceptions/Handler.php
)
To integrate and standardize the outputs issued from the service.