Validator: Add starts_with, ends_with, and contains rule setting to string validator

Author: cdtweb

src/Validator.php

@@ -626,14 +626,29 @@ protected function validateString($value, array $rule = []): bool
     {
         $valid = is_string($value);
 
+        // case-sensitive by default
+        $caseSensitive = isset($rule['case_sensitive']) ? (bool) $rule['case_sensitive'] : true;
+
         if (isset($rule['equals']) && is_string($rule['equals'])) {
-            $valid = $valid && $value == $rule['equals'];
+            $valid = $valid && Str::equals($value, $rule['equals'], $caseSensitive);
         } elseif (isset($rule['in']) && is_array($rule['in'])) {
             $valid = $valid && in_array($value, $rule['in']);
         } elseif (isset($rule['regex']) && is_string($rule['regex'])) {
             $valid = $valid && preg_match($rule['regex'], $value);
         }
 
+        if (isset($rule['starts_with']) && is_string($rule['starts_with'])) {
+            $valid = $valid && Str::startsWith($value, $rule['starts_with'], $caseSensitive);
+        }
+
+        if (isset($rule['ends_with']) && is_string($rule['ends_with'])) {
+            $valid = $valid && Str::endsWith($value, $rule['ends_with'], $caseSensitive);
+        }
+
+        if (isset($rule['contains']) && is_string($rule['contains'])) {
+            $valid = $valid && Str::contains($value, $rule['contains'], $caseSensitive);
+        }
+
         if (isset($rule['allow_empty']) && $rule['allow_empty'] === false) {
             $valid = $valid && !empty($value);
         }

tests/ValidatorTest.php

@@ -343,6 +343,10 @@ public function testValidateString()
         $str_equals = ['equals' => 'Hello, World!'];
         $str_in = ['in' => ['hello', 'world', 'foo', 'bar']];
         $str_regex = ['regex' => "/php/i"];
+        $str_starts_with = ['starts_with' => 'Hello'];
+        $str_ends_with = ['ends_with' => 'World!'];
+        $str_contains = ['contains' => 'llo, W'];
+        $str_case_insensitive = ['case_sensitive' => false];
 
         $this->assertTrue(Validator::isString('abc', array_merge($str_min_length, $str_max_length)));
         $this->assertFalse(Validator::isString('', $str_min_length));
@@ -352,11 +356,21 @@ public function testValidateString()
         $this->assertFalse(Validator::isString(null));
         $this->assertTrue(Validator::isString(null, $str_allow_null));
         $this->assertTrue(Validator::isString('Hello, World!', $str_equals));
+        $this->assertTrue(Validator::isString('hello, world!', array_merge($str_case_insensitive, $str_equals)));
         $this->assertFalse(Validator::isString('Hello World!', $str_equals));
         $this->assertTrue(Validator::isString('foo', $str_in));
         $this->assertFalse(Validator::isString('cat', $str_in));
         $this->assertTrue(Validator::isString('PHP is my favorite!', $str_regex));
         $this->assertFalse(Validator::isString('Java is my favorite!', $str_regex));
+        $this->assertTrue(Validator::isString('Hello, World!', $str_starts_with));
+        $this->assertTrue(Validator::isString('hello, world!', array_merge($str_case_insensitive, $str_starts_with)));
+        $this->assertFalse(Validator::isString('Jello, World!', $str_starts_with));
+        $this->assertTrue(Validator::isString('Hello, World!', $str_ends_with));
+        $this->assertTrue(Validator::isString('hello, world!', array_merge($str_case_insensitive, $str_ends_with)));
+        $this->assertFalse(Validator::isString('Hello, whorld!', $str_ends_with));
+        $this->assertTrue(Validator::isString('Hello, World!', $str_contains));
+        $this->assertTrue(Validator::isString('hello, world!', array_merge($str_case_insensitive, $str_contains)));
+        $this->assertFalse(Validator::isString('Hell0, World!', $str_contains));
     }
 
     /**