tbitencourt/laravel-repository-eloquent

Easy MVC repository with Eloquent for Laravel 5 or later

1.2.1 2020-04-17 20:50 UTC

Requires

• php: ~7.0.0||~7.1.0||~7.3.0||~7.4.0
• laravel/framework: ~5.2.0||~5.3.0||~5.4.0||~5.5.0||~5.6.0||~5.7.0||~5.8.0||^6.0.0||^7.0.0

MIT

• Thales Bitencourt

• php
• repository
• laravel
• eloquent

README

Easy MVC repository with Eloquent for Laravel 5 or later, an useful tool to combine with Laravel Eloquent classes.

Table of Contents

• Installation
  • Laravel compatibility
  • Composer
  • Manually
• Config
• Usage
• Changelog
• License

Installation

Laravel compatibility

Laravel	laravel-repository-eloquent
5.2.x-5.8.x (PHP 7 required)	1.0.x (deprecated)
5.2.x-6.0.x (PHP 7 required)	1.1.x (deprecated)
5.2.x-7.0.x (PHP 7 required)	1.2.x

PHP 7 compatibility

PHP	laravel-repository-eloquent
7.0.x-7.3.x	1.0.x
7.0.x-7.4.x	1.1.x
7.0.x-7.4.x (Except 7.2.x)	1.2.x

Composer

Install the package via composer: composer require tbitencourt/laravel-repository-eloquent

Manually

Since Laravel 5.5, the service provider and facade will automatically get registered. For older versions of the framework, follow the steps below:

Register the service provider in config/app.php

        'providers' => [
		// [...]
                Tbitencourt\LaravelRepositoryEloquent\Providers\RepositoryEloquentServiceProvider::class,
        ],

Config

In order to edit the default configuration (where for e.g. you can find supportedLocales) for this package you may execute:

php artisan vendor:publish --provider="Tbitencourt\LaravelRepositoryEloquent\Providers\RepositoryEloquentServiceProvider"

After that, config/repository.php will be created. Inside this file you will find all the fields that can be edited in this package.

Usage

The first step is to store your repositories somewhere - anywhere. These will be simple declaration to start using it.

Here's an example of a repository.

use Tbitencourt\LaravelRepositoryEloquent\RepositoryEloquent;

class UserRepository extends RepositoryEloquent {

    /**
     * Specify \Illuminate\Database\Eloquent\Model class name
     * @return string
     */
    public function model()
    {
        return User::class;
    }
}

That's it! You're done. Now, within your controller and services, you can do:

    protected $repository;
    
    public __construct(UserRepository $repository)
    {
        $this->repository = $repository;
    }
    
    public index(Request $request)
    {
        $result = $this->repository->get();
        
        return view('myView');
    }

Notice how the call to the repository methods are equal to Eloquent so you doesn't need to learn new commands and proper use MVC repository.

Changelog

View changelog here -> changelog

License

Laravel Localization is an open-sourced laravel package licensed under the MIT license

Have fun!

Thales