nilportugues/uuid

Library to encapsulate the latest and more secure Uuid versions

, _(*1)

Uuid Generator

This class' intent is to encapsulate Uuid's latest and more secure versions removing the need to explicitly hard-code a Uuid version everywhere., _(*2)

1. Installation

The recommended way to install the Uuid Generator is through Composer. Run the following command to install it:, _(*3)

php composer.phar require nilportugues/uuid

2. Usage

Usage is real simple, you can create your Uuid right away or under certain namespaces., _(*4)

2.1. Without namespacing

This is the most common case. Usage is straight-forward:, _(*5)

<?php
use NilPortugues\Uuid\Uuid;

echo Uuid::create(); // "13dfa123-d7a6-4082-8b3f-513c28f5d691"

2.2. With namespacing

First of all, the following namespaces exists:, _(*6)

• DNS Namespace
• URL Namespace
• OID (Object Id) Namespace
• X500 Namespace

Code-wise it's use can be defined using a constant., _(*7)

<?php
use NilPortugues\Uuid\Uuid;

echo Uuid::create(Uuid::NAMESPACE_DNS, 'nilportugues.com');

echo Uuid::create(Uuid::NAMESPACE_URL, 'http://nilportugues.com/robots.txt');

echo Uuid::create(Uuid::NAMESPACE_OID, 'Foo\Bar');

echo Uuid::create(Uuid::NAMESPACE_X500, '/c=us/o=Sun/ou=People/cn=Rosanna Lee');

More on its usage can be found here: http://tools.ietf.org/html/rfc4122#appendix-C, _(*8)

2.3. Uuid versions

Currently Uuid has 5 versions and while all of them are valid, usage of newest versions is always preferred. Lastest preferred versions are:, _(*9)

• Uuid4 preferred over Uuid1.
• Uuid5 preferred over Uuid3 and Uuid1

3. Quality

To run the PHPUnit tests at the command line, go to the tests directory and issue phpunit., _(*10)

This library attempts to comply with PSR-1, PSR-2, and PSR-4. If you notice compliance oversights, please send a patch via pull request., _(*11)

4. Author ↑

Nil Portugués Calderó, _(*12)

• contact@nilportugues.com
• http://nilportugues.com

5. License ↑

The code base is licensed under the MIT license., _(*13)