2017 © Pedro Peláez
 

library laravel-model-uuid

This package allows you to easily work with UUIDs in your Laravel models.

image

dyrynda/laravel-model-uuid

This package allows you to easily work with UUIDs in your Laravel models.

  • Wednesday, June 20, 2018
  • by michaeldyrynda
  • Repository
  • 7 Watchers
  • 119 Stars
  • 3,587 Installations
  • PHP
  • 0 Dependents
  • 1 Suggesters
  • 8 Forks
  • 1 Open issues
  • 15 Versions
  • 26 % Grown

The README.md

Laravel Model UUIDs

Build Status Scrutinizer Code Quality Code Coverage Latest Stable Version Total Downloads License Dependency Status Buy us a tree, (*1)

Introduction

I find myself using UUID across multiple projects of late, and packaged up this functionality rather than copying and pasting it from project to project., (*2)

Note: this package explicitly does not disable auto-incrementing on your Eloquent models. In terms of database indexing, it is generally more efficient to use auto-incrementing integers for your internal querying. Indexing your uuid column will make lookups against that column fast, without impacting queries between related models., (*3)

For more information, check out this post on storing and working with UUID in an optimised manner., (*4)

Take a look at laravel-efficient-uuid if you want to make it easy to generate migrations that efficiently store UUID in your database., (*5)

This package supports time-ordered UUIDs in Laravel 5.6 as of version 4.0.0., (*6)

Code Samples

In order to use this package, you simply need to import and use the trait within your Eloquent models., (*7)

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;
use Dyrynda\Database\Support\GeneratesUuid;

class Post extends Model
{
    use GeneratesUuid;
}

It is assumed that you already have a field named uuid in your database, which is used to store the generated value. If you wish to use a custom column name, for example if you want your primary id column to be a UUID, you can define a uuidColumn method in your model., (*8)

class Post extends Model
{
    public function uuidColumn(): string
    {
        return 'custom_column';
    }
}

You can have multiple UUID columns in each table by specifying an array in the uuidColumns method. When querying using the whereUuid scope, the default column - specified by uuidColumn will be used., (*9)

class Post extends Model
{
    public function uuidColumns(): array
    {
        return ['uuid', 'custom_column'];
    }
}

By default, this package will use UUID version 4 values, however, you are welcome to use uuid1, uuid3, uuid4, or uuid5 by specifying the protected property $uuidVersion in your model. Should you wish to take advantage of ordered UUID (version 4) values that were introduced in Laravel 5.6, you should specify ordered as the $uuidVersion in your model., (*10)

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;
use Dyrynda\Database\Support\GeneratesUuid;

class Post extends Model
{
    use GeneratesUuid;

    protected $uuidVersion = 'uuid5';
}

This trait also provides a query scope which will allow you to easily find your records based on their UUID, and respects any custom field name you choose., (*11)

// Find a specific post with the default (uuid) column name
$post = Post::whereUuid($uuid)->first();

// Find multiple posts with the default (uuid) column name
$post = Post::whereUuid([$first, $second])->get();

// Find a specific post with a custom column name
$post = Post::whereUuid($uuid, 'custom_column')->first();

// Find multiple posts with a custom column name
$post = Post::whereUuid([$first, $second], 'custom_column')->get();

If you use the suggested laravel-efficient-uuid package, you will need to add a cast to your model in order to correctly set and retrieve your UUID values. This will ensure your UUIDs are written to your (MySQL) database as binary and presented as strings., (*12)

<?php

namespace App;

use Dyrynda\Database\Casts\EfficientUuid;
use Dyrynda\Database\Support\GeneratesUuid;
use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    use GeneratesUuid;

    protected $casts = [
        'uuid' => EfficientUuid::class,
    ];
}

Route model binding

Should you wish to leverage implicit route model binding on your uuid field, you'll need to override the getRouteKeyName method in your Eloquent model., (*13)

public function getRouteKeyName()
{
    return 'uuid';
}

If you are using the laravel-efficient-uuid package, implicit route model binding won't work out of the box., (*14)

Laravel will execute the query using the string representation of the uuid field when querying against the binary data stored in the database. In this instance, you will need to explicitly bind the parameter using the included scope in your RouteServiceProvider:, (*15)

// app/Providers/RouteServiceProvider.php

public function boot()
{
    Route::bind('post', function ($post) {
        return \App\Post::whereUuid($post)->first();
    });
}

Installation

This package is installed via Composer. To install, run the following command., (*16)

composer require dyrynda/laravel-model-uuid

Support

If you are having general issues with this package, feel free to contact me on Twitter., (*17)

If you believe you have found an issue, please report it using the GitHub issue tracker, or better yet, fork the repository and submit a pull request., (*18)

If you're using this package, I'd love to hear your thoughts. Thanks!, (*19)

Treeware

You're free to use this package, but if it makes it to your production environment you are required to buy the world a tree., (*20)

It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to plant trees. If you support this package and contribute to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats., (*21)

You can buy trees here, (*22)

Read more about Treeware at treeware.earth, (*23)

The Versions

20/06 2018

dev-master

9999999-dev

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

laravel uuid eloquent model

20/06 2018

4.0.1

4.0.1.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

laravel uuid eloquent model

20/06 2018

dev-feature/configurable-uuid-column-name

dev-feature/configurable-uuid-column-name

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

laravel uuid eloquent model

01/03 2018

4.0.0

4.0.0.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

laravel uuid eloquent model

01/03 2018

dev-feature/ordered-uuid-support

dev-feature/ordered-uuid-support

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

laravel uuid eloquent model

01/03 2018

dev-analysis-qxpA2B

dev-analysis-qxpA2B

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

laravel uuid eloquent model

24/02 2018

3.1.1

3.1.1.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

laravel uuid eloquent model

14/02 2018

3.1.0

3.1.0.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

laravel uuid eloquent model

31/08 2017

3.0.0

3.0.0.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

laravel uuid eloquent model

18/07 2017

2.0.3

2.0.3.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

laravel uuid eloquent model

05/04 2017

2.0.2

2.0.2.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

30/03 2017

2.0.1

2.0.1.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

30/03 2017

2.0.0

2.0.0.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

29/03 2017

1.0.1

1.0.1.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda

28/03 2017

1.0.0

1.0.0.0

This package allows you to easily work with UUIDs in your Laravel models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Dyrynda