PHPackages                             vinhnguyen/eloquent-meta - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. vinhnguyen/eloquent-meta

ActiveLibrary[Database & ORM](/categories/database)

vinhnguyen/eloquent-meta
========================

Attach meta data to Eloquent models

v1.8.2(7y ago)131MITPHPPHP >=5.6.4

Since Aug 15Pushed 7y ago1 watchersCompare

[ Source](https://github.com/rnd-forests/eloquent-meta)[ Packagist](https://packagist.org/packages/vinhnguyen/eloquent-meta)[ Docs](https://github.com/phoenix-labs/eloquent-meta)[ RSS](/packages/vinhnguyen-eloquent-meta/feed)WikiDiscussions master Synced yesterday

READMEChangelog (2)Dependencies (8)Versions (22)Used By (0)

Phoenix Eloquent Meta
=====================

[](#phoenix-eloquent-meta)

[![Latest Version](https://camo.githubusercontent.com/29509f9ba66130258100549ff33e2c45c3263d01d6e5d3c6a2a3c62346138d07/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f63687269736d69636861656c7338342f656c6f7175656e742d6d6574612e7376673f7374796c653d666c61742d737175617265)](https://github.com/phoenix-labs/eloquent-meta/releases)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/1ba2cadd72f0cf9d5496b9d80db3e34c4c076d37994c06a001e8a4018c4df507/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f63687269736d69636861656c7338342f656c6f7175656e742d6d6574612f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/phoenix-labs/eloquent-meta)[![Total Downloads](https://camo.githubusercontent.com/1444e0c3f2cba2b2cbdf47e86d9a474cff031c7b5b72850cb0c6e1599ce0338b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f70686f656e69782f656c6f7175656e742d6d6574612e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/phoenix/eloquent-meta)

Attach meta data to [Laravel's](http://laravel.com/) [Eloquent models](http://laravel.com/docs/eloquent).

- Optionally create a separate table for each Model
- Use with or without Laravel
- Includes Laravel migrations or schema instructions
- Get meta or fallback

##### Which Version?

[](#which-version)

- Laravel 5.6 - use `1.8.*`
- Laravel 5.5 - use `1.7.*`
- Laravel 5.4 - Use `1.6.*`
- Laravel 5.3 - Use `1.5.*`
- Below 5.3 - Not technically supported, but should work with `.1.3`
- Laravel 4 - Also not supported, but should work with `1.2`

##### Stable Version: 1.4.\* works with Laravel 5.\* or independently. Pulls Eloquent in automatically.

[](#stable-version-14-works-with-laravel-5-or-independently-pulls-eloquent-in-automatically)

To use for Laravel 4, see version 1.2.\*

Installation
------------

[](#installation)

Install through Composer.

```
"require": {
    "phoenix/eloquent-meta": "1.6.*"
}
```

Please note only php `5.6` and `7`+ are supported.

If you are using EloquentMeta and Eloquent **without** using Laravel, you will also have to setup Eloquent as detailed in its [documentation](https://github.com/illuminate/database).

If you **are using Laravel**, then you'll want to include the ServiceProvider that will register commands and the like. Update `config/app.php` to include a reference to this package's service provider in the providers array.

```
'providers' => [
    'Phoenix\EloquentMeta\ServiceProvider'
]
```

### Table Structure

[](#table-structure)

If you are using Laravel, run the migration `php artisan vendor:publish` and `php artisan migrate` to create the database table.

If you **are not using Laravel** then you must create the table manually.

```
CREATE TABLE meta
(
    id INTEGER PRIMARY KEY NOT NULL,
    metable_id INTEGER NOT NULL,
    metable_type TEXT NOT NULL,
    key TEXT NOT NULL,
    value TEXT NOT NULL
);
CREATE UNIQUE INDEX meta_key_index ON meta (key);
CREATE UNIQUE INDEX meta_metable_id_index ON meta (metable_id);
```

Usage
-----

[](#usage)

Add the trait to all models that you want to attach meta data to:

```
use Illuminate\Database\Eloquent\Model;
use Phoenix\EloquentMeta\MetaTrait;

class SomeModel extends Model
{
    use MetaTrait;

    // model methods
}
```

Then use like this:

```
$model = SomeModel::find(1);
$model->getAllMeta();
$model->getMeta('some_key', 'optional default value'); // default value only returned if no meta found.
$model->updateMeta('some_key', 'New Value');
$model->deleteMeta('some_key');
$model->deleteAllMeta();
$model->addMeta('new_key', ['First Value']);
$model->appendMeta('new_key', 'Second Value');
```

### Unique Meta Models and Tables

[](#unique-meta-models-and-tables)

You can also define a specific meta model for a meta type. For instance, your User model can use UserMeta model with custom methods and all. Using the example above:

```
use Illuminate\Database\Eloquent\Model;
use Phoenix\EloquentMeta\MetaTrait;

class SomeModel extends Model
{
    use MetaTrait;

    protected $meta_model = 'Fully\Namespaced\SomeModelMeta';

    // model methods
}
```

Then in SomeModelMeta simply extends Phoenix\\EloquentMeta\\Meta. You may now add custom methods to the meta model. You may also dictate which table the metadata is saved to by adding

```
protected $table = "whatever_table";
```

If you are using EloquentMeta independent of Laravel, then you will have to create the database table manually.

If you are using Laravel, then include the service provider in your config/app.php

```
'providers' => [
    'Phoenix\EloquentMeta\ServiceProvider'
]
```

Then run `php artisan generate:metatable table_name` to create the migration and run `php artisan migrate` to build the table.

Contributing
------------

[](#contributing)

Please se \[CONTRIBUTING.md\] for more information and for testing.

### Thank you and Credits

[](#thank-you-and-credits)

Contributors

- Michael Wilson - @[chrismichaels84](http://github.com/chrismichaels84) - Maintainer
- Paweł Ciesielski - @[dzafel](http://github.com/dzafel)
- Lukas Knuth - @[LukasKnuth](http://github.com/LukasKnuth)
- @[stephandesouza](http://github.com/stephandesouza)

Many thanks to [Boris Glumpler](https://github.com/shabushabu) and [ScubaClick](https://github.com/ScubaClick) for the original package!

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 73.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~103 days

Recently: every ~159 days

Total

17

Last Release

2632d ago

PHP version history (2 changes)v1.2.0PHP >=5.4.0

v1.8.0PHP >=5.6.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/243963bb546e9f8c12e1357b752c04bfbdc4435b20ea8c4f37acfb98d7c4d001?d=identicon)[vinhnguyentb](/maintainers/vinhnguyentb)

---

Top Contributors

[![electricjones](https://avatars.githubusercontent.com/u/5412413?v=4)](https://github.com/electricjones "electricjones (28 commits)")[![dzafel](https://avatars.githubusercontent.com/u/765607?v=4)](https://github.com/dzafel "dzafel (4 commits)")[![clin407](https://avatars.githubusercontent.com/u/718052?v=4)](https://github.com/clin407 "clin407 (2 commits)")[![rnd-forests](https://avatars.githubusercontent.com/u/5989866?v=4)](https://github.com/rnd-forests "rnd-forests (2 commits)")[![LukasKnuth](https://avatars.githubusercontent.com/u/692211?v=4)](https://github.com/LukasKnuth "LukasKnuth (1 commits)")[![Vasiliy-Bondarenko](https://avatars.githubusercontent.com/u/5263184?v=4)](https://github.com/Vasiliy-Bondarenko "Vasiliy-Bondarenko (1 commits)")

---

Tags

laraveleloquentmeta

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vinhnguyen-eloquent-meta/health.svg)

```
[![Health](https://phpackages.com/badges/vinhnguyen-eloquent-meta/health.svg)](https://phpackages.com/packages/vinhnguyen-eloquent-meta)
```

###  Alternatives

[watson/validating

Eloquent model validating trait.

9723.3M47](/packages/watson-validating)[tucker-eric/eloquentfilter

An Eloquent way to filter Eloquent Models

1.8k4.8M26](/packages/tucker-eric-eloquentfilter)[yajra/laravel-oci8

Oracle DB driver for Laravel via OCI8

8703.0M17](/packages/yajra-laravel-oci8)[cybercog/laravel-love

Make Laravel Eloquent models reactable with any type of emotions in a minutes!

1.2k302.7k1](/packages/cybercog-laravel-love)[cviebrock/eloquent-taggable

Easy ability to tag your Eloquent models in Laravel.

567694.8k3](/packages/cviebrock-eloquent-taggable)[reedware/laravel-relation-joins

Adds the ability to join on a relationship by name.

2121.2M13](/packages/reedware-laravel-relation-joins)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)