Download the PHP package dweineratl/laravel-model-abstraction-helper without Composer

Laravel Model Abstraction Helper

Why go to all this effort?

I'm trying to backfill tests in my Laravel project, and I really wanted to use Laravel Test Factory Generator to generate factories for the tests. But I had a problem -- I used Jens Segers' Laravel MongoDB Eloquent extension for Laravel.

Due to the nature of how MongoDB works, it doesn't have a Doctrine Driver. So I couldn't use it. Or could I? I have been adding full PHP DocBlocks to my models, using @property to help with hinting and variable completion in my IDE.

I was discussing this approach with Jason McCreary because he was the one that pointed me towards Laravel Test Factory Generator. He suggested abstracting it out into a factory that could use Doctrine, DocBlocks, custom drivers and ultimately, fallback to using the $fillable array that should be present in a Laravel Model, and Laravel Model Abstraction Helper was born.

Install

Require this package with composer using the following command:

How to use

For example, Laravel Test Factory Generator uses this code snippet to get the column names and types for a Model:

It can be refactored to

Drivers

Laravel Model Abstraction Helper uses the concept of "drivers" to handle different types of models. Laravel Model Abstraction Helper ships with three drivers. The ModelAbstractionFactory will detect which driver to use

• Doctrine Driver

  This driver is for models using a RDBMS that uses Doctrine, such as MySQL, Postgres or SQLite.

• DocBloc

  This driver is for models that don't use a traditional RDBMS such as MongoDB that does not use Doctrine and has a PHP DocBloc with @property tags

• Fillable

  This driver is the fallback when the model does not use Doctrine and does not have a DocBlock with at least one @property tag. It uses the $fillable array that should be present in every Laravel model

Class Methods

ModelAbstractionFactory

The ModelAbstractionFactory has two public static methods:

DriverInterface

Every driver implements the Dweineratl\LaravelModelHelper\DriverInterface which only has a single method

Column

Custom Drivers

To support other methods of obtaining the columns for a model, Laravel Model Abstraction Helper supports drivers that are in the Dweineratl\LaravelModelHelper\Driver namespace, and the class name is value of config('database.default') concated with 'Driver' and in PascalCase (i.e, Dweineratl\LaravelModelHelper\Driver\CouchdbDriver). It must implement the Dweineratl\LaravelModelHelper\DriverInterface at a minimum, providing the getColumns() method that returns an array of Dweineratl\LaravelModelHelper\Column objects. ModelAbstractionFactory will first check if the model supports Doctrine. If it does not support Doctrine, it will then get the value of the default database driver using config('database.default') and check if a custom driver for that database exists. If it does not, it will then check to see if the model has a suitable DocBlock. Finally, if none of the previous drivers are usable, the default fallback of using the $fillable array will be used.

License

The Laravel Model Abstraction Helper is free software licensed under the MIT license.