startup-palace/laravel-helpers

A collection of helpers for your Laravel application.

dev-master 2019-07-05 15:53 UTC

Requires

• illuminate/database: ~5.2
• kblais/laravel-uuid: ^0.1.0
• kblais/query-filter: ^1.1

Requires (Dev)

• orchestra/testbench: ^3.2
• phpunit/phpunit: ^4.0

MIT

• Killian Blais

README

This package has been deprecated in favor of kblais/laravel-helpers.

Laravel-helpers is a collection of helpers for your Laravel application.

Installation

Require this package with Composer :

composer require startup-palace/laravel-helpers

List of helpers

SingularTableNameTrait

Use a singular table name instead of default plural table name.

Usage

Add the trait in your model :

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;
use StartupPalace\LaravelHelpers\Eloquent\SingularTableNameTrait;

class User extends Model
{
    use SingularTableNameTrait;
}

OrderByDefaultOrderTrait and OrderByDefaultOrderInterface

A global scope to apply a default order on your Eloquent model, and a trait you can use to define your default order directly in your model attributes.

Usage

namespace App;

use Illuminate\Database\Eloquent\Model;
use StartupPalace\LaravelHelpers\Eloquent\OrderByDefaultOrderTrait;
use StartupPalace\LaravelHelpers\Eloquent\OrderByDefaultOrderInterface;

class User extends Model implements OrderByDefaultOrderInterface
{
    use OrderByDefaultOrderTrait;

    public function getDefaultOrder()
    {
        /**
         * Defaults to
         * column: self::CREATED_AT
         * asc: true
         */
        return [
            'column' => 'last_login_at',
            'asc' => 'desc',
        ];
    }
}

RelationshipHelpers

A list of helpers for your Eloquent relations.

syncHasManyRelation

Synchronize a hasMany relation, deleting old items, updating existing and creating new ones.

Usage

Let's start from this model:

namespace App;

use App\Cat;
use Illuminate\Database\Eloquent\Model;
use StartupPalace\LaravelHelpers\Eloquent\RelationshipHelpersTrait;

class User extends Model
{
    use RelationshipHelpersTrait;

    protected $fillable = [
        'name', 'email', 'cats',
    ];

    protected static function boot()
    {
        parent::boot();

        self::saved(function ($user) {
            $user->syncHasManyRelation('cats');
        });
    }

    public function cats()
    {
        return $this->hasMany(Cat::class);
    }

    public function setCatsAttribute($cats)
    {
        $this->setHasManyItems('cats', $cats);
    }
}

Based on this, you can directly add cats to you user like that:

$user->create([
    'name' => 'John Doe',
    'email' => '[e-mail]',
    'cats' => [
        [
            'name' => 'Garfield',
            'color' => 'orange',
        ],
        [
            'number' => 'Fuzzy',
            'color' => 'yellow',
        ],
    ],
]);

When you update your model, if you pass a cats key, cats will automatically be created if not existing, updated, or deleted if not in your cats array.

syncHasOneRelation

Synchronize a hasOne relation, creating the new relation item or updating it.

Usage

namespace App;

use App\Cat;
use Illuminate\Database\Eloquent\Model;
use StartupPalace\LaravelHelpers\Eloquent\RelationshipHelpersTrait;

class User extends Model
{
    use RelationshipHelpersTrait;

    protected $fillable = [
        'name', 'email', 'address',
    ];

    protected static function boot()
    {
        parent::boot();

        self::saved(function ($user) {
            $user->syncHasOneRelation('address');
        });
    }

    public function address()
    {
        return $this->hasOne(Address::class);
    }

    public function setAddressAttribute($address)
    {
        $this->setHasOneItem('address', $address);
    }
}

To create your user with its address, you just need the following:

$user->create([
    'name' => 'John Doe',
    'email' => '[e-mail]',
    'address' = [
        'number' => '18',
        'street' => 'rue Scribe',
        'city' => 'Nantes',
        'country' => 'France',
    ],
]);

Passing an address array in your update() method will also update your user's address.

Routing\Middleware\AreRelated

The AreRelated middleware allows you to check if two route resources are related. It currently only works with HasOneOrMany/BelongsTo relations.

Usage

In your app/Http/Kernel.php, add the following line in the $routeMiddleware array:

'areRelated' => \StartupPalace\LaravelHelpers\Routing\Middleware\AreRelated::class,

Then, let's imagine we have two models Channel and Message:

use \Illuminate\Database\Model;

class Channel extends Model
{
    //
}

class Message extends Model
{
    public function channel()
    {
        return $this->belongsTo(Channel::class);
    }
}

And, in your routes:

Route::resource('channel.message', 'MessageController');

Because your resources and your relations have the same name (channel and message), you can add the middleware to your resource route to assure that the message you try to access belongs to it's channel:

Route::resource('channel.message', 'MessageController')
    ->middleware('areRelated:channel,message');