ramsey/uuid
A PHP library for generating and working with universally unique identifiers (UUIDs).
Maintainers
Requires
- php: ^8.0
- brick/math: >=0.8.16 <=0.18
- ramsey/collection: ^1.2 || ^2.0
Requires (Dev)
- captainhook/captainhook: ^5.25
- captainhook/plugin-composer: ^5.3
- dealerdirect/phpcodesniffer-composer-installer: ^1.0
- ergebnis/composer-normalize: ^2.47
- mockery/mockery: ^1.6
- paragonie/random-lib: ^2
- php-mock/php-mock: ^2.6
- php-mock/php-mock-mockery: ^1.5
- php-parallel-lint/php-parallel-lint: ^1.4.0
- phpbench/phpbench: ^1.2.14
- phpstan/extension-installer: ^1.4
- phpstan/phpstan: ^2.1
- phpstan/phpstan-mockery: ^2.0
- phpstan/phpstan-phpunit: ^2.0
- phpunit/phpunit: ^9.6
- slevomat/coding-standard: ^8.18
- squizlabs/php_codesniffer: ^3.13
Suggests
- ext-bcmath: Enables faster math with arbitrary-precision integers using BCMath.
- ext-gmp: Enables faster math with arbitrary-precision integers using GMP.
- ext-uuid: Enables the use of PeclUuidTimeGenerator and PeclUuidRandomGenerator.
- paragonie/random-lib: Provides RandomLib for use with the RandomLibAdapter
- ramsey/uuid-doctrine: Allows the use of Ramsey\Uuid\Uuid as Doctrine field type.
Provides
None
Conflicts
None
Replaces
- rhumsaa/uuid: 4.9.3
MIT 1df15849d00943a67d677dc9cfd80795f038c9f8
This package is auto-updated.
Last update: 2026-06-18 04:04:58 UTC
README
A PHP library for generating and working with UUIDs.
👁 Source Code
👁 Download Package
👁 PHP Programming Language
👁 Read License
👁 Build Status
👁 Codecov Code Coverage
ramsey/uuid is a PHP library for generating and working with universally unique identifiers (UUIDs).
This project adheres to a code of conduct. By participating in this project and its community, you are expected to uphold this code.
Much inspiration for this library came from the Java and Python UUID libraries.
Installation
The preferred method of installation is via Composer. Run the following
command to install the package and add it as a requirement to your project's
composer.json:
composer require ramsey/uuid
Upgrading to Version 4
See the documentation for a thorough upgrade guide:
Documentation
Please see https://uuid.ramsey.dev for documentation, tips, examples, and frequently asked questions.
Contributing
Contributions are welcome! To contribute, please familiarize yourself with CONTRIBUTING.md.
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 for instructions on submitting a vulnerability report.
ramsey/uuid for Enterprise
Available as part of the Tidelift Subscription.
The maintainers of ramsey/uuid and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use. Learn more.
Copyright and License
The ramsey/uuid library is copyright © Ben Ramsey and licensed for use under the MIT License (MIT). Please see LICENSE for more information.