pushoperations/magician

A library for implementing repositories with magic finders for the Eloquent ORM.

v2.0.0 2015-06-19 22:43 UTC

Requires

• php: >=5.4.0
• illuminate/cache: 5.0.*|5.1.*
• illuminate/support: 5.0.*|5.1.*

Requires (Dev)

• phpunit/phpunit: 4.3.*
• sami/sami: 2.0.*
• satooshi/php-coveralls: dev-master

MIT

• Tony Li

• pattern
• repository
• laravel
• repositories
• magic finders
• magician

README

A library for implementing repositories with magic finders and caching for the Eloquent ORM.

Contents

• Installation
• Usage
• Examples
• API documentation

Install

The recommended way to install is through Composer.

Update your project's composer.json file to include Magic Repository:

{
    "require": {
        "pushoperations/magician": "2.*"
    }
}

Then update the project dependencies to include this library:

composer update pushoperations/magician

After installing, you need to require Composer's autoloader:

require 'vendor/autoload.php';

Usage

A base implementation of the magic repository is already created for use out-of-the-box.

<?php namespace Controllers;

use Controller;
use Magician\Magician;

class ExampleController extends Controller
{
    public function __construct(Magician $magician)
    {
        // Tell this magician instance to be the repository manager for the 'User' model.
        $this->m = $magician->set('Models\User');
    }

    public function create()
    {
        $user = $this->m->firstOrMake(['email' => '[e-mail]']);

        if ($this->m->save($user)) {
            return $user;
        } else {
            return 'error: unable to save the user';
        }
    }

    public function read($id = null)
    {
        if ($id) {
            return $this->m->findById($id);
        } else {
            return $this->m->getById(['>', 0]);
        }
    }

    public function update($id)
    {
        $user = $this->m->findById($id);
        $user->fill([
            'trial' => true,
            'last_login' => new \DateTime,
            'subscription' => '2015',
        ]);

        $user->load('permissions');

        if ($this->rm->save($user)) {
            return $user;
        } else {
            return 'error: unable to save the user';
        }
    }

    public function inactive($date)
    {
        return $this->m->getByLastLogin(['<', $date]);
    }

    public function newTrials()
    {
        return $this->m->get10ByTrial(true, ['subscription' => 'asc'], ['email', 'subscription']);
    }
}