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

The recommended way to install the Uuid Generator is through Composer. Run the following command to install it:

php composer.phar require nilportugues/uuid

Usage is real simple, you can create your Uuid right away or under certain namespaces.

This is the most common case. Usage is straight-forward:

<?php
use NilPortugues\Uuid\Uuid;

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

First of all, the following namespaces exists:

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

Code-wise it's use can be defined using a constant.

<?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

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

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

To run the PHPUnit tests at the command line, go to the tests directory and issue phpunit.

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.

Nil Portugués Calderó

• [email protected]
• http://nilportugues.com

The code base is licensed under the MIT license.