saade/laravel-uuid

A small package for adding UUIDs to Eloquent models.

v2.0.1 2025-02-28 17:39 UTC

Requires

• php: ^8.0
• illuminate/contracts: ^9.0|^10.0|^11.0|^12.0
• spatie/laravel-package-tools: ^1.11.0

Requires (Dev)

• brianium/paratest: ^6.2
• nunomaduro/collision: ^6.0|^7.0|^8.0
• orchestra/testbench: ^7.0|^8.0|^9.0|^10.0
• phpunit/phpunit: ^9.3
• spatie/laravel-ray: ^1.23

MIT

• Saade

• laravel
• laravel-uuid
• saade

README

Caution

This package is a fork of saade/laravel-uuid (which is no longer maintained) to keep old projects still alive.

Laravel now has first-party support for generating UUIDs and ULIDs on Eloquent models, you should use that instead.

This package will not receive any new features or updates, only compatibility fixes.

Installation

You can install the package via composer:

composer require saade/laravel-uuid

Usage

There are 2 methods for applying automatic UUID generation to your models:

1. Applying a trait

Add the Saade\Uuid\Concerns\HasUuid trait to your model:

class Post extends Model
{
    use \Saade\Uuid\Concerns\HasUuid;
}

This will automatically assign a time-ordered UUID to the uuid column on your model. UUIDs are generated using the Str::orderedUuid() method provided by Laravel.

If you wish to change the column that is used, you can define a uuidColumn method on your model:

class Post extends Model
{
    use \Saade\Uuid\Concerns\HasUuid;

    public function uuidColumn(): string
    {
        return 'guid';
    }
}

findByUuid & findByUuidOrFail

You can use the Model::findByUuid and Model::findByUuidOrFail methods to quickly retrieve a model from it's UUID. These behave the same way as Model::find and Model::findOrFail.

2. Mass-registration in ServiceProvider

If you want to use the defaults and would like to avoid adding more traits to your model, you can mass-register your models in the boot method of a ServiceProvider.

use Saade\Uuid\Uuid;

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        Uuid::generateFor([
            \App\Models\Post::class,
        ]);
    }
}

Using the UUID in route definitions

If you want to use your uuid column as the default route-model binding column, you can implement the Saade\Uuid\Contracts\WithUuidRouteKey contract on your model.

This will force the HasUuid trait to use the uuid column as the return value of getRouteKeyName which Laravel uses to determine how to receive a model for implicit route-model binding.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Ryan Chandler - Original author
• All Contributors

License

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