封装最新且更安全的 Uuid 版本的库

1.0.2 2016-02-27 16:04 UTC

This package is not auto-updated.

Last update: 2024-09-14 17:00:48 UTC


README

Build Status Coverage Status Scrutinizer Code Quality Latest Stable Version Total Downloads License SensioLabsInsight Donate

Uuid 生成器

此类的目的是封装 Uuid 的最新和更安全的版本,从而无需在各个地方显式地硬编码 Uuid 版本。

1. 安装

推荐通过 Composer 安装 Uuid 生成器。运行以下命令进行安装

php composer.phar require nilportugues/uuid

2. 使用方法

使用方法非常简单,您可以直接创建 Uuid 或在特定命名空间下创建。

2.1. 无命名空间

这是最常见的情况。使用非常直接

<?php
use NilPortugues\Uuid\Uuid;

echo Uuid::create(); // "13dfa123-d7a6-4082-8b3f-513c28f5d691"

2.2. 命名空间

首先,以下命名空间存在

  • DNS 命名空间
  • URL 命名空间
  • OID (对象标识符) 命名空间
  • X500 命名空间

代码中使用可以通过一个常量来定义。

<?php
use NilPortugues\Uuid\Uuid;

echo Uuid::create(Uuid::NAMESPACE_DNS, 'nilportugues.com');

echo Uuid::create(Uuid::NAMESPACE_URL, 'http://nilportugues.com/robots.txt');

echo Uuid::create(Uuid::NAMESPACE_OID, 'Foo\Bar');

echo Uuid::create(Uuid::NAMESPACE_X500, '/c=us/o=Sun/ou=People/cn=Rosanna Lee');

有关其使用的更多信息,请参阅此处: http://tools.ietf.org/html/rfc4122#appendix-C

2.3. Uuid 版本

目前 Uuid 有 5 个版本,虽然它们都是有效的,但通常推荐使用最新版本。最新推荐版本为:

  • Uuid4 比 Uuid1 更受欢迎。
  • Uuid5 比 Uuid3 和 Uuid1 更受欢迎

3. 质量保证

要在命令行中运行 PHPUnit 测试,请转到测试目录并运行 phpunit。

此库试图符合 PSR-1、PSR-2 和 PSR-4。如果您注意到合规性疏忽,请通过拉取请求发送补丁。

4. 作者

Nil Portugués Calderó

5. 许可证

代码库采用 MIT 许可证。