[8.x] Add new Stringable::test method (#36462)

* feature: add new Stringable::matches method

* tests: new Stringable::matches method

* refactor: use match instead of matchAll

* chore: rename method from matches to test

Author: ryangjchandler

src/Illuminate/Support/Stringable.php

@@ -365,6 +365,17 @@ public function matchAll($pattern)
         return collect($matches[1] ?? $matches[0]);
     }
 
+    /**
+     * Determine if the string matches the given pattern.
+     *
+     * @param  string  $pattern
+     * @return bool
+     */
+    public function test($pattern)
+    {
+        return $this->match($pattern)->isNotEmpty();
+    }
+
     /**
      * Pad both sides of the string with another.
      *

tests/Support/SupportStringableTest.php

@@ -62,6 +62,14 @@ public function testMatch()
         $this->assertTrue($stringable->matchAll('/nothing/')->isEmpty());
     }
 
+    public function testTest()
+    {
+        $stringable = $this->stringable('foo bar');
+
+        $this->assertTrue($stringable->test('/bar/'));
+        $this->assertTrue($stringable->test('/foo (.*)/'));
+    }
+
     public function testTrim()
     {
         $this->assertSame('foo', (string) $this->stringable(' foo ')->trim());