Download the PHP package jamesaspence/core-model without Composer

Laravel Core Model (Laracore)

A repository, factory, and criteria layer for Eloquent models, providing a convenient repository interface that still allows fully-featured, eloquent usage. Allows convenient testing and dependency injection without sacrificing features or versatility.

• Requirements
• Installation
• Usage
  • "Magic" Methods
  • Relations
  • Dependency Injection
  • Model Factories
  • Inheritance
• Future Plans

Requirements

• Laravel 5.3+

Installation

composer require jamesaspence/laravel-core-model

Usage

Laracore (Laravel Core Model) is very simple to use. It works exactly the same as the Eloquent models you're already used to. This means you can use all the model queries you're already used to.

More advanced queries are allowed as well, including custom queries. Assuming the same repository as before:

The repository's methods map to the model's methods, allowing, in the above example, a return of a query builder. This means we don't lose any of the features we've come to love from Eloquent.

"Magic" Methods

Laracore's repositories support the calling of magic methods, such as local scope queries. For example, consider the following code:

You do not need to define a custom repository with this method hardcoded.

Instead, we can call our scope queries and other magic methods directly on the repository. The repository will delegate them on to the model class.

Our magic method handling also listens for a model instance being the first argument of a magic method called via this repository. If the first argument is an instance of a model, it will instead call the method on the model instance itself! See the below example:

This is meant to catch missed repository methods that we would want implemented. If this causes issues, feel free to reach out via the issues on this repository!

Relations

Laracore also allows retrieval of relations.

ModelRepository classes have a RelationRepository set which allows even more advanced relation settings, such as sync and associate.

All relation methods should be represented as well, allowing versatile use.

Dependency Injection

One of the best aspects of this library is the ability to dependency inject your database access, rather than using static methods.

This allows easy dependency injection, which in turn makes it very easy to isolate dependencies for testing.

Model Factories

Want to create models without using new Model all over your code? ModelFactory is here to help!

This will save the model with the attributes specified.

You can also use the ModelFactory to save BelongsTo relations:

Inheritance

Another nice feature is the ability to extend these classes at will. You can continue to use ModelRepository on its own, but if you prefer, you can extend the repositories and factories yourself.

Here, we'll extend ModelRepository so we don't have to set the model every time. We'll also make it so default criteria are set on the repository.

Then, we can use this without setting a model! No setModel required!

This will perform the following query (if using MySQL):

with the two bound parameters of 'Test' and '1'.

Future Plans

Short term, the plan is to keep this library compatible with major versions of Laravel > 5. That means testing for new versions and adding new methods that exist in newer versions.

I would love to add non-eloquent support to this repository. The plan is to add both raw query as well as Doctrine repositories, but that isn't coming quite yet.

Long-term plans are a little more unclear. After non-eloquent support, I will probably decide on my next feature to implement. If you have any ideas, I would love to hear them!