PHPackages                             mphamid/service-repository - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. mphamid/service-repository

ActiveLibarary[Framework](/categories/framework)

mphamid/service-repository
==========================

Service Repository Design Pattern In Laravel

1.0.2(2y ago)023MITPHP

Since Dec 2Pushed 2y ago1 watchersCompare

[ Source](https://github.com/mphamid/ServiceRepository)[ Packagist](https://packagist.org/packages/mphamid/service-repository)[ RSS](/packages/mphamid-service-repository/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)DependenciesVersions (3)Used By (0)

Service Repository Pattern
==========================

[](#service-repository-pattern)

This package is designed to implement the service structure on Laravel projects.

Installation
------------

[](#installation)

```
composer require mphamid/service-repository

```

Requirement
-----------

[](#requirement)

- Laravel 9.\*

Generator Commands
------------------

[](#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
-----------------

[](#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

1. **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

```
class TestException extends ServiceException
{
    public const NEW_ERROR = 'new_error';

    public function configureExceptions()
    {
        $this->addException(self::NEW_ERROR, Response::HTTP_BAD_REQUEST, 'this is a test exception');
    }
}
```

2. **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.
3. **Repository**: Service interface for implement service repository structure
4. **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.
5. **Service**: A class that extends from the repository and all the logic of the service is placed in this class

Register Services
-----------------

[](#register-services)

There are two ways to connect the repository to the services, which you can do in the `service providers`.

```
$this->app->bind(UserRepository::class, UserService::class);
```

or

```
$this->app->singleton(UserRepository::class, UserService::class);
```

### The difference between bind and singleton

[](#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
------------------------

[](#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.

```
    if ($e instanceof ServiceException && ($request->wantsJson() || $request->is('api/*'))) {
        return response()->json(['code' => $e->getAppCode(), 'message' => $e->getMessage()], $e->getCode());
    }
```

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~28 days

Total

2

Last Release

863d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e91893ef9570a12bee81627af5438bd61cd0ba99e7d8f5ff9de28b95e1d1c6f1?d=identicon)[mp.hamid](/maintainers/mp.hamid)

---

Top Contributors

[![mphamid](https://avatars.githubusercontent.com/u/11472148?v=4)](https://github.com/mphamid "mphamid (11 commits)")

### Embed Badge

![Health badge](/badges/mphamid-service-repository/health.svg)

```
[![Health](https://phpackages.com/badges/mphamid-service-repository/health.svg)](https://phpackages.com/packages/mphamid-service-repository)
```

###  Alternatives

[laravel/telescope

An elegant debug assistant for the Laravel framework.

5.2k67.8M192](/packages/laravel-telescope)[spiral/roadrunner

RoadRunner: High-performance PHP application server and process manager written in Go and powered with plugins

8.4k12.2M84](/packages/spiral-roadrunner)[nolimits4web/swiper

Most modern mobile touch slider and framework with hardware accelerated transitions

41.8k177.2k1](/packages/nolimits4web-swiper)[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k36.7M259](/packages/laravel-dusk)[laravel/prompts

Add beautiful and user-friendly forms to your command-line applications.

708181.8M596](/packages/laravel-prompts)[cakephp/chronos

A simple API extension for DateTime.

1.4k47.7M121](/packages/cakephp-chronos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)