uuid README

The project's README from github.com/ramsey/uuid. As one markdown file: README.md.

ramsey/uuid

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.

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

uuid (ramsey/uuid)

Searching Database…

12.6K ·GitHub
Что это такое?Это PHP-библиотека для генерации и работы с универсальными уникальными идентификаторами (UUID) — это 128-битные идентификаторы, которыми можно помечать записи и объекты без всякой центральной координации.
Это отдельное приложение или то, что я подключаю в свой PHP-код?Это библиотека, а не запускаемое приложение: вы добавляете её как зависимость в composer.json своего проекта и вызываете из собственного кода.
Какая версия PHP мне нужна?Ориентирована на современный PHP — репозиторий помечен тегами php и php8, — а точные ограничения по поддерживаемым версиям объявлены в composer.json, чтобы Composer разрешил их при установке.
Я всё ещё на версии 3 — насколько болезненным будет переход на версию 4?Между мажорными версиями стоит ожидать несовместимых изменений: в документации есть отдельный подробный гид по обновлению именно для миграции с версии 3 на версию 4.
Можно пользоваться бесплатно, а платный вариант есть?Библиотека бесплатная и открытая, под лицензией MIT; компании, которым нужна коммерческая поддержка и сопровождение, могут оформить подписку Tidelift Subscription.
Откуда взялся дизайн этой библиотеки?Во многом она вдохновлена библиотеками UUID для Java и Python, так что работа с UUID из любого из этих языков покажется здесь знакомой.
GUID — это не то же самое, что UUID?На практике это один и тот же формат 128-битного идентификатора — GUID просто название от Microsoft. Репозиторий помечен тегами и uuid, и guid, и uid.
Она только создаёт новые идентификаторы или с уже существующими тоже можно работать?И то и другое: в README она описана как библиотека для генерации и работы с UUID, так что в своём коде вы можете представлять и преобразовывать значения UUID, а не только создавать новые.
Это проверенный временем проект?Да — он существует с 2012 года, у него более 12 600 звёзд на GitHub, настроена непрерывная интеграция, а коммерческое сопровождение доступно через Tidelift.
Creator
ramsey
Size
3.2 MB
Stars
12.6K
Age
14y
Commits · 90 Days