Support numbers and fromBase64 methods for \Hyperf\Stringable\Str (#6799)

* Support numbers and fromBase64 to \Hyperf\Stringable\Str

* Up CHANGELOG

Author: zds-s

Diff for: src/Str.php

@@ -1376,6 +1376,22 @@ public static function wordWrap($string, $characters = 75, $break = "\n", $cutLo
         return wordwrap($string, $characters, $break, $cutLongWords);
     }
 
+    /**
+     * Remove all non-numeric characters from a string.
+     */
+    public static function numbers(array|string $value): array|string
+    {
+        return preg_replace('/[^0-9]/', '', $value);
+    }
+
+    /**
+     * Decode the given Base64 encoded string.
+     */
+    public static function fromBase64(string $string, bool $strict = false): false|string
+    {
+        return base64_decode($string, $strict);
+    }
+
     /**
      * Returns the replacements for the ascii method.
      * Note: Adapted from Stringy\Stringy.

Diff for: tests/StrTest.php

@@ -1114,4 +1114,21 @@ public function testReplaceMatches()
         $this->assertSame('http://hyperf.io', Str::replaceMatches('/^https:\/\//', 'http://', 'https://hyperf.io'));
         $this->assertSame('http://hyperf.io', Str::replaceMatches('/^https:\/\//', fn ($matches) => 'http://', 'https://hyperf.io'));
     }
+
+    public function testNumbers(): void
+    {
+        $this->assertSame('5551234567', Str::numbers('(555) 123-4567'));
+        $this->assertSame('443', Str::numbers('L4r4v3l!'));
+        $this->assertSame('', Str::numbers('Laravel!'));
+
+        $arrayValue = ['(555) 123-4567', 'L4r4v3l', 'Laravel!'];
+        $arrayExpected = ['5551234567', '443', ''];
+        $this->assertSame($arrayExpected, Str::numbers($arrayValue));
+    }
+
+    public function testFromBase64(): void
+    {
+        $this->assertSame('foo', Str::fromBase64(base64_encode('foo')));
+        $this->assertSame('foobar', Str::fromBase64(base64_encode('foobar'), true));
+    }
 }