Add callback support to "optional" (#23688)

src/Illuminate/Support/helpers.php

@@ -718,11 +718,16 @@ function object_get($object, $key, $default = null)
      * Provide access to optional objects.
      *
      * @param  mixed  $value
+     * @param  callable|null  $callback
      * @return mixed
      */
-    function optional($value = null)
+    function optional($value = null, callable $callback = null)
     {
-        return new Optional($value);
+        if (is_null($callback)) {
+            return new Optional($value);
+        } elseif (! is_null($value)) {
+            return $callback($value);
+        }
     }
 }
 

tests/Support/SupportHelpersTest.php

@@ -784,6 +784,19 @@ public function something()
         })->something());
     }
 
+    public function testOptionalWithCallback()
+    {
+        $this->assertNull(optional(null, function () {
+            throw new RuntimeException(
+                'The optional callback should not be called for null'
+            );
+        }));
+
+        $this->assertEquals(10, optional(5, function ($number) {
+            return $number * 2;
+        }));
+    }
+
     public function testOptionalWithArray()
     {
         $this->assertEquals('here', optional(['present' => 'here'])['present']);