Add Rule::contains

laravel · taylorotwell · May 26, 2025 · May 21, 2025 · May 21, 2025 · May 21, 2025
commit f732003bbcf80fa369aec147af33ebb324d2815f
diff --git a/src/Illuminate/Validation/Rule.php b/src/Illuminate/Validation/Rule.php
@@ -260,6 +260,21 @@ public static function anyOf($rules)
         return new AnyOf($rules);
     }
 
+    /**
+     * Get a contains rule builder instance.
+     *
+     * @param  \Illuminate\Contracts\Support\Arrayable|\BackedEnum|\UnitEnum|array|string  $values
+     * @return \Illuminate\Validation\Rules\Contains
+     */
+    public static function contains($values)
+    {
+        if ($values instanceof Arrayable) {
+            $values = $values->toArray();
+        }
+
+        return new Rules\Contains(is_array($values) ? $values : func_get_args());
+    }
+
     /**
      * Compile a set of rules for an attribute.
      *

diff --git a/src/Illuminate/Validation/Rules/Contains.php b/src/Illuminate/Validation/Rules/Contains.php
@@ -0,0 +1,49 @@
+<?php
+
+namespace Illuminate\Validation\Rules;
+
+use Illuminate\Contracts\Support\Arrayable;
+use Stringable;
+
+use function Illuminate\Support\enum_value;
+
+class Contains implements Stringable
+{
+    /**
+     * The values that should be contained in the attribute.
+     *
+     * @var array
+     */
+    protected $values;
+
+    /**
+     * Create a new contains rule instance.
+     *
+     * @param  \Illuminate\Contracts\Support\Arrayable|\BackedEnum|\UnitEnum|array|string  $values
+     * @return void
+     */
+    public function __construct($values)
+    {
+        if ($values instanceof Arrayable) {
+            $values = $values->toArray();
+        }
+
+        $this->values = is_array($values) ? $values : func_get_args();
+    }
+
+    /**
+     * Convert the rule to a validation string.
+     *
+     * @return string
+     */
+    public function __toString()
+    {
+        $values = array_map(function ($value) {
+            $value = enum_value($value);
 function enum_value($value, $default = null) 
 function enum_value($value, $default = null) 
+
+            return '"'.str_replace('"', '""', $value).'"';
+        }, $this->values);
+
+        return 'contains:'.implode(',', $values);
+    }
+}