update: Added required_if_declined helper

UPGRADE.md

@@ -2,6 +2,10 @@
 
 ## v5
 
+### Upgrading from v5.0 to v5.1
+
+- Minimum Laravel version increased from `11.0.3` to `11.4`.
+
 ### Upgrading from v4.3 to v5.0
 
 - Minimum Laravel version increased from `10.46` to `11.0.3`.

composer.json

@@ -6,7 +6,7 @@
     "minimum-stability": "stable",
     "require": {
         "php": "^8.2",
-        "laravel/framework": "^11.0.3"
+        "laravel/framework": "^11.4"
     },
     "require-dev": {
         "ext-json": "*",

src/Rule.php

@@ -996,8 +996,8 @@ public static function requiredIf(mixed $callback): RequiredIf
     }
 
     /**
-     * The field under validation must be present and not empty if the `anotherfield` field is equal to yes, on, 1, "1",
-     * true, or "true".
+     * The field under validation must be present and not empty if the `field` field is equal to yes, on, 1, "1", true,
+     * or "true".
      *
      * @link https://laravel.com/docs/11.x/validation#rule-required-if-accepted
      */
@@ -1026,6 +1026,17 @@ public static function requiredIfAny(RequiredIf ...$rules): RequiredIf
         });
     }
 
+    /**
+     * The field under validation must be present and not empty if the `field` field is equal to "no", "off", 0, "0",
+     * false, or "false".
+     *
+     * @link https://laravel.com/docs/11.x/validation#rule-required-if-declined
+     */
+    public static function requiredIfDeclined(string $field): string
+    {
+        return 'required_if_declined:'.$field;
+    }
+
     /**
      * The field under validation must be present and not empty if the *anotherField* field is equal to any *value*.
      *

src/RuleSet.php

@@ -1088,8 +1088,8 @@ public function requiredIf(mixed $callback): self
     }
 
     /**
-     * The field under validation must be present and not empty if the `anotherfield` field is equal to yes, on, 1, "1",
-     * true, or "true".
+     * The field under validation must be present and not empty if the `field` field is equal to yes, on, 1, "1", true,
+     * or "true".
      *
      * @link https://laravel.com/docs/11.x/validation#rule-required-if-accepted
      */
@@ -1114,6 +1114,17 @@ public function requiredIfAny(RequiredIf ...$rules): self
         return $this->rule(Rule::requiredIfAny(...$rules));
     }
 
+    /**
+     * The field under validation must be present and not empty if the `field` field is equal to "no", "off", 0, "0",
+     * false, or "false".
+     *
+     * @link https://laravel.com/docs/11.x/validation#rule-required-if-declined
+     */
+    public function requiredIfDeclined(string $field): self
+    {
+        return $this->rule(Rule::requiredIfDeclined($field));
+    }
+
     /**
      * The field under validation must be present and not empty if the *anotherField* field is equal to any *value*.
      *

tests/Unit/RuleTest.php

@@ -2110,6 +2110,26 @@ public static function ruleDataProvider(): array
                 ],
                 'fails' => true,
             ],
+            'requiredIfDeclined valid' => [
+                'data' => [
+                    'field-a' => 'a',
+                    'field-b' => '1',
+                ],
+                'rules' => fn() => [
+                    'field-a' => RuleSet::create()->requiredIfDeclined('field-b'),
+                ],
+                'fails' => false,
+            ],
+            'requiredIfDeclined invalid' => [
+                'data' => [
+                    'field-a' => '',
+                    'field-b' => '0',
+                ],
+                'rules' => fn() => [
+                    'field-a' => RuleSet::create()->requiredIfDeclined('field-b'),
+                ],
+                'fails' => true,
+            ],
             'requiredIfValue valid' => [
                 'data' => [
                     'field-a' => 'a',