echowine/laravel-orm-ao

Laravel ORM - Attribute as an Object

Treat your attributes as they deserve, as objects!, _(*1)

Installation

Modify your composer.json and run composer update, _(*2)

``` json { "require": { "echowine/laravel-orm-ao":"@dev" } }, <sub>(*3)</sub>

Defining a Model
------------


```php

namespace CoreWine\ORM\Test\Model;

use CoreWine\ORM\Model;
use CoreWine\ORM\AttributesBuilder;

class User extends Model{

    /**
     * The table associated with the model.
     *
     * @var string
     */
    protected $table = 'tests_users';

    /**
     * List of all your attributes.
     *
     * @param AttributesBuilder $builder
     *
     * @return void
     */
    protected function attributes(AttributesBuilder $builder){

        $builder -> string('username')
            -> minLength(3)
            -> maxLength(10)
            -> match("/^([a-zA-Z0-9])*$/");

        $builder -> boolean('active');

        $builder -> number('points') -> range(0,99);
    }

}

Boolean

Starting with the easiest one, only two values accepted (true,false), <sub>(*4)</sub>

    $user = User::first();
    $user -> active = "true"; // true
    $user -> active = "false"; // false
    $user -> active = true; // true
    $user -> active = 1; // true

Number

    $user = User::first();
    $user -> points = 10;

Methods

Exceptions

String

Thanks to magic methods editing the value of an attribute remains the same, <sub>(*5)</sub>

    $user = User::first();
    $user -> username = "Admin";
    $user -> save();

But i told you, attributes are objects!, <sub>(*6)</sub>

    $user -> username -> toLowerCase(); // "admin"
    $user -> username -> length(); // 5

Methods

Exceptions

The string field is currently using Stringy\Stringy, check all methods available here danielstjules/Stringy, <sub>(*7)</sub>