[11.x] Implement HasV7Uuids to use with MariaDB native uuid data type (#52029)

* implement HasV7UUids

* Implement all uuid4 methods to uuid7 for unified experience and add ability to define time for the uuid7

* formatting

* formatting

* remove property

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: Karem-sobhy

src/Illuminate/Database/Eloquent/Concerns/HasVersion7Uuids.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Illuminate\Database\Eloquent\Concerns;
+
+use Illuminate\Support\Str;
+
+trait HasVersion7Uuids
+{
+    use HasUuids;
+
+    /**
+     * Generate a new UUID (version 7) for the model.
+     *
+     * @return string
+     */
+    public function newUniqueId()
+    {
+        return (string) Str::uuid7();
+    }
+}

src/Illuminate/Support/Str.php

@@ -1736,6 +1736,19 @@ public static function uuid()
                     : Uuid::uuid4();
     }
 
+    /**
+     * Generate a UUID (version 7).
+     *
+     * @param  \DateTimeInterface|null  $time
+     * @return \Ramsey\Uuid\UuidInterface
+     */
+    public static function uuid7($time = null)
+    {
+        return static::$uuidFactory
+                    ? call_user_func(static::$uuidFactory)
+                    : Uuid::uuid7($time);
+    }
+
     /**
      * Generate a time-ordered UUID.
      *

tests/Support/SupportStrTest.php

@@ -1101,6 +1101,7 @@ public function testUuid()
     {
         $this->assertInstanceOf(UuidInterface::class, Str::uuid());
         $this->assertInstanceOf(UuidInterface::class, Str::orderedUuid());
+        $this->assertInstanceOf(UuidInterface::class, Str::uuid7());
     }
 
     public function testAsciiNull()
@@ -1354,7 +1355,7 @@ public function testItCanSpecifyASequenceOfUuidsToUtilise()
     {
         Str::createUuidsUsingSequence([
             0 => ($zeroth = Str::uuid()),
-            1 => ($first = Str::uuid()),
+            1 => ($first = Str::uuid7()),
             // just generate a random one here...
             3 => ($third = Str::uuid()),
             // continue to generate random uuids...