Merge pull request #284 from tobiashinz/listContains

List contains

Author: willemwollebrants

README.md

@@ -143,6 +143,7 @@ V::lang('ar');
  * `lengthMax` - String must be less than given length
  * `min` - Minimum
  * `max` - Maximum
+ * `listContains` - Performs in_array check on given array values (the other way round than `in`)
  * `in` - Performs in_array check on given array values
  * `notIn` - Negation of `in` rule (not in array of values)
  * `ip` - Valid IP address
@@ -443,6 +444,23 @@ $v->rules([
 $v->validate();
 ```
 
+## listContains fields usage
+The `listContains` rule checks that the field is present in a given array of values.
+```php
+$v->rule('listContains', 'color', 'yellow');
+```
+
+Alternate syntax.
+```php
+$v = new Valitron\Validator(['color' => ['blue', 'green', 'red', 'yellow']]);
+$v->rules([
+    'listContains' => [
+        ['color', 'yellow']
+    ]
+]);
+$v->validate();
+```
+
 ## in fields usage
 The `in` rule checks that the field is present in a given array of values.
 ```php
@@ -970,7 +988,7 @@ Valitron\Validator::addRule('alwaysFail', function($field, $value, array $params
 ```
 
 You can also use one-off rules that are only valid for the specified
-fields. 
+fields.
 
 ```php
 $v = new Valitron\Validator(array("foo" => "bar"));
@@ -982,12 +1000,12 @@ $v->rule(function($field, $value, $params, $fields) {
 This is useful because such rules can have access to variables
 defined in the scope where the `Validator` lives. The Closure's
 signature is identical to `Validator::addRule` callback's
-signature. 
+signature.
 
 If you wish to add your own rules that are not static (i.e.,
-your rule is not static and available to call `Validator` 
-instances), you need to use `Validator::addInstanceRule`. 
-This rule will take the same parameters as 
+your rule is not static and available to call `Validator`
+instances), you need to use `Validator::addInstanceRule`.
+This rule will take the same parameters as
 `Validator::addRule` but it has to be called on a `Validator`
 instance.
 
@@ -1067,7 +1085,7 @@ You can also add rules on a per-field basis:
 $rules = [
     'required',
     ['lengthMin', 4]
-];   
+];
 
 $v = new Valitron\Validator(array('foo' => 'bar'));
 $v->mapFieldRules('foo', $rules);
@@ -1155,4 +1173,3 @@ before running the tests:
 6. Push to the branch (`git push origin my-new-feature`)
 7. Create new Pull Request
 8. Pat yourself on the back for being so awesome
-

lang/ar.php

@@ -11,6 +11,7 @@
     'min'           => "يجب ان يكون اعلي من  %s",
     'max'           => "يجب ان يكون اقل من %s",
     'in'            => "الُمدخل يغير صحيح",
+    'listContains'  => "الُمدخل يغير صحيح",
     'notIn'         => "الُمدخل يغير صحيح",
     'ip'            => "رقم الإتصال غير صحيح",
     'email'         => "البريد الألكتروني غير صحيح",

lang/az.php

@@ -10,6 +10,7 @@
     'length'        => "%d qədər uzunluğu olmalıdır",
     'min'           => "minimum %s qədər olmalıdır",
     'max'           => "maksimum %s qədər olmalıdır",
+    'listContains'  => "yalnış dəyər ehtiva edir",
     'in'            => "yalnış dəyər ehtiva edir",
     'notIn'         => "yalnış dəyər ehtiva edir",
     'ip'            => "düzgün IP ünvanı deyil",

lang/bg.php

@@ -10,6 +10,7 @@
     'length'        => "трябва да бъде %d символа дълго",
     'min'           => "трябвя да бъде поне %s",
     'max'           => "трябва да бъде не повече от %s",
+    'listContains'  => "съдържа невалидна стойност",
     'in'            => "съдържа невалидна стойност",
     'notIn'         => "съдържа невалидна стойност",
     'ip'            => "е невалиден IP адрес",

lang/de.php

@@ -10,6 +10,7 @@
     'length'        => "kann nicht länger als %d sein",
     'min'           => "muss größer als %s sein",
     'max'           => "muss kleiner als %s sein",
+    'listContains'  => "enthält einen ungültigen Wert",
     'in'            => "enthält einen ungültigen Wert",
     'notIn'         => "enthält einen ungültigen Wert",
     'ip'            => "enthält keine gültige IP-Addresse",

lang/el.php

@@ -10,6 +10,7 @@
     'length'        => "πρέπει να είναι μεγαλύτερο από %d",
     'min'           => "πρέπει να είναι τουλάχιστον %s",
     'max'           => "δεν πρέπει να είναι περισσότερο από %s",
+    'listContains'  => "περιέχει μη έγκυρη τιμή",
     'in'            => "περιέχει μη έγκυρη τιμή",
     'notIn'         => "περιέχει μη έγκυρη τιμή",
     'ip'            => "δεν είναι έγκυρη διεύθυνση IP",

lang/en.php

@@ -10,6 +10,7 @@
     'length'         => "must be %d characters long",
     'min'            => "must be at least %s",
     'max'            => "must be no more than %s",
+    'listContains'   => "contains invalid value",
     'in'             => "contains invalid value",
     'notIn'          => "contains invalid value",
     'ip'             => "is not a valid IP address",

lang/fi.php

@@ -10,6 +10,7 @@
     'length'        => "on lyhyempi kuin %d",
     'min'           => "ei ole vähintään %s",
     'max'           => "ei ole enintään %s",
+    'listContains'  => "sisältää virheellisen arvon",
     'in'            => "sisältää virheellisen arvon",
     'notIn'         => "sisältää virheellisen arvon",
     'ip'            => "ei ole oikeanmuotoinen IP-osoite",

lang/fr.php

@@ -10,6 +10,7 @@
     'length'        => "doit être plus long que %d",
     'min'           => "doit être plus grand que %s",
     'max'           => "doit être plus petit que %s",
+    'listContains'  => "contient une valeur non valide",
     'in'            => "contient une valeur non valide",
     'notIn'         => "contient une valeur non valide",
     'ip'            => "n'est pas une adresse IP valide",

lang/id.php

@@ -10,6 +10,7 @@
     'length'        => "harus lebih panjang dari %d",
     'min'           => "harus lebih besar dari %s",
     'max'           => "harus kurang dari %s",
+    'listContains'  => "berisi nilai/value yang tidak valid",
     'in'            => "berisi nilai/value yang tidak valid",
     'notIn'         => "berisi nilai/value yang tidak valid",
     'ip'            => "format alamat IP tidak benar",