lepikhinb / laravel-fluent by lepikhinb

Define model attributes the fluent way. Automatically cast properties to native types.

12,184

543

Package Data
Maintainer Username:	lepikhinb
Maintainer Contact:	boris@lepikhin.com (Boris Lepikhin)
Package Create Date:	2021-08-23
Package Last Update:	2023-07-03
Language:	PHP
License:	MIT
Last Refreshed:	2024-05-07 03:00:35

Package Statistics
Total Downloads:	12,184
Monthly Downloads:	110
Daily Downloads:	2
Total Stars:	543
Total Watchers:	11
Total Forks:	23
Total Open Issues:	11

Laravel Fluent

The package provides an expressive "fluent" way to define model attributes. It automatically builds casts at the runtime and adds a native autocompletion to the models' properties.

Introduction

With laravel-fluent, you can define Model attributes as you would do with any other class. The values will be transformed to the corresponding types depending on the native types of the properties.

Before:

<?php

/**
 * @property Collection $features
 * @property float $price
 * @property int $available
 */
class Product extends Model
{
    protected $casts = [
        'features' => 'collection',
        'price' => 'float',
        'available' => 'integer',
    ];
}

After:

<?php

class Product extends Model
{
    use Fluent;

    public Collection $features;
    public float $price;
    public int $available;
}

Installation

This version supports PHP 8.0. You can install the package via composer:

composer require based/laravel-fluent

Then, add the Based\Fluent\Fluent trait to your models:

<?php

class User extends Model
{
    use Fluent;
}

Model attributes

Define the public properties. laravel-fluent supports all native types and Laravel primitive casts:

<?php

class Order extends Model
{
    use Fluent;

    public int $amount;
    public Carbon $expires_at;

    #[AsDecimal(2)]
    public float $total;

    #[Cast('encrypted:array')]
    public array $payload;
}

Relations

The package also handles relationships.

<?php

class Product extends Model
{
    use Fluent;

    #[Relation]
    public Collection $features;
    public Category $category;

    public function features(): HasMany
    {
        return $this->hasMany(Feature::class);
    }

    public function category(): BelongsTo
    {
        return $this->belongsTo(Category::class);
    }
}

Relations method declaration is still required for proper autocompletion. However, the package can automatically resolve relations from attributes.

<?php

class Product extends Model
{
    use Fluent;

    #[HasMany(Feature::class)]
    public Collection $features;
    #[BelongsTo]
    public Category $category;
}

Testing

composer test