The HasAttributes trait

Add the HasAttributes trait and implement the matching contract on any model you want to attach attributes to:

use Illuminate\Database\Eloquent\Model;
use RoundlyConsulting\Attributes\Contracts\HasAttributes as HasAttributesContract;
use RoundlyConsulting\Attributes\Traits\HasAttributes;

class Product extends Model implements HasAttributesContract
{
    use HasAttributes;
}

Any Eloquent model works — products, users, orders, tickets. Attributes link through a polymorphic owner relation, so one table serves every model.

The relation

Stored rows are exposed as the attachedAttributes() morph-many relation. Mind the name: attributes() is the fluent writer, not the relation. Queries on the relation return an AttributeCollection with toKeyValue() and keyByName() helpers:

$product->attachedAttributes;                        // AttributeCollection of Attribute models
$product->attachedAttributes()->where('name', 'color')->first();

Product::query()->with('attachedAttributes')->get();  // eager load for cheap reads

Reading methods

Writing methods

The write methods are shorthand, not a separate path: each one delegates to Attributes::for($this), so host overrides and Attributes::fake() see them. Every writer returns the model, so calls chain; every forceDelete flag defaults to a soft delete. The contract requires attachedAttributes(), getAttachedAttributes(), getAttachedAttributeValue(), hasAttachedAttribute(), attr() and validateAttributes() — the trait provides them all. The query scopes are covered in Query scopes.