[10.x] Add isMatch method to Str and Stringable helpers (#46303)

* [10.x] Add isMatch method to Str and Stringable helpers

* formatting

---------

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

Author: localusercamp

src/Illuminate/Support/Str.php

@@ -610,6 +610,32 @@ public static function match($pattern, $subject)
         return $matches[1] ?? $matches[0];
     }
 
+    /**
+     * Determine if a given string matches a given pattern.
+     *
+     * @param  string|iterable<string>  $pattern
+     * @param  string  $value
+     * @return bool
+     */
+    public static function isMatch($pattern, $value)
+    {
+        $value = (string) $value;
+
+        if (! is_iterable($pattern)) {
+            $pattern = [$pattern];
+        }
+
+        foreach ($pattern as $pattern) {
+            $pattern = (string) $pattern;
+
+            if (preg_match($pattern, $value) === 1) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
     /**
      * Get the string matching the given pattern.
      *

src/Illuminate/Support/Stringable.php

@@ -440,6 +440,17 @@ public function match($pattern)
         return new static(Str::match($pattern, $this->value));
     }
 
+    /**
+     * Determine if a given string matches a given pattern.
+     *
+     * @param  string|iterable<string>  $pattern
+     * @return bool
+     */
+    public function isMatch($pattern)
+    {
+        return Str::isMatch($pattern, $this->value);
+    }
+
     /**
      * Get the string matching the given pattern.
      *