A console application for generating UUIDs with ramsey/uuid.

Fund package maintenance!

Installs: 74 566

Dependents: 6

Suggesters: 6

Security: 0

Stars: 32

Watchers: 2

Forks: 4

Open Issues: 0


1.1.4 2020-07-16 17:13 UTC

This package is auto-updated.

Last update: 2021-03-16 18:53:44 UTC


Source Code Latest Version Software License Build Status Coverage Status Total Downloads

ramsey/uuid-console is a console application for generating UUIDs with ramsey/uuid.

This project adheres to a Contributor Code of Conduct. By participating in this project and its community, you are expected to uphold this code.


The preferred method of installation is via Packagist and Composer.

composer require ramsey/uuid-console

This will install a reference to the console tool in ./vendor/bin/uuid.


If installed in your project, you may execute the console application from the command line:

$ ./vendor/bin/uuid

If installed globally using Composer, ensure your global Composer installation is in your PATH (it's usually somewhere like ~/.composer/vendor/bin). Then, you may execute it:

$ uuid

Please be aware that some systems may already have a command line application named uuid installed, so this might create a conflict if anything using your PATH expects the other uuid tool.

You can generate UUIDs:

$ ./vendor/bin/uuid generate

By default, the application generates version 1 (time-based) UUIDs, but you may specify other versions:

$ ./vendor/bin/uuid generate 4

You may also decode UUIDs to get information about them:

$ ./vendor/bin/uuid decode afe1296a-660b-11e5-bd9f-3c15c2caed47
 ========= ========== =========================================
  encode:   STR:       afe1296a-660b-11e5-bd9f-3c15c2caed47
            INT:       233784006064090443909084029429027106119
  decode:   variant:   RFC 4122
            version:   1 (time and node based)
            content:   time:  2015-09-28T18:06:49+00:00
                       clock: 15775 (usually random)
                       node:  3c:15:c2:ca:ed:47
 ========= ========== =========================================

For help, just type ./vendor/bin/uuid and read the help information.


Contributions are welcome! Please read CONTRIBUTING for details.

Copyright and License

The ramsey/uuid-console library is copyright © Ben Ramsey and licensed for use under the MIT License (MIT). Please see LICENSE for more information.