Improves property promotion docs (#8546)

Author: nunomaduro

blade.md

@@ -768,10 +768,9 @@ Component constructor arguments should be specified using `camelCase`, while `ke
     /**
      * Create the component instance.
      */
-    public function __construct(string $alertType)
-    {
-        $this->alertType = $alertType;
-    }
+    public function __construct(
+        public string $alertType,
+    ) {}
 
 The `$alertType` argument may be provided to the component like so:
 
@@ -868,12 +867,11 @@ use App\Services\AlertCreator;
 /**
  * Create the component instance.
  */
-public function __construct(AlertCreator $creator, string $type, string $message)
-{
-    $this->creator = $creator;
-    $this->type = $type;
-    $this->message = $message;
-}
+public function __construct(
+    public AlertCreator $creator,
+    public string $type,
+    public string $message,
+) {}
 ```
 
 <a name="hiding-attributes-and-methods"></a>
@@ -889,19 +887,19 @@ If you would like to prevent some public methods or properties from being expose
 
     class Alert extends Component
     {
-        /**
-         * The alert type.
-         *
-         * @var string
-         */
-        public $type;
-
         /**
          * The properties / methods that should not be exposed to the component template.
          *
          * @var array
          */
         protected $except = ['type'];
+
+        /**
+         * Create the component instance.
+         */
+        public function __construct(
+            public string $type,
+        ) {}
     }
 
 <a name="component-attributes"></a>

cashier-paddle.md

@@ -1232,11 +1232,8 @@ Alternatively, you can perform more precise customization by [listening](/docs/{
     {
         /**
          * Handle received Paddle webhooks.
-         *
-         * @param  \Laravel\Paddle\Events\WebhookReceived  $event
-         * @return void
          */
-        public function handle(WebhookReceived $event)
+        public function handle(WebhookReceived $event): void
         {
             if ($event->payload['alert_name'] === 'subscription_payment_failed') {
                 // Handle the failed subscription payment...

collections.md

@@ -1347,10 +1347,9 @@ The `mapInto()` method iterates over the collection, creating a new instance of
         /**
          * Create a new currency instance.
          */
-        function __construct(string $code)
-        {
-            $this->code = $code;
-        }
+        function __construct(
+            public string $code
+        ) {}
     }
 
     $collection = collect(['USD', 'EUR', 'GBP']);
@@ -1934,7 +1933,7 @@ The `reduceSpread` method reduces the collection to an array of values, passing
 
     [$creditsRemaining, $batch] = Image::where('status', 'unprocessed')
         ->get()
-        ->reduceSpread(function ($creditsRemaining, $batch, $image) {
+        ->reduceSpread(function (int $creditsRemaining, Collection $batch, Image $image) {
             if ($creditsRemaining >= $image->creditsRequired()) {
                 $batch->push($image);
 

container.md

@@ -184,10 +184,9 @@ This statement tells the container that it should inject the `RedisEventPusher`
     /**
      * Create a new class instance.
      */
-    public function __construct(EventPusher $pusher)
-    {
-        $this->pusher = $pusher;
-    }
+    public function __construct(
+        protected EventPusher $pusher
+    ) {}
 
 <a name="contextual-binding"></a>
 ### Contextual Binding
@@ -247,13 +246,6 @@ Occasionally, you may have a class that receives an array of typed objects using
 
     class Firewall
     {
-        /**
-         * The logger instance.
-         *
-         * @var \App\Services\Logger
-         */
-        protected $logger;
-
         /**
          * The filter instances.
          *
@@ -264,9 +256,10 @@ Occasionally, you may have a class that receives an array of typed objects using
         /**
          * Create a new class instance.
          */
-        public function __construct(Logger $logger, Filter ...$filters)
-        {
-            $this->logger = $logger;
+        public function __construct(
+            protected Logger $logger,
+            Filter ...$filters,
+        ) {
             $this->filters = $filters;
         }
     }
@@ -366,10 +359,9 @@ If you would like to have the Laravel container instance itself injected into a
     /**
      * Create a new class instance.
      */
-    public function __construct(Container $container)
-    {
-        $this->container = $container;
-    }
+    public function __construct(
+        protected Container $container
+    ) {}
 
 <a name="automatic-injection"></a>
 ### Automatic Injection

helpers.md

@@ -928,7 +928,7 @@ You may also sort the array by the results of a given closure:
         ['name' => 'Chair'],
     ];
 
-    $sorted = array_values(Arr::sortDesc($array, function ($value) {
+    $sorted = array_values(Arr::sortDesc($array, function (array $value) {
         return $value['name'];
     }));
 
@@ -4072,8 +4072,8 @@ The `value` function returns the value it is given. However, if you pass a closu
 
 Additional arguments may be passed to the `value` function. If the first argument is a closure then the additional parameters will be passed to the closure as arguments, otherwise they will be ignored:
 
-    $result = value(function ($name) {
-        return $parameter;
+    $result = value(function (string $name) {
+        return $name;
     }, 'Taylor');
 
     // 'Taylor'

horizon.md

@@ -143,7 +143,7 @@ Horizon exposes a dashboard at the `/horizon` URI. By default, you will only be
 <a name="alternative-authentication-strategies"></a>
 #### Alternative Authentication Strategies
 
-Remember that Laravel automatically injects the authenticated user into the gate closure. If your application is providing Horizon security via another method, such as IP restrictions, then your Horizon users may not need to "login". Therefore, you will need to change `function ($user)` closure signature above to `function ($user = null)` in order to force Laravel to not require authentication.
+Remember that Laravel automatically injects the authenticated user into the gate closure. If your application is providing Horizon security via another method, such as IP restrictions, then your Horizon users may not need to "login". Therefore, you will need to change `function (User $user)` closure signature above to `function (User $user = null)` in order to force Laravel to not require authentication.
 
 <a name="silenced-jobs"></a>
 ### Silenced Jobs

http-tests.md

@@ -1056,7 +1056,7 @@ Assert that the session contains the given piece of data:
 
 If needed, a closure can be provided as the second argument to the `assertSessionHas` method. The assertion will pass if the closure returns `true`:
 
-    $response->assertSessionHas($key, function ($value) {
+    $response->assertSessionHas($key, function (User $value) {
         return $value->name === 'Taylor Otwell';
     });
 
@@ -1069,7 +1069,7 @@ Assert that the session has a given value in the [flashed input array](/docs/{{v
 
 If needed, a closure can be provided as the second argument to the `assertSessionHasInput` method. The assertion will pass if the closure returns `true`:
 
-    $response->assertSessionHasInput($key, function ($value) {
+    $response->assertSessionHasInput($key, function (string $value) {
         return Crypt::decryptString($value) === 'secret';
     });
 

localization.md

@@ -192,10 +192,8 @@ In these cases, Laravel allows you to register a custom formatting handler for t
 
     /**
      * Bootstrap any application services.
-     *
-     * @return void
      */
-    public function boot()
+    public function boot(): void
     {
         Lang::stringable(function (Money $money) {
             return $money->formatTo('en_GB');

mail.md

@@ -1039,6 +1039,7 @@ Laravel includes a variety of mail transports; however, you may wish to write yo
     use MailchimpTransactional\ApiClient;
     use Symfony\Component\Mailer\SentMessage;
     use Symfony\Component\Mailer\Transport\AbstractTransport;
+    use Symfony\Component\Mime\Address;
     use Symfony\Component\Mime\MessageConverter;
 
     class MailchimpTransport extends AbstractTransport
@@ -1061,7 +1062,7 @@ Laravel includes a variety of mail transports; however, you may wish to write yo
 
             $this->client->messages->send(['message' => [
                 'from_email' => $email->getFrom(),
-                'to' => collect($email->getTo())->map(function ($email) {
+                'to' => collect($email->getTo())->map(function (Address $email) {
                     return ['email' => $email->getAddress(), 'type' => 'to'];
                 })->all(),
                 'subject' => $email->getSubject(),

notifications.md

@@ -209,9 +209,9 @@ Or, if you would like to specify a specific queue connection that should be used
     /**
      * Determine which connections should be used for each notification channel.
      *
-     * @return array
+     * @return array<string, string>
      */
-    public function viaConnections()
+    public function viaConnections(): array
     {
         return [
             'mail' => 'redis',