doctorbeat/eloquent-repository

A repository for eloquent models. Using this makes the model appear to have a sigle responsibility

eloquent-repository

A repository for eloquent models. Using this makes the model appear to have a single responsibility and thus makes them unit-testable in isolation, _(*1)

Installation

Via composer:, _(*2)

require: "doctorbeat/eloquent-repository": "*"

Why a respository?

Eloquent is great for its simplicity but this simplicity makes that Eloquent models breaks the 'single responsibility" principle. An Eloquent model is both a entity (property bag) AND dealing with database interaction (select, insert, update, delete). And this makes that you can not mock your models in isolation. You need the entity functionality but want to mock the database interaction., _(*3)

This problem is further shown in the fact that Eloquent models use static functions like find(), all() and where()., _(*4)

In comes the Eloquent Repository which make you able to use a model as an entity/property bag moves all database interaction methods to the repository. The repository comes with an interface which can be mocked., _(*5)

Methods and api

These methods are available on the repository and have an api equal to the corresponding Eloquent method: - save - delete - push - touch - all - find - where* - all other static methods, _(*6)

Relations

To get relations from the repository use these methods:, _(*7)

   [Model:]           [Repository:]                             [result]
-  $model->parent     $repo->getAttribute($model, 'parent');    the parent model
-  $model->children   $repo->getAttribute($model, 'children');  the child models as a collection
-  $model->children() $repo->children($model);                  the child models as a relation
-  $model->children()->save($child)
                      $repo->children($model, $child);          add the child to the children of the model
-  $model->children()->saveMany($list)
                      $repo->children($model, $list);           add an array of new children to the children of the model

These examples assume that you have defined parent and children as relations on the model!, _(*8)

Usage

        $repo = new EloquentRepository('App\\Person');

        $ent = new Person();
        $ent->name = 'xyz';
        $repo->save($ent);
        $repo->delete($ent);

        $all = $repo->all();
        $person4 = $repo->find(4);
        $personXyz = $repo->whereName('xyz')->get();