8000 minor #15272 [Uid] Document the namespace string values (javiereguiluz) · symfony/symfony-docs@d50ad9c · GitHub
[go: up one dir, main page]
Skip to content

Commit d50ad9c

Browse files
javiereguiluzjaviereguiluz
committed
minor #15272 [Uid] Document the namespace string values (javiereguiluz)
This PR was merged into the 5.3-dev branch. Discussion ---------- [Uid] Document the namespace string values Fixes #15141. Commits ------- ddc4060 [Uid] Document the namespace string values
2 parents 16ce462 + ddc4060 commit d50ad9c

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

‎components/uid.rst

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -55,12 +55,12 @@ to create each type of UUID::
5555
$uuid = Uuid::v3($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV3
5656
$uuid = Uuid::v5($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV5
5757

58-
// the namespaces defined by RFC 4122 are available as constants
59-
// (see https://tools.ietf.org/html/rfc4122#appendix-C)
60-
$uuid = Uuid::v3(Uuid::NAMESPACE_DNS, $name);
61-
$uuid = Uuid::v3(Uuid::NAMESPACE_URL, $name);
62-
$uuid = Uuid::v3(Uuid::NAMESPACE_OID, $name);
63-
$uuid = Uuid::v3(Uuid::NAMESPACE_X500, $name);
58+
// the namespaces defined by RFC 4122 (see https://tools.ietf.org/html/rfc4122#appendix-C)
59+
// are available as PHP constants and as string values
60+
$uuid = Uuid::v3(Uuid::NAMESPACE_DNS, $name); // same as: Uuid::v3('dns', $name);
61+
$uuid = Uuid::v3(Uuid::NAMESPACE_URL, $name); // same as: Uuid::v3('url', $name);
62+
$uuid = Uuid::v3(Uuid::NAMESPACE_OID, $name); // same as: Uuid::v3('oid', $name);
63+
$uuid = Uuid::v3(Uuid::NAMESPACE_X500, $name); // same as: Uuid::v3('x500', $name);
6464

6565
// UUID type 6 is not part of the UUID standard. It's lexicographically sortable
6666
// (like ULIDs) and contains a 60-bit timestamp and 63 extra unique bits.
@@ -69,7 +69,8 @@ to create each type of UUID::
6969

7070
.. versionadded:: 5.3
7171

72-
The ``Uuid::NAMESPACE_*`` constants were introduced in Symfony 5.3.
72+
The ``Uuid::NAMESPACE_*`` constants and the namespace string values (``'dns'``,
73+
``'url'``, etc.) were introduced in Symfony 5.3.
7374

7475
If your UUID value is already generated in another format, use any of the
7576
following methods to create a ``Uuid`` object from it::

0 commit comments

Comments
 (0)
0