add uuid function

Utils/RnG/UUID.php

@@ -0,0 +1,43 @@
+<?php
+/**
+ * Karaka
+ *
+ * PHP Version 8.1
+ *
+ * @package   phpOMS\Utils\RnG
+ * @copyright Dennis Eichhorn
+ * @license   OMS License 1.0
+ * @version   1.0.0
+ * @link      https://jingga.app
+ */
+declare(strict_types=1);
+
+namespace phpOMS\Utils\RnG;
+
+/**
+ * UUID generator.
+ *
+ * @package phpOMS\Utils\RnG
+ * @license OMS License 1.0
+ * @link    https://jingga.app
+ * @since   1.0.0
+ */
+final class UUID
+{
+    /**
+     * Get default random UUID
+     *
+     * @param int<8, max> $length Result length in bytes
+     *
+     * @return string
+     * @since 1.0.0
+     */
+    public static function default(int $length = 16) : string
+    {
+        if ($length < 8) {
+            throw new \InvalidArgumentException();
+        }
+
+        return pack('Q', \time()) . ($length > 8 ? \random_bytes($length - 8) : '');
+    }
+}