Added Str::containsIgnoreCase() (#5971)

Co-authored-by: 李铭昕 <[email protected]>

Author: guandeng

src/Str.php

@@ -208,8 +208,12 @@ public static function charAt($subject, $index)
      *
      * @param array|string $needles
      */
-    public static function contains(string $haystack, $needles): bool
+    public static function contains(string $haystack, mixed $needles, bool $ignoreCase = false): bool
     {
+        if ($ignoreCase) {
+            return static::containsIgnoreCase($haystack, $needles);
+        }
+
         foreach ((array) $needles as $needle) {
             $needle = (string) $needle;
             if ($needle !== '' && str_contains($haystack, $needle)) {
@@ -220,17 +224,33 @@ public static function contains(string $haystack, $needles): bool
         return false;
     }
 
+    /**
+     * Determine if a given string contains a given substring regardless of case sensitivity.
+     *
+     * @param array|string $needles
+     */
+    public static function containsIgnoreCase(string $haystack, $needles): bool
+    {
+        foreach ((array) $needles as $needle) {
+            $needle = (string) $needle;
+            if ($needle !== '' && stripos($haystack, $needle) !== false) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
     /**
      * Determine if a given string contains all array values.
      *
-     * @param string $haystack
      * @param string[] $needles
      * @return bool
      */
-    public static function containsAll($haystack, array $needles)
+    public static function containsAll(string $haystack, array $needles, bool $ignoreCase = false)
     {
         foreach ($needles as $needle) {
-            if (! static::contains($haystack, $needle)) {
+            if (! static::contains($haystack, $needle, $ignoreCase)) {
                 return false;
             }
         }

tests/StrTest.php

@@ -251,6 +251,7 @@ public function testIsMatch()
 
     public function testContains()
     {
+        $this->assertTrue(Str::contains('Hyperf', ['h'], true));
         $this->assertTrue(Str::contains('Hyperf', ['H']));
         $this->assertFalse(Str::contains('Hyperf', ['']));
         $this->assertFalse(Str::contains('Hyperf', [null]));
@@ -264,4 +265,10 @@ public function testEndsWith()
         $this->assertFalse(Str::endsWith('Hyperf', [null]));
         $this->assertFalse(Str::endsWith('Hyperf', null));
     }
+
+    public function testContainsAll()
+    {
+        $this->assertTrue(Str::containsAll('Hyperf', ['h'], true));
+        $this->assertFalse(Str::containsAll('Hyperf', ['h']));
+    }
 }