[12.x] Introduce ComputesOnceableHashInterface (#56009)

* [12.x] Introduce `ComputesOnceableHashInterface`

* formatting

* Remove declare

---------

Co-authored-by: Taylor Otwell <taylor@laravel.com>

Author: Jacobs63

src/Illuminate/Contracts/Support/HasOnceHash.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Illuminate\Contracts\Support;
+
+interface HasOnceHash
+{
+    /**
+     * Compute the hash that should be used to represent the object when given to a function using "once".
+     *
+     * @return string
+     */
+    public function onceHash();
+}

src/Illuminate/Support/Onceable.php

@@ -3,6 +3,7 @@
 namespace Illuminate\Support;
 
 use Closure;
+use Illuminate\Contracts\Support\HasOnceHash;
 use Laravel\SerializableClosure\Support\ReflectionClosure;
 
 class Onceable
@@ -61,7 +62,17 @@ protected static function hashFromTrace(array $trace, callable $callable)
         }
 
         $uses = array_map(
-            fn (mixed $argument) => is_object($argument) ? spl_object_hash($argument) : $argument,
+            static function (mixed $argument) {
+                if ($argument instanceof HasOnceHash) {
+                    return $argument->onceHash();
+                }
+
+                if (is_object($argument)) {
+                    return spl_object_hash($argument);
+                }
+
+                return $argument;
+            },
             $callable instanceof Closure ? (new ReflectionClosure($callable))->getClosureUsedVariables() : [],
         );