README

Package provides a basic implementation of Repository pattern with artisan command to generate classes.

Features:

Repository class with basic methods like all, find, create, update, delete
Generic type comments to pass PHPStan checks
Artisan make:repository command to generate repository class with model and interface

Installation

To install this package, you need to install Composer first, and then run:

composer require manchenkoff/laravel-repositories

or add this line to composer.json:

"manchenkoff/laravel-repositories": "*"

and run composer update in the terminal.

Package should automatically register its service provider in your application, but you can do it manually in config/app.php:

'providers' => ServiceProvider::defaultProviders()
    ->merge([
        // Package Service Providers
        \Manchenkoff\Laravel\Repositories\ServiceProvider::class,

        // Application Service Providers
        // ...
    ])
    ->toArray(),

Usage

First of all, you need to create a model class for your repository. You can do it manually or use artisan command:

php artisan make:model Post

Then you can create a repository class for your model:

# repository name - PostRepository
# model name - Post
php artisan make:repository PostRepository Post

This command will create a repository class in app/Repositories directory and PostRepositoryInterface contract class in app/Contracts/Repositories.

Now you can use existing methods in your services or extend with custom functionality:

<?php

namespace App\Services;

use Illuminate\Database\Eloquent\Collection;
use App\Contracts\Repositories\PostRepositoryInterface;
use App\Contracts\Services\PostServiceInterface;

final class PostService implements PostServiceInterface
{
    private readonly PostRepositoryInterface $repository;

    public function __construct(PostRepositoryInterface $repository)
    {
        $this->repository = $repository;
    }

    public function getAllPosts(): Collection
    {
        return $this->repository->all();
    }
}

Implementation

All repository methods use protected query() method to get Eloquent\Builder instance. You can override this method in your repository class to add custom logic, e.g. when you always need some relations to be loaded or custom sorting applied.

protected function query(): Builder
{
    return parent::query()->with('comments')->orderBy('created_at', 'desc');
}

Here is a list of available methods with a quick description:

Method	Description
`paginated(): LengthAwarePaginator`	returns paginated collection
`all(): Collection`	returns all entities
`find(mixed $id): ?Model`	returns entity by id or null
`get(mixed $id): Model`	returns entity by id or throws `ModelNotFoundException`
`create(array $data): Model`	creates new entity with given data
`update(Model $entity, array $data): Model`	updates existing entity with given data
`updateMany(array $ids, array $data): void`	updates many entities with given data by ids
`delete(Model $entity): Model`	deletes existing entity
`deleteMany(array $ids): void`	deletes many entities by ids

Also you might want to adjust class template for your needs. You can do it by publishing package views:

php artisan vendor:publish --provider="Manchenkoff\Laravel\Repositories\ServiceProvider"

Development

This package is completely open-source, so any contributions are welcome!

Clone this repository to your local machine, install dependencies and run tests:

git clone https://github.com/manchenkoff/laravel-repositories
cd laravel-repositories
composer install
composer test

There are some useful composer scripts:

Script	Description
`composer fmt`	Apply Laravel Pint code style rules
`composer test`	Run tests with Testbench package
`composer lint`	Run PHP Stan analysis against package codebase
`composer rector`	Run Rector analysis against package codebase
`composer rector:fix`	Apply available Rector suggestions

manchenkoff / laravel-repositories

Maintainers

Details

README

Installation

Usage

Implementation

Development