lekoala/silverstripe-uuid

Uuid data extension for SilverStripe

SilverStripe Uuid module

, _(*1)

, _(*2)

Easily add uuid to your DataObjects, _(*3)

Getting started

Simply add the extension to your DataObject, _(*4)

MyDataObject:
  extensions:
    - LeKoala\Uuid\UuidExtension

Call UuidExtension::getByUuid(MyDataObject::class, $uuid) to retrieve the record by Uuid. Since that's really ugly, you can also use the HasUuid trait on your classes to return a properly type hinted class., _(*5)

Usage in templates

In your templates, use UuidSegment to ensure Uuid value is generated on the record. UuidSegment are base62 encoded in order to be shorter and more readable., _(*6)

Getting readable values

Since Uuid's are stored in binary format for performance reason, you need to call $myObject->dbObject('Uuid')->Nice() to get a readable value., _(*7)

Upgrade to Ramsey v4

If you happen to upgrade from previous versions you might want to check this guide, _(*8)

TODO

• Postgres compat

Worth reading

Storing UUID Values in MySQL GUID/UUID Performance Laravel: The mysterious “Ordered UUID”: offer a good overview of the situation although it's a bit laravel specific, _(*9)

Compatibility

Tested with 4.4 and up, _(*10)

Maintainer

LeKoala - thomas@lekoala.be, _(*11)