kfoobar / laravel-uuid

v2.0.0 2026-09-21 12:17 UTC

Requires

• php: ^8.0
• illuminate/database: ^9.0|^10.0|^11.0|^12.0|^13.0
• illuminate/support: ^9.0|^10.0|^11.0|^12.0|^13.0
• ramsey/uuid: ^4.2.2

Requires (Dev)

• orchestra/testbench: ^7.0|^8.0|^9.0|^10.0|^11.0
• phpunit/phpunit: ^9.5.10|^10.1|^11.0|^12.0|^13.0

MIT

• KFoobar

Published on Packagist.org on 2026-09-21 12:30 UTC

README

Enhance your Laravel models with UUID functionality seamlessly using our trait, compatible with Laravel 9 and newer versions. Use version 1 for Laravel 5.6 to 8.

Installation Guide

Install the package through Composer with the following command:

composer require kfoobar/laravel-uuid

How to Use

To integrate UUIDs into your models, simply use the KFoobar\Uuid\Traits\HasUuid trait in your model class like so:

use Illuminate\Database\Eloquent\Model;
use KFoobar\Uuid\Traits\HasUuid;

class Post extends Model
{
    use HasUuid;
}

This will automatically generate a UUID for each new model instance.

Custom Column Name

The UUID is stored in the uuid column by default. To use another column, define a UUID constant on your model:

class Post extends Model
{
    use HasUuid;

    const UUID = 'public_id';
}

Contributing

We encourage contributions from the community! Whether it's improving the code, fixing bugs, or enhancing documentation, your input is valuable.

License

The MIT License (MIT). Please see License File for more information.