Add dd_when Helper to Conditionally Trigger dd()

src/Illuminate/Support/helpers.php

@@ -507,3 +507,19 @@ function with($value, ?callable $callback = null)
         return is_null($callback) ? $value : $callback($value);
     }
 }
+
+if (!function_exists('dd_when')) {
+    /**
+     * Dump and die when a condition is met.
+     *
+     * @param bool $condition
+     * @param  mixed  ...$vars
+     * @return void
+     */
+    function dd_when(bool $condition, mixed ...$vars): void
+    {
+        if ($condition) {
+            dd(...$vars);
+        }
+    }
+}

tests/Support/SupportHelpersTest.php

@@ -1229,6 +1229,18 @@ public function testPregReplaceArray($pattern, $replacements, $subject, $expecte
             preg_replace_array($pattern, $replacements, $subject)
         );
     }
+
+    public function testDdWhenDoesNotDumpWhenConditionIsFalse()
+    {
+        // Ensure that when the condition is false, dd() does not execute.
+        try {
+            dd_when(false, 'This should not dump');
+        } catch (RuntimeException $e) {
+            $this->fail('dd_when should not have called dd when condition is false.');
+        }
+
+        $this->assertTrue(true); // If no exception, the test passes.
+    }
 }
 
 trait SupportTestTraitOne