README

Auto-generates a UUID v4 on model creation, sets it as the route key, and provides a query scope for UUID lookups.

Installation

composer require centrex/laravel-uuid

$table->uuid('uuid')->unique();

use Centrex\LaravelUuid\HasUuid;

class Order extends Model
{
    use HasUuid;
}

A UUID is automatically generated on creating if the uuid column is present and empty.

The trait overrides getRouteKeyName() to return 'uuid', so route model binding works out of the box:

// routes/web.php
Route::get('/orders/{order}', [OrderController::class, 'show']);
// URL: /orders/550e8400-e29b-41d4-a716-446655440000

Order::uuid('550e8400-e29b-41d4-a716-446655440000')->first();

Override $uuid_column on the model or publish the config:

class Order extends Model
{
    use HasUuid;

    protected $uuid_column = 'public_id';
}

php artisan vendor:publish --tag="laravel-uuid-config"

composer test        # full suite
composer test:unit   # pest only
composer test:types  # phpstan
composer lint        # pint