Download the PHP package webpatser/laravel-uuid without Composer
On this page you can find all versions of the php package webpatser/laravel-uuid. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download webpatser/laravel-uuid
More information about webpatser/laravel-uuid
Files in webpatser/laravel-uuid
Package laravel-uuid
Short Description Laravel package to generate and to validate a universally unique identifier (UUID) according to the RFC 4122 standard. Support for version 1, 3, 4 and 5 UUIDs are built-in.
License MIT
Homepage https://github.com/webpatser/laravel-uuid
Informations about the package laravel-uuid
Laravel Uuid
Laravel package to generate and to validate a universally unique identifier (UUID) according to the RFC 4122 standard. Support for version 1, 3, 4 and 5 UUIDs are built-in.
What's new in 4.*
Laravel-uuid is now ready for Laravel 8. It has the same requirements so that means PHP 7.3 or PHP 8. Laravel package auto-discovery is enabled, and you can now use the UUID validation. Validation examples are below and in the tests.
For older Laravel or PHP versions use older versions; see below...
What's new in 3.*
Laravel-uuid is now refactored for Laravel 5.5. It has the same requirements so that means PHP 7. Laravel package auto-discovery is enabled, and you can now use the UUID validation. Validation examples are below and in the tests.
Laravel 5.0, 5.1, 5.2, 5.3 and 5.4? use version 2
Laravel 4.*? use version 1
Installation
In Laravel 5.5 laravel-uuid will install via the new package discovery feature so you only need to add the package to your composer.json file
after installation you should see
and you are ready to go
Basic Usage
To quickly generate a UUID just do
This will generate a version 1 Uuid object
with a random generated MAC address.
To echo out the generated UUID, cast it to a string
or
Advanced Usage
UUID creation
Generate a version 1, time-based, UUID. You can set the optional node to the MAC address. If not supplied it will generate a random MAC address.
Generate a version 3, name-based using MD5 hashing, UUID
Generate a version 4, truly random, UUID
Generate a version 5, name-based using SHA-1 hashing, UUID
Some magic features
To import a UUID
Extract the time for a time-based UUID (version 1)
Extract the version of an UUID
Eloquent UUID generation
If you want an UUID magically be generated in your Laravel models, just add this boot method to your Model.
This will generate a version 4 UUID when creating a new record.
Model binding to UUID instead of primary key
If you want to use the UUID in URLs instead of the primary key, you can add this to your model (where 'uuid' is the column name to store the UUID)
When you inject the model on your resource controller methods you get the correct record
Validation
Just use like any other Laravel validator.
'uuid-field' => 'uuid'
Or create a validator from scratch. In the example an Uuid object in validated. You can also validate strings $uuid->string
, the URN $uuid->urn
or the binary value $uuid->bytes
Notes
Full details on the UUID specification can be found on http://tools.ietf.org/html/rfc4122.