analogue/orm

An intuitive Data Mapper ORM for PHP and Laravel

Tuesday, June 19, 2018
by RemiCollin
Repository
33 Watchers
552 Stars
7,375 Installations

PHP
4 Dependents
0 Suggesters
49 Forks
10 Open issues
100 Versions
8 % Grown

The README.md

Analogue ORM

, _(*1)

Analogue is a flexible, easy-to-use ORM for PHP. It is a transposition of the Eloquent ORM that ships with Laravel framework using a Data Mapper pattern instead of the original Active Record approach. it overcomes some of Eloquent's architectural limitations by using a strict separation of concerns; for example, you can use Value Objects or Single-table-inheritance, which are hard/impossible to implement correctly using the native ORM., _(*2)

As a Laravel package, it integrates flawlessly inside the framework, and provides a more powerfull peristance layer, allowing to build enterprise-grade applications while retaining a simple and enjoyable development experience., _(*3)

Installation

composer require analogue/orm

See Configuration for more information., _(*4)

Concept

The concept is simple; your model layer is defined using 2 classes : one Entity, which can be any PHP class or extends the base Analogue\ORM\Entity class which provides magic getters and setters, and one EntityMap which defines relationships, castings, table name, database column names., _(*5)

Take this simple domain model :, _(*6)

use Analogue\ORM\Entity;
use Illuminate\Support\Collection;

class Blog extends Entity
{
    public function __construct()
    {
        $this->posts = new Collection;
    }

    public function addPost(Post $post)
    {
        $this->posts->push($post);
    }
}

class Post extends Entity
{

}

We can instruct Analogue how these objects are related using these classes :, _(*7)

use Analogue\ORM\EntityMap;

class BlogMap extends EntityMap
{
    public function posts(Blog $blog)
    {
        return $this->hasMany($blog, Post::class);
    }
}

class PostMap extends EntityMap
{
    public function blog(Post $post)
    {
        return $this->belongsTo($post, Blog::class);
    }
}

Now we can create related instance of or object and persist them to the database :, _(*8)

$blog = new Blog;
$blog->title = "My first blog";

$post = new Post; 
$post->title->"My first post";

$blog->addPost($post);

// Only the blog instance need to explicitely stored; Analogue takes care of synchronizing
// related objects behinds the scene. 

mapper(Blog::class)->store($blog);

Once our objects are persisted into the database, we can query them using the fluent query builder :, _(*9)

$blog = mapper(Blog::class)->first();

echo $blog->posts->first()->title; // 'My first post'

Documentation

Check the Documentation for more details., _(*10)

Features

Framework agnostic
Lazy loading
Eager Loading
Timestamps
Soft Deletes
Value Objects
Polymorphic Relationships
Dynamic Relationships
Single table inheritance
Cast entities to Array / Json
Flexible event system
Native multiple database connections support
Extendable via custom database drivers / plugins

Changelog

Version 6.0

Laravel 6.0 support

Version 5.6

Laravel 5.6 support
Bring back ability to map DB columns that name are not equals to the name of the attribute.
Add ability to map DB snake case columns to camel case properties on entities.

Version 5.5

Laravel 5.5 support
Pushed miminum requirements to PHP7
Complete support of Plain PHP objects via reflection based hydration/dehydration
Improved Lazy-loading proxies.
New, more flexible Value Object implementation, that can now be defined as embedsOne(), embedsMany() relationships
Embedded value object can now be stored as a mysql JSON field
Analogue entities can now be instantiated using laravel's IoC Container or any PSR-11 compatible container.
Added MongoDB driver.
Package auto discovery (L5.5)

Version 5.4

Illuminate 5.4 Compatibility.
Add Ability to map DB columns that name are not equals to the name of the attribute.

Version 5.3

Illuminate 5.3 Compatibility.
Now fully support Single Table Inheritance.

Version 5.1

Illuminate 5.1 + 5.2 Compatibility.

Version 5.0

Analogue version now mirrors illuminate version.

Version 2.1.3

Mutator feature in base Entity class.
Ability to add entities to a proxy collection without lazyloading it.

Version 2.1

Package is now framework agnostic.
Now support any plain object that implements Mappable interface.
Introducing a MappableTrait for quick implementation.
Queries can now be run directly on the mapper Object.
Store/Delete methods now accept a array and collections as argument.
EntityMap are now autodected when in the same namespace as the entity.
Base Entity class Supports hidden attributes.
Many workflow related improvements.

Version 2.0

Laravel 5 Support.

Documentation

Check the wiki for full documentation., _(*11)

Licence

This package is licensed under the MIT License., _(*12)

The Versions

19/06 2018

5.6.x-dev

5.6.9999999.9999999-dev http://github.com/analogueorm/analogue

An intuitive Data Mapper ORM for PHP and Laravel

library orm

An intuitive Data Mapper ORM for PHP and Laravel

analogue/orm

The README.md

Analogue ORM

Installation

Concept

Documentation

Features

Changelog

Version 6.0

Version 5.6

Version 5.5

Version 5.4

Version 5.3

Version 5.1

Version 5.0

Version 2.1.3

Version 2.1

Version 2.0

Documentation

Licence

The Versions

5.6.x-dev

The Requires

The Development Requires

by Rémi Collin

v5.6.12

The Requires

The Development Requires

by Rémi Collin

dev-analysis-86vEw6

The Requires

The Development Requires

by Rémi Collin

dev-analysis-z917PP

The Requires

The Development Requires

by Rémi Collin

v5.6.11

The Requires

The Development Requires

by Rémi Collin

v5.6.10

The Requires

The Development Requires

by Rémi Collin

dev-analysis-zERWw9

The Requires

The Development Requires

by Rémi Collin

v5.6.9

The Requires

The Development Requires

by Rémi Collin

v5.6.8

The Requires

The Development Requires

by Rémi Collin

dev-analysis-8mGOrp

The Requires

The Development Requires

by Rémi Collin

v5.6.7

The Requires

The Development Requires

by Rémi Collin

dev-fix/inheritance-eager-loading

The Requires

The Development Requires

by Rémi Collin

dev-analysis-XNaRJp

The Requires

The Development Requires

by Rémi Collin

dev-analysis-qJOGwD

The Requires

The Development Requires

by Rémi Collin

v5.6.6