Laravel Metadata

A PHP package for Laravel

Laravel Metadata is a lightweight PHP package that helps you to handle extra data on your models without adding any new fields on your database table.

In many of my Laravel projects I had the need to store less relevant data and, instead of creating dozens of fields, I took inspiration from wordpress and how it handles metadata.

Thanks to the power of the Laravel polymorphism relations, the laravel-metadata package uses just one table for handling the metadata for all your models. What you have to do is just import a trait in your model.

If you take a look at the source code of the package you will see how simple and light is code.

Installation

Open the terminal in your laravel project and install the package below via composer:

composer require danielefavi/metadata

Then open the file config/app.php and add the entry DanieleFavi\Metadata\MetaServiceProvider::class in the providers section:

'providers' => [
    // ...
    DanieleFavi\Metadata\MetaServiceProvider::class,
],

Then run the migration:

php artisan migrate

Import the metadata trait into your model

After installing the package you have to add the trait HasMetadata in your model.

For example:

use DanieleFavi\Metadata\HasMetadata; // to add in your model

class User extends Authenticatable
{
    use HasFactory;
    use HasMetadata; // to add in your model
    
    // ...
}

Now your model has all the methods to handle the metadata.

Examples

Saving the metadata

Using the method saveMeta you can save (store or update) a metadata:

$user->saveMeta('phone_number', '111222333'); // storing a value
$user->saveMeta('color_preference', ['orange', 'yellow']); // storing an array

Getting the metadata

The method getMeta retrieve the metadata for the given key:

$phoneNumber = $user->getMeta('phone_number');

// Default value in case the metadata has not been found (default: null)
$anotherMeta = $user->getMeta('another_meta', 10);

You can retrieve the metadata in bulk using the getMetas method. The function getMetas returns an array key-value containing the specified metadata key; for example:

$metas = $user->getMetas(['phone_number', 'address']);

The $metas of the example above is going to have the following result:

[
    'phone_number' => '111222333',
    'address' => '29 Arlington Avenue'
]

If you instead want to get all the metadata just use $user->getMetas();

The list of methods goes on! You can find the list and examples on the github repository page _

Related Articles

Fluent API PHP Class

Category: PHP

What is the fluent api? How to apply this design pattern in PHP? How to call a method both statically and not? Let's discover it!

WP Social Importer

Category: tools

WP Social Importer is a wordpress plugin that imports news from Facebook, Instagram, Twitter into your website. This plugin transforms automatically the news from your social networks into wordpress ...

Brainy: a simple PHP class for machine learning

Category: resources

Brainy is a PHP class that helps you to create your neural network. I built Brainy just for fun during my artificial intelligence studies. If you are a web developer and you have just started ...

Matrix arithmetic PHP Class

Category: resources

During my studies in AI I wanted to solve the XOR problem; I wanted just to do a quick test so I started writing the code in PHP. Solving that problem I ended up to write a class that handles matrix ...

Coming soon page

Category: resources

If you need a coming soon page, don't waste your time on developing it because you are going to use it for a short period. This coming soon page has a minimal design and it's made with PHP, HTML and ...

Wordpress Empty Plugin

Category: resources

When I have to create a new Wordpress functionality I always use an empty plugin to start with. Here I'm going to explain how to develop your Wordpress plugin. If you are not interested in this ...