deseco/repository

Easy repositories for laravel.

Simple repositories for Laravel

Package is currently under development !!

Info

Simple package which allows to implement repository pattern in Laravel applications. Inspired by Bosnadev package. Supports criteria, query filters, and can interact with fractal., _(*1)

Installation

composer require deseco/repository

Add service provider into config/app.php, _(*2)

$providers = [
    ....

    Deseco\Repositories\RepositoriesServiceProvider::class,
]; 

Publish configuration, _(*3)

php artisan vendor:publish  --provider="Deseco\Repositories\RepositoriesServiceProvider"

Setup configuration for repositories like: * namespace - repositories namespace * suffix - for repositories classes e.g.: Repository * path - path to repositories * class - factory repository class, when injected allows to easily create repositories (has auto-completion for Phpstorm), _(*4)

Usage

You can create repository with command:, _(*5)

php artisan repository:make

You will be asked to specify repository name, _(*6)

Enter repository name::
> Clients

and alias (optional):, _(*7)

Enter alias name [clients]:
>

You will get two files:, _(*8)

Generating repository...

+-------------------+-------------------+----------+---------+
| Class             | Repository        | Property | Status  |
+-------------------+-------------------+----------+---------+
| ClientsRepository | -                 | -        | Created |
| Repositories      | ClientsRepository | clients  | Created |
+-------------------+-------------------+----------+---------+

Done!

Repository class (implement model method):, _(*9)

<?php

namespace App\Repositories;

use Deseco\Repositories\Eloquent\Repository;

class ClientsRepository extends Repository
{
    /**
     * @return mixed
     */
    public function model()
    {
        // return Model::class;
    }
}

and RepositoriesFactory:, _(*10)

<?php

namespace App\Repositories;

use Deseco\Repositories\Factories\RepositoryFactory;

/**
 * Class Repositories
 */
class Repositories extends RepositoryFactory
{
    /**
     * @var ClientsRepository
     */
    public $clients = 'clients';
}

Now you can use factory (you have full auto-completion for properties and methods):, _(*11)

Route::get('/', function (\App\Repositories\Repositories $repo) {
    return $repo->clients->all();
});

or inject repository into class/method and use standalone:, _(*12)

public function index(ClientsRepository $clientsRepository)
{
    $clients = $clientsRepository->all();
}