UID组件

编辑该页面

警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 6.0,不再维护。

读这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。

UID组件

UID组件提供了实用程序惟一标识符(uid) uuid和ULIDs等。

安装

1
美元作曲家需要symfony / uiob娱乐下载d

请注意

如果你安装这个组件之外的Symfony应用程序,你必须要求ob娱乐下载供应商/ autoload.php文件在你的代码,使作曲家提供的类加载机制。读这篇文章为更多的细节。

uuid

uuid(全局唯一标识符)是最受欢迎的软件行业的uid。uuid是128位的十六进制字符的数字通常表示为五组:xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx(米数字是UUID和版本N数字是UUID变种)。

生成uuid

使用命名的构造函数Uuid类或任何特定类来创建每个类型的UUID:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29
使用ob娱乐下载\组件\Uid\Uuid;/ / 1型UUID生成UUID使用你的设备的MAC地址和一个时间戳。/ /自动获得,所以你不需要通过任何构造函数参数。美元uuid= Uuid::v1 ();/ / $ uuid是Symfony的实例\ \ Uiob娱乐下载d \ UuidV1组件/ / UUID type 4生成一个随机的UUID,所以你不需要通过任何构造函数参数。美元uuid= Uuid::v4 ();/ / $ uuid是Symfony的实例\ \ Uiob娱乐下载d \ UuidV4组件/ / UUID类型3和5生成一个UUID散列给定的名称空间和名称。类型3使用/ / MD5散列和类型5使用sha - 1。名称空间是另一个UUID(例如,一个类型4 UUID)/ /和名称是一个任意的字符串(例如产品名称;如果它是唯一的)。美元名称空间= Uuid::v4 ();美元的名字=美元产品- >getUniqueName ();美元uuid= Uuid::v3 (美元名称空间,美元的名字);/ / $ uuid是Symfony的实例\ \ Uiob娱乐下载d \ UuidV3组件美元uuid= Uuid::v5 (美元名称空间,美元的名字);/ / $ uuid是Symfony的实例\ \ Uiob娱乐下载d \ UuidV5组件/ / RFC 4122定义的名称空间(见https://tools.ietf.org/html/rfc4122附录c)/ /可用的PHP常量和字符串值美元uuid= Uuid::v3 (Uuid::NAMESPACE_DNS,美元的名字);/ /一样:Uuid:: v3 (dns,美元的名字);美元uuid= Uuid::v3 (Uuid::NAMESPACE_URL,美元的名字);/ /一样:Uuid:: v3 (“url”,美元的名字);美元uuid= Uuid::v3 (Uuid::NAMESPACE_OID,美元的名字);/ /一样:Uuid:: v3 (oid,美元的名字);美元uuid= Uuid::v3 (Uuid::NAMESPACE_X500,美元的名字);/ /一样:Uuid:: v3 (x500,美元的名字);/ /类型UUID 6不是UUID标准的一部分。它是按字母排序的/ /(比如ULIDs)和包含一个60-bit时间戳和63多独特的部分。/ /定义在http://gh.peabody.io/uuidv6/美元uuid= Uuid::v6 ();/ / $ uuid是Symfony的实例\ \ Uiob娱乐下载d \ UuidV6组件

如果你的UUID生成价值已经在另一个格式,使用下面的方法来创建一个Uuid对象:

1 2 3 4 5 6
/ /所有下面的例子将生成相同的对象Uuid美元uuid= Uuid::fromString (“d9e7a184 - 5 - d5b - 11 - ea - a62a - 3499710062 - d0的);美元uuid= Uuid::fromBinary (“\ xd9 \ xe7 \ xa1 \ x84 \ x5d \ x5b \ x11 \ xea \ xa6 \ x2a \ x34 \ x99 \ x71 \ x00 \ x62 \ xd0”);美元uuid= Uuid::fromBase32 (“6 swygr8qav27nacahmk5rg0rpg”);美元uuid= Uuid::fromBase58 (“TuetYWNHhmuSQ3xPoVLv9M”);美元uuid= Uuid::fromRfc4122 (“d9e7a184 - 5 - d5b - 11 - ea - a62a - 3499710062 - d0的);

您还可以使用UuidFactory生成uuid。首先,您可以使用配置文件配置工厂的行为:

  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8
#配置/包/ uid.yaml框架:uid:default_uuid_version:6name_based_uuid_version:5name_based_uuid_namespace:~time_based_uuid_version:6time_based_uuid_node:~

然后,您可以将工厂在你的服务和使用它来生成uuid基于定义的配置:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日24
< ? php名称空间应用程序\服务;使用ob娱乐下载\组件\Uid\工厂\UuidFactory;类FooService{公共函数__construct(私人UuidFactory美元uuidFactory){}公共函数生成():无效{/ /这将创建一个版本在配置文件中给定的UUID (v6默认情况下)美元uuid=美元这- >uuidFactory- >create ();美元nameBasedUuid=美元这- >uuidFactory- >nameBased (/ * *……* /);美元randomBasedUuid=美元这- >uuidFactory- >randomBased ();美元timestampBased=美元这- >uuidFactory- >时基();/ /……}}

转换uuid

使用这些方法来UUID对象转换成不同的基地:

1 2 3 4 5 6
美元uuid= Uuid::fromString (“d9e7a184 - 5 - d5b - 11 - ea - a62a - 3499710062 - d0的);美元uuid- >toBinary ();/ /字符串(16)“\ xd9 \ xe7 \ xa1 \ x84 \ x5d \ x5b \ x11 \ xea \ xa6 \ x2a \ x34 \ x99 \ x71 \ x00 \ x62 \ xd0”美元uuid- >toBase32 ();/ /字符串(26)“6 swygr8qav27nacahmk5rg0rpg”美元uuid- >toBase58 ();/ /字符串(22)“TuetYWNHhmuSQ3xPoVLv9M”美元uuid- >toRfc4122 ();/ /字符串(36)“d9e7a184 - 5 - d5b - 11 - ea - a62a - 3499710062 - d0”

使用uuid

UUID创建的对象Uuid类可以使用以下方法(这是等价的uuid_ * ()PHP扩展的方法):

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30
使用ob娱乐下载\组件\Uid\NilUuid;使用ob娱乐下载\组件\Uid\Uuid;/ /检查如果UUID为空(注意,类/ / NilUuid代替NullUuid遵循UUID标准符号)美元uuid= Uuid::v4 ();美元uuid运算符NilUuid;/ /错误/ /检查的类型UUID使用ob娱乐下载\组件\Uid\UuidV4;美元uuid= Uuid::v4 ();美元uuid运算符UuidV4;/ /正确的/ /获取UUID datetime(只有在某些UUID类型)美元uuid= Uuid::v1 ();美元uuid- >getDateTime ();/ /返回\ DateTimeImmutable实例/ /检查是否一个给定的值是有效的UUID美元isValid= Uuid::isValid (美元uuid);/ /真或假/ /比较uuid和检查平等美元uuid1= Uuid::v1 ();美元uuid4= Uuid::v4 ();美元uuid1- >= (美元uuid4);/ /错误/ /这个方法返回:/ / * int(0)如果uuid1美元uuid4是相等的/ / * int > 0如果uuid1大于uuid4美元/ / * int < 0如果uuid1美元小于uuid4美元美元uuid1- >比较(美元uuid4);/ /例如int (4)

在数据库中存储uuid

如果你使用原则,可以考虑使用uuid主义类型,它将自动/从UUID对象:

1 2 3 4 5 6 7 8 9 10 11 12 13
/ / src /实体/ Product.php名称空间应用程序\实体;使用学说\ORM\映射作为ORM;# (ORM \实体(repositoryClass: ProductRepository::类))类产品{# (ORM \列(类型:uuid)]私人美元someProperty;/ /……}

还有一个教义发电机帮助自动生成UUID的实体主键值:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
名称空间应用程序\实体;使用学说\ORM\映射作为ORM;使用ob娱乐下载\组件\Uid\Uuid;类用户实现了用户界面{# (ORM \ Id)# (ORM \列(类型:uuid,独特的:真正的))# (ORM \ GeneratedValue(策略:“自定义”)]# (ORM \ CustomIdGenerator(类:doctrine.uuid_generator))私人美元id;公共函数getId():哦?Uuid{返回美元这- >id;}/ /……}

当使用内置的教义库方法(如。findOneBy ()),知道如何将这些教义UUID类型构建SQL查询(如。- > findOneBy([“用户”= > $ user - > getUuid ())))。然而,当使用DQL查询自己或构建查询,你需要设置uuid作为UUID的类型参数:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
/ / src /仓库/ ProductRepository.php/ /……类ProductRepository扩展ServiceEntityRepository{/ /……公共函数findUserProducts(用户美元用户):数组{美元qb=美元这- >createQueryBuilder (“p”)/ /……/ /添加的uuid作为第三个参数告诉学说,这是一个uuid- >setParameter (“用户”,美元用户- >getUuid (),“uuid”)/ /另外,你可以将它转换成一个值兼容/ /类型推断的原则- >setParameter (“用户”,美元用户- >getUuid ()- >toBinary ());/ /……}}

ULIDs

ULIDs(统一的惟一按合适的标识符)128位数字通常表示为一个使用字符串:TTTTTTTTTTRRRRRRRRRRRRRRRR(T代表一个时间戳和R表示随机比特)。

ULIDs当使用这些替代uuid是不切实际的。他们提供了128位兼容UUID,他们按字母排序和编码为使用字符串(vs 36-character UUID)。

请注意

如果你在相同的生成多个ULID毫秒在同一进程中那么随机部分增加了一点为了提供单调性进行排序。随机的部分并不是随机ULID相比,在这种情况下。

生成ULIDs

实例化Ulid类来生成一个随机ULID值:

1 2 3
使用ob娱乐下载\组件\Uid\Ulid;美元ulid=新Ulid ();/ /例如01 an4z07by79ka1307sr9x4mv3

如果你ULID价值已经生成的另一种格式,使用下面的方法来创建一个Ulid对象:

1 2 3 4 5 6
/ /所有下面的例子将生成相同的Ulid对象美元ulid= Ulid::fromString (“01 e439tp9xjz9rpfh3t1pybcr8”);美元ulid= Ulid::fromBinary (“\ x01 \ x71 \ x06 \ x9d \ x59 \ x3d \ x97 \ xd3 \ x8b \ x3e \ x23 \ xd0 \ x6d \ xe5 \ xb3 \”();美元ulid= Ulid::fromBase32 (“01 e439tp9xjz9rpfh3t1pybcr8”);美元ulid= Ulid::fromBase58 (“1 bkocmc5bnrvcuq2ti4eqm”);美元ulid= Ulid::fromRfc4122 (0171069 d - 593 d - 97 - d3 - 8 b3e - 23 - d06de5b308”);

像uuid, ULIDs有自己的工厂,UlidFactory,可以用来生成:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
< ? php名称空间应用程序\服务;使用ob娱乐下载\组件\Uid\工厂\UlidFactory;类FooService{公共函数__construct(私人UlidFactory美元ulidFactory){}公共函数生成():无效{美元ulid=美元这- >ulidFactory- >create ();/ /……}}

还有一个特别的NilUlid类代表ULID零价值观:

1 2 3 4
使用ob娱乐下载\组件\Uid\NilUlid;美元ulid=新NilUlid ();/ /美元相当于ulid = new ulid (' 00000000000000000000000000 ');

转换ULIDs

使用这些方法来ULID对象转换成不同的基地:

1 2 3 4 5 6
美元ulid= Ulid::fromString (“01 e439tp9xjz9rpfh3t1pybcr8”);美元ulid- >toBinary ();/ /字符串(16)“\ x01 \ x71 \ x06 \ x9d \ x59 \ x3d \ x97 \ xd3 \ x8b \ x3e \ x23 \ xd0 \ x6d \ xe5 \ xb3 \”(美元ulid- >toBase32 ();/ /字符串(26)“01 e439tp9xjz9rpfh3t1pybcr8”美元ulid- >toBase58 ();/ /字符串(22)“1 bkocmc5bnrvcuq2ti4eqm”美元ulid- >toRfc4122 ();/ /字符串(36)“0171069 d - 593 d - 97 - d3 - 8 b3e - 23 - d06de5b308”

使用ULIDs

ULID对象创建Ulid类可以使用以下方法:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
使用ob娱乐下载\组件\Uid\Ulid;美元ulid1=新Ulid ();美元ulid2=新Ulid ();/ /检查ULID如果给定值是有效的美元isValid= Ulid::isValid (美元ulidValue);/ /真或假/ /获取ULID datetime美元ulid1- >getDateTime ();/ /返回\ DateTimeImmutable实例/ /比较ULIDs和检查平等美元ulid1- >= (美元ulid2);/ /错误/ /这个方法返回$ ulid1 < = > ulid2美元美元ulid1- >比较(美元ulid2);/ /例如int (1)

在数据库中存储ULIDs

如果你使用原则,可以考虑使用ulid主义类型,它将自动/从ULID对象:

1 2 3 4 5 6 7 8 9 10 11 12 13
/ / src /实体/ Product.php名称空间应用程序\实体;使用学说\ORM\映射作为ORM;# (ORM \实体(repositoryClass: ProductRepository::类))类产品{# (ORM \列(类型:ulid)]私人美元someProperty;/ /……}

还有一个教义发电机帮助自动生成ULID实体主键的值:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
名称空间应用程序\实体;使用学说\ORM\映射作为ORM;使用ob娱乐下载\组件\Uid\Ulid;类产品{# (ORM \ Id)# (ORM \列(类型:“ulid”,独特的:真正的))# (ORM \ GeneratedValue(策略:“自定义”)]# (ORM \ CustomIdGenerator(类:doctrine.ulid_generator))私人美元id;公共函数getId():哦?Ulid{返回美元这- >id;}/ /……}

当使用内置的教义库方法(如。findOneBy ()),理论知道如何将这些ULID类型构建SQL查询(如。- > findOneBy([“用户”= > $ user - > getUlid ())))。然而,当使用DQL查询自己或构建查询,你需要设置ulid作为ULID的类型参数:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
/ / src /仓库/ ProductRepository.php/ /……类ProductRepository扩展ServiceEntityRepository{/ /……公共函数findUserProducts(用户美元用户):数组{美元qb=美元这- >createQueryBuilder (“p”)/ /……/ /添加“ulid”作为第三个参数告诉学说这是ulid- >setParameter (“用户”,美元用户- >getUlid (),“ulid”)/ /另外,你可以将它转换成一个值兼容/ /类型推断的原则- >setParameter (“用户”,美元用户- >getUlid ()- >toBinary ());/ /……}}

生成和检查uuid / ULIDs控制台

此组件提供了一些命令来生成和检查uuid / ULIDs控制台。他们不是默认启用,所以你必须在应用程序中添加以下配置之前,使用这些命令:

  • YAML
  • XML
  • PHP
1 2 3 4 5 6
#配置/ services.yaml服务:ob娱乐下载Symfony命令\组件\ Uid \ \ GenerateUlidCommand:~ob娱乐下载Symfony命令\组件\ Uid \ \ GenerateUuidCommand:~ob娱乐下载Symfony命令\组件\ Uid \ \ InspectUlidCommand:~ob娱乐下载Symfony命令\组件\ Uid \ \ InspectUuidCommand:~

现在你可以生成uuid / ULIDs如下(添加——帮助选项来了解他们所有的命令选项):

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
# 1 random-based UUID生成美元php bin /控制台uuid:生成——random-based1 #生成基于时间的UUID与一个特定的节点美元php bin /控制台uuid:生成——基于时间=现在——节点= fb3502dc - 137 - e - 4849 - 8886 - ac90d07f64a7#生成2在base58 uuid和输出格式美元php bin /控制台uuid:生成——数= 2 = base58格式1 #生成ULID以当前时间为时间戳美元php bin /控制台ulid:生成#生成1 ULID与一个特定的时间戳美元php bin /控制台ulid:生成——时间=“2021-02-02 14:00:00”#生成2 ULIDs RFC4122格式输出美元php bin /控制台ulid:生成——数= 2 = rfc4122格式

除了生成新的UID,您也可以用以下命令检查显示所有的信息对于一个给定的UID:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
美元php bin /控制台uuid:检查d0a3a023 f515 - 4 fe0 - 915 - c - 575 - e63693998 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -标签值- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -版本4标准(RFC 4122) d0a3a023 f515 - 4 fe0 - 915 - c - 575 - 32 6 gmeg27x8n9zg92q2qbshpjecr e63693998基地58 SmHvuofV4GCF7QW543rDD9基地- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -美元php bin /控制台ulid:检查01 f2ttcsyk1pdrh73z41bn1c4x - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -标签值- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -规范(基地32)01 f2ttcsyk1pdrh73z41bn1c4x基地58 0178 b5a6 bygm16js4kx3vycyskkq6 RFC 4122 - 67 - d3 - 0 - d9b - 889 c - 7 f205750b09d - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -时间戳2021-04-09 08:01:24.947 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
这项工作,包括代码示例,许可下Creative Commons冲锋队3.0许可证。
版本:

ob娱乐下载Symfony 6.0是支持通过

ob娱乐下载Symfony代码性能

ob娱乐下载Symfony代码性能

检查代码的性能在开发、测试、分期和生产

检查代码的性能在开发、测试、分期和生产