PHPackages                             ramsey/uuid-console - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. ramsey/uuid-console

ActiveProject[CLI &amp; Console](/categories/cli)

ramsey/uuid-console
===================

A console application for generating UUIDs with ramsey/uuid.

2.0.0(3y ago)39151.2k↓15.2%9[3 PRs](https://github.com/ramsey/uuid-console/pulls)5MITPHPPHP ^7.4 || ^8.0

Since Sep 28Pushed 1y ago2 watchersCompare

[ Source](https://github.com/ramsey/uuid-console)[ Packagist](https://packagist.org/packages/ramsey/uuid-console)[ GitHub Sponsors](https://github.com/ramsey)[ Fund](https://tidelift.com/funding/github/packagist/ramsey/uuid)[ RSS](/packages/ramsey-uuid-console/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (9)Dependencies (18)Versions (12)Used By (5)

ramsey/uuid-console
===================

[](#ramseyuuid-console)

 **A console application for generating UUIDs with [ramsey/uuid](https://github.com/ramsey/uuid)**

 [![Source Code](https://camo.githubusercontent.com/1f810146443fef2c1aa2c70ce78e2b4cf03d13184d199ac7c2891a7a6c995a46/687474703a2f2f696d672e736869656c64732e696f2f62616467652f736f757263652d72616d7365792f757569642d2d636f6e736f6c652d626c75652e7376673f7374796c653d666c61742d737175617265)](https://github.com/ramsey/uuid-console) [![Download Package](https://camo.githubusercontent.com/f117e73e03d071a021cb53b76851576608543024b2837a4ea87cf9b3dff1e19d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f72616d7365792f757569642d636f6e736f6c652e7376673f7374796c653d666c61742d737175617265266c6162656c3d72656c65617365)](https://packagist.org/packages/ramsey/uuid-console) [![PHP Programming Language](https://camo.githubusercontent.com/9c1e1b41a4ba296a164c1e585c5eec2c35cf908dead92ff22622bec9a6922824/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f72616d7365792f757569642d636f6e736f6c652e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d253233383839324246)](https://php.net) [![Read License](https://camo.githubusercontent.com/68e510c2e750124fc46f737c03626fb0fd621ff72bf420ea883a1880adff9e29/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f72616d7365792f757569642d636f6e736f6c652e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d6461726b6379616e)](https://github.com/ramsey/uuid-console/blob/main/LICENSE) [![Build Status](https://camo.githubusercontent.com/3172bafa8917fdde6730932f3cca8788c7f6552a83d1f25c8e9c1c78809336e4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f72616d7365792f757569642d636f6e736f6c652f636f6e74696e756f75732d696e746567726174696f6e2e796d6c3f6272616e63683d6d61696e266c6f676f3d676974687562267374796c653d666c61742d737175617265)](https://github.com/ramsey/uuid-console/actions/workflows/continuous-integration.yml) [![Codecov Code Coverage](https://camo.githubusercontent.com/2b34b049bec79e040e5f279f74b6f984db73a0d0d321f3c660ff5e931f9e3be0/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f67682f72616d7365792f757569642d636f6e736f6c653f6c6162656c3d636f6465636f76266c6f676f3d636f6465636f76267374796c653d666c61742d737175617265)](https://codecov.io/gh/ramsey/uuid-console) [![Psalm Type Coverage](https://camo.githubusercontent.com/65ef4f98334e25223f4cbd7e046ced6dbd63dded0fc3ec2fa267a1c004009ffe/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f7374796c653d666c61742d7371756172652675726c3d687474707325334125324625324673686570686572642e64657625324667697468756225324672616d736579253246757569642d636f6e736f6c65253246636f766572616765)](https://shepherd.dev/github/ramsey/uuid-console)

About
-----

[](#about)

ramsey/uuid-console is a console application for generating UUIDs with [ramsey/uuid](https://github.com/ramsey/uuid).

This project adheres to a [code of conduct](CODE_OF_CONDUCT.md). By participating in this project and its community, you are expected to uphold this code.

Installation
------------

[](#installation)

Install this package as a dependency using [Composer](https://getcomposer.org).

```
composer require ramsey/uuid-console
```

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

Usage
-----

[](#usage)

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
afe1296a-660b-11e5-bd9f-3c15c2caed47

```

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

```
$ ./vendor/bin/uuid generate 4
54478f1d-8b9d-4bf9-8767-1a23010d48a7

```

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.

Contributing
------------

[](#contributing)

Contributions are welcome! To contribute, please familiarize yourself with [CONTRIBUTING.md](CONTRIBUTING.md).

Coordinated Disclosure
----------------------

[](#coordinated-disclosure)

Keeping user information safe and secure is a top priority, and we welcome the contribution of external security researchers. If you believe you've found a security issue in software that is maintained in this repository, please read [SECURITY.md](SECURITY.md) for instructions on submitting a vulnerability report.

Copyright and License
---------------------

[](#copyright-and-license)

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

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance27

Infrequent updates — may be unmaintained

Popularity45

Moderate usage in the ecosystem

Community28

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 64.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~330 days

Recently: every ~222 days

Total

9

Last Release

1244d ago

Major Versions

1.2.1 → 2.0.02022-12-21

PHP version history (3 changes)1.0.0PHP &gt;=5.4

1.1.3PHP ^5.4 || ^7 || ^8

2.0.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/f514481fa9cfdfd5dbcaccb3e5b480f18ea05ebf331cddf9b1c5a2a96a78fef5?d=identicon)[ramsey](/maintainers/ramsey)

---

Top Contributors

[![ramsey](https://avatars.githubusercontent.com/u/42941?v=4)](https://github.com/ramsey "ramsey (80 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (31 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (2 commits)")[![kewlar](https://avatars.githubusercontent.com/u/1241866?v=4)](https://github.com/kewlar "kewlar (1 commits)")[![Lewiscowles1986](https://avatars.githubusercontent.com/u/2605791?v=4)](https://github.com/Lewiscowles1986 "Lewiscowles1986 (1 commits)")[![martiis](https://avatars.githubusercontent.com/u/4210866?v=4)](https://github.com/martiis "martiis (1 commits)")[![ma-si](https://avatars.githubusercontent.com/u/1869327?v=4)](https://github.com/ma-si "ma-si (1 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")[![pkruithof](https://avatars.githubusercontent.com/u/330828?v=4)](https://github.com/pkruithof "pkruithof (1 commits)")[![sstok](https://avatars.githubusercontent.com/u/904790?v=4)](https://github.com/sstok "sstok (1 commits)")[![beryllium](https://avatars.githubusercontent.com/u/602491?v=4)](https://github.com/beryllium "beryllium (1 commits)")[![sunkan](https://avatars.githubusercontent.com/u/568492?v=4)](https://github.com/sunkan "sunkan (1 commits)")[![garak](https://avatars.githubusercontent.com/u/179866?v=4)](https://github.com/garak "garak (1 commits)")[![jmsfwk](https://avatars.githubusercontent.com/u/9892048?v=4)](https://github.com/jmsfwk "jmsfwk (1 commits)")

---

Tags

consoleconsole-toolguidphpphp7php8uuidcliconsoleuuididentifierguid

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ramsey-uuid-console/health.svg)

```
[![Health](https://phpackages.com/badges/ramsey-uuid-console/health.svg)](https://phpackages.com/packages/ramsey-uuid-console)
```

###  Alternatives

[nunomaduro/collision

Cli error handling for console/command-line PHP applications.

4.6k331.8M8.5k](/packages/nunomaduro-collision)[nunomaduro/termwind

It's like Tailwind CSS, but for the console.

2.5k239.8M286](/packages/nunomaduro-termwind)[helhum/typo3-console

A reliable and powerful command line interface for TYPO3 CMS

2939.0M192](/packages/helhum-typo3-console)[laravel-zero/framework

The Laravel Zero Framework.

3371.4M369](/packages/laravel-zero-framework)[buggregator/trap

A simple and powerful tool for debugging PHP applications.

2591.7M40](/packages/buggregator-trap)[laminas/laminas-cli

Command-line interface for Laminas projects

563.7M54](/packages/laminas-laminas-cli)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
