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)39156.6k↓49.4%9[2 PRs](https://github.com/ramsey/uuid-console/pulls)5MITPHPPHP ^7.4 || ^8.0CI passing

Since Sep 28Pushed 2mo 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 2d 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

54

—

FairBetter than 96% of packages

Maintenance57

Moderate activity, may be stable

Popularity45

Moderate usage in the ecosystem

Community28

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 64% 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

1290d 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)")[![rodrigoprimo](https://avatars.githubusercontent.com/u/77215?v=4)](https://github.com/rodrigoprimo "rodrigoprimo (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

[laravel/framework

The Laravel Framework.

34.8k543.8M20.1k](/packages/laravel-framework)[psy/psysh

An interactive shell for modern PHP.

9.8k582.3M821](/packages/psy-psysh)[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.2k95.4M306](/packages/laravel-horizon)[nunomaduro/collision

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

4.7k357.7M11.1k](/packages/nunomaduro-collision)[buggregator/trap

A simple and powerful tool for debugging PHP applications.

2702.2M67](/packages/buggregator-trap)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)

PHPackages © 2026

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