based / laravel-fluent
Define model attributes the fluent way. Automatically cast properties to native types.
Fund package maintenance!
lepikhinb
Installs: 12 713
Dependents: 0
Suggesters: 0
Security: 0
Stars: 548
Watchers: 11
Forks: 25
Open Issues: 11
Requires
- php: ^8.0
- illuminate/support: ^9.0
Requires (Dev)
- nunomaduro/larastan: ^2.1.10
- orchestra/testbench: ^7.5
- pestphp/pest: ^1.2
- pestphp/pest-plugin-laravel: ^1.2
README
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
Todo
- Migration generator
Credits
License
The MIT License (MIT). Please see License File for more information.