[9.x] Support dynamic params for Facade docblock generation (#45352)

* Support dynamic parameters

* Fix facades

* Code style

Author: timacdonald

bin/facades.php

@@ -318,6 +318,18 @@ function resolveDocMixins($class)
         ->flatMap(fn ($mixin) => [$mixin, ...resolveDocMixins($mixin)]);
 }
 
+/**
+ * Resolve the classes referenced methods in the @methods docblocks.
+ *
+ * @param  \ReflectionMethodDecorator  $method
+ * @return \Illuminate\Support\Collection<int, string>
+ */
+function resolveDocParameters($method)
+{
+    return resolveDocTags($method->getDocComment() ?: '', '@param')
+        ->map(fn ($tag) => Str::squish($tag));
+}
+
 /**
  * Determine if the method is magic.
  *
@@ -428,7 +440,7 @@ function normaliseDetails($method)
 {
     return is_string($method) ? $method : [
         'name' => $method->getName(),
-        'parameters' => collect($method->getParameters())
+        'parameters' => resolveParameters($method)
             ->map(fn ($parameter) => [
                 'name' => '$'.$parameter->getName(),
                 'optional' => $parameter->isOptional() && ! $parameter->isVariadic(),
@@ -442,6 +454,21 @@ function normaliseDetails($method)
     ];
 }
 
+/**
+ * Resolve the parameters for the method.
+ *
+ * @param  \ReflectionMethodDecorator  $method
+ * @return \Illuminate\Support\Collection<int, \ReflectionParameter|\DynamicParameter>
+ */
+function resolveParameters($method)
+{
+    $dynamicParameters = resolveDocParameters($method)
+        ->skip($method->getNumberOfParameters())
+        ->mapInto(DynamicParameter::class);
+
+    return collect($method->getParameters())->merge($dynamicParameters);
+}
+
 /**
  * Resolve the default value for the parameter.
  *
@@ -505,3 +532,57 @@ public function sourceClass()
         return new ReflectionClass($this->sourceClass);
     }
 }
+
+class DynamicParameter
+{
+    /**
+     * @param  string  $definition
+     */
+    public function __construct(private $definition)
+    {
+        //
+    }
+
+    /**
+     * @return string
+     */
+    public function getName()
+    {
+        return Str::of($this->definition)
+            ->after('$')
+            ->before(' ')
+            ->toString();
+    }
+
+    /**
+     * @return bool
+     */
+    public function isOptional()
+    {
+        return true;
+    }
+
+    /**
+     * @return bool
+     */
+    public function isVariadic()
+    {
+        return Str::contains($this->definition, " ...\${$this->getName()}");
+    }
+
+    /**
+     * @return bool
+     */
+    public function isDefaultValueAvailable()
+    {
+        return true;
+    }
+
+    /**
+     * @return null
+     */
+    public function getDefaultValue()
+    {
+        return null;
+    }
+}

src/Illuminate/Support/Facades/Http.php

@@ -49,7 +49,7 @@
  * @method static \Illuminate\Http\Client\PendingRequest withMiddleware(callable $middleware)
  * @method static \Illuminate\Http\Client\PendingRequest beforeSending(callable $callback)
  * @method static \Illuminate\Http\Client\PendingRequest throw(callable|null $callback = null)
- * @method static \Illuminate\Http\Client\PendingRequest throwIf(callable|bool $condition)
+ * @method static \Illuminate\Http\Client\PendingRequest throwIf(callable|bool $condition, callable|null $throwCallback = null)
  * @method static \Illuminate\Http\Client\PendingRequest throwUnless(bool $condition)
  * @method static \Illuminate\Http\Client\PendingRequest dump()
  * @method static \Illuminate\Http\Client\PendingRequest dd()