cbschuld/php-uuid-base58

Generates a RFC4122 compliant v4 UUID and returns it encoded in base-58. This is great for creating unique IDs which only consume 22 characters of storage. Also provides base-58 encoding and decoding.

1.0.1 2020-04-11 01:05 UTC

This package is auto-updated.

Last update: 2024-03-11 13:15:41 UTC


README

68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6362736368756c642f7068702d757569642d6261736535382f6d61737465723f7374796c653d666c61742d737175617265 68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6362736368756c642f7068702d757569642d6261736535383f7374796c653d666c61742d737175617265 68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6362736368756c642f7068702d757569642d6261736535383f7374796c653d666c61742d737175617265

Generates a RFC4122 compliant v4 UUID and returns it encoded in base-58. This is great for creating unique IDs which only consume 22 characters of storage. Also provides base-58 encoding and decoding.

Installation

composer require cbschuld/php-uuid-base58

Usage

use cbschuld\UuidBase58;

$id = UuidBase58::id();

API

The UuidBase58 class provides three static functions

  • id - creates the RFC4122 v4 UUID encoded in base-58
  • encode(string) - encodes a base-16 string in base-58
  • decode(string) - decodes a string from base-58 to base-16

Testing

npm run test

Performance Hit

There is an additional performance hit to translate a v4 UUID into base58. In testing I found the overhead for the translation to base58 adds an additional 31%. In 100k calculation batches I found that v4 uuid calculation took 1.606s/100k vs 2.319s/100k for uuid58. Thus, 69% of the runtime was consumed calculating a v4 uuid. Additional work could be done to bring the uuid calculation internal and attempt to increase performance.

Base58 Alphabet

This solution uses the Bitcoin / IPFS hash alphabet: 123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz

Additional information on Base-58.

Contact

Twitter - @cbschuld

Contributing

Yes, thank you! Please update the docs and tests and add your name to the package.json file.