Skip to content

The laravel-attributes package allows Laravel developers to easily add and manage custom attributes on Eloquent models

License

Notifications You must be signed in to change notification settings

milwad-dev/laravel-attributes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Laravel Attributes

Laravel-Attributes

Latest Stable Version Total Downloads License Passed Tests PHP Version Require


The laravel-attributes package is a tool designed to help Laravel developers easily manage and implement custom attributes in their projects. It enables you to define attributes directly on Eloquent models, making it simpler to handle dynamic or calculated properties without directly modifying the database schema. With this package, you can create and configure attribute sets for models, making it easier to organize and extend data handling in Laravel applications. It's especially useful for projects that require customizable and flexible data models.
You don't have any stress for attributes! You can create attributes for any model and display like drink water :)

Requirements


  • PHP: ^8.0
  • Laravel Framework: ^9.0
Attributes L9 L10
1.0

Installation


composer require milwad/laravel-attributes

After publish config files.

php artisan vendor:publish --provider="Milwad\LaravelAttributes\LaravelAttributesServiceProvider"

After publish, you migrate the migration file.

php artisan migrate

Usage

First, you use trait in model.

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Milwad\LaravelAttributes\Traits\Attributable;

class Product extends Model
{
    use HasFactory, Attributable;
}

After, you have access to attributes relation and etc... .

Save attribute

If you want to attach attribute to a model, you can use attachAttribute method.
attachAttribute method take a title and value.

$product = Product::query()->create([
    'name' => 'milwad',
    'content' => 'laravel attributes',
]);

$product->attachAttribute('age', '17');

Save attribute multiple

If you have multiple attributes you can use attachAttributes method to save attributes for a model.

$product = Product::query()->create([
    'name' => 'milwad',
    'content' => 'text',
]);

$data = [
    [
        'title' => 'milwad',
        'value' => 'developer',
    ],
    [
        'title' => 'milwad2',
        'value' => 'developer2',
    ],
    [
        'title' => 'milwad3',
        'value' => 'developer3',
    ],
    [
        'title' => 'milwad4',
        'value' => 'developer4',
    ],
    [
        'title' => 'milwad5',
        'value' => 'developer5',
    ],
    [
        'title' => 'milwad6',
        'value' => 'developer6',
    ],
];

$product->attachAttributes($data);

Get attributes with query

If you want to retrieve attributes from relation you can use attributes.

$product = Product::query()->with('attributes')->get();

$product->attributes

Check attribute value is exists

Maybe you want to check one model has an attribute value you can use hasAttributeValue method.

if ($product->hasAttributeValue('17')) {
    return 'attribute value';
}

return 'no attribute value';

Check attribute value is exists

Maybe you want to check one model has an attribute title you can use hasAttributeTitle method.

if ($product->hasAttributeTitle('milwad')) {
    return 'attribute title';
}

return 'no attribute title';

Delete all attributes

If you want to delete all attributes of one model you can use deleteAllAttribute method.

$product->deleteAllAttribute();

Delete special attributes

If you want to delete specific attribute of a model you can use deleteAttribute method.

$product->deleteAttribute('title', 'value');

Delete special attributes by title

If you want to delete specific attribute by title you can use deleteAttributeByTitle method.

Maybe you have two attributes with same title, if you delete with this method, will be deleted two attributes

$product->deleteAttributeByTitle('title');

Delete special attributes by value

If you want to delete specific attribute by value you can use deleteAttributeByValue method.

Maybe you have two attributes with same value, if you delete with this method, will be deleted two attributes

$product->deleteAttributeByValue('value');

Testing

Run the tests with:

vendor/bin/pest
composer test
composer test-coverage

Customize

If you want change migration table name or change default model you can use laravel-attributes config that exists in config folder.

<?php

return [
    /*
     * Table config
     *
     * Here it's a config of migrations.
     */
    'tables' => [
        /*
         * Get table name of migration.
         */
        'name' => 'attributes',

        /*
         * Use uuid as primary key.
         */
        'uuids' => false, // Also in beta !!!
    ],

    /*
     * Model class name for attributes table.
     */
    'attributes_model' => \Milwad\LaravelAttributes\Attribute::class,
];

License

  • This package is created and modified by Milwad Khosravi for Laravel >= 9 and is released under the MIT License.

Contributing

This project exists thanks to all the people who contribute. CONTRIBUTING

Security

If you've found a bug regarding security please mail [email protected] instead of using the issue tracker.

Donate

If this package is helpful for you, you can buy a coffee for me :) ❤️