[8.x] Ability to specify the broadcaster to use when broadcasting an event (#7213)

* WIP

* formatting

Co-authored-by: Taylor Otwell <[email protected]>

Author: clemblanco

broadcasting.md

@@ -23,6 +23,7 @@
     - [Defining Channel Classes](#defining-channel-classes)
 - [Broadcasting Events](#broadcasting-events)
     - [Only To Others](#only-to-others)
+    - [Customizing The Connection](#customizing-the-connection)
 - [Receiving Broadcasts](#receiving-broadcasts)
     - [Listening For Events](#listening-for-events)
     - [Leaving A Channel](#leaving-a-channel)
@@ -642,6 +643,41 @@ If you are not using a global Axios instance, you will need to manually configur
 
     var socketId = Echo.socketId();
 
+<a name="customizing-the-connection"></a>
+### Customizing The Connection
+
+If your application interacts with multiple broadcast connections and you want to broadcast an event using a broadcaster other than your default, you may specify which connection to push an event to using the `via` method:
+
+    use App\Events\OrderShipmentStatusUpdated;
+
+    broadcast(new OrderShipmentStatusUpdated($update))->via('pusher');
+
+Alternatively, you may specify the event's broadcast connection by calling the `broadcastVia` method within the event's constructor:
+
+    <?php
+
+    namespace App\Events;
+
+    use Illuminate\Broadcasting\Channel;
+    use Illuminate\Broadcasting\InteractsWithSockets;
+    use Illuminate\Broadcasting\PresenceChannel;
+    use Illuminate\Broadcasting\PrivateChannel;
+    use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
+    use Illuminate\Queue\SerializesModels;
+
+    class OrderShipmentStatusUpdated implements ShouldBroadcast
+    {
+        /**
+         * Create a new event instance.
+         *
+         * @return void
+         */
+        public function __construct()
+        {
+            $this->broadcastVia('pusher');
+        }
+    }
+
 <a name="receiving-broadcasts"></a>
 ## Receiving Broadcasts