[12.x] Add hash string helper (#55767)

* feat: add `hash` method to `Stringable`

* fix: cs

* formatting

---------

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

Author: istiak-tridip

src/Illuminate/Support/Stringable.php

@@ -1335,6 +1335,17 @@ public function fromBase64($strict = false)
         return new static(base64_decode($this->value, $strict));
     }
 
+    /**
+     * Hash the string using the given algorithm.
+     *
+     * @param  string  $algorithm
+     * @return static
+     */
+    public function hash(string $algorithm)
+    {
+        return new static(hash($algorithm, $this->value));
+    }
+
     /**
      * Dump the string.
      *

tests/Support/SupportStringableTest.php

@@ -1419,4 +1419,11 @@ public function testFromBase64()
         $this->assertSame('foobar', (string) $this->stringable(base64_encode('foobar'))->fromBase64(true));
         $this->assertSame('foobarbaz', (string) $this->stringable(base64_encode('foobarbaz'))->fromBase64());
     }
+
+    public function testHash()
+    {
+        $this->assertSame(hash('xxh3', 'foo'), (string) $this->stringable('foo')->hash('xxh3'));
+        $this->assertSame(hash('xxh3', 'foobar'), (string) $this->stringable('foobar')->hash('xxh3'));
+        $this->assertSame(hash('sha256', 'foobarbaz'), (string) $this->stringable('foobarbaz')->hash('sha256'));
+    }
 }