How to Integrate Pusher Real‑Time Messaging into a Laravel Application

Overview

Pusher provides a real‑time messaging layer that maintains persistent connections to clients via WebSocket with HTTP fallback. It enables servers to push data instantly to browsers, mobile apps, or desktop clients.

Supported SDKs

Server‑side libraries are available for PHP, Ruby, Python, Java, .NET, Go, and Node.js. Client‑side libraries exist for JavaScript, Objective‑C (iOS), and Java (Android).

Typical Use Cases

Notifications or signal messages.

Activity streams such as social‑network feeds.

Real‑time data visualization dashboards.

Chat and instant messaging.

Integrating Pusher with Laravel

1. Obtain credentials

After creating a Pusher account, create an application in the dashboard. The dashboard displays app_id, key, and secret. These values are required for the Laravel broadcasting configuration.

2. Install the PHP package

composer require pusher/pusher-php-server

3. Configure Laravel broadcasting

// config/broadcasting.php
'connections' => [
    'pusher' => [
        'driver' => 'pusher',
        'key' => env('PUSHER_APP_KEY'),
        'secret' => env('PUSHER_APP_SECRET'),
        'app_id' => env('PUSHER_APP_ID'),
        'options' => [
            'cluster' => env('PUSHER_APP_CLUSTER'),
            'useTLS' => true,
        ],
    ],
],

4. Publish JavaScript client

npm install pusher-js --save
// In resources/js/bootstrap.js
import Echo from 'laravel-echo';
window.Pusher = require('pusher-js');
window.Echo = new Echo({
    broadcaster: 'pusher',
    key: process.env.MIX_PUSHER_APP_KEY,
    cluster: process.env.MIX_PUSHER_APP_CLUSTER,
    forceTLS: true,
});

5. Debugging

The Pusher dashboard includes a Debug Console that logs API calls and connection events, useful for verifying that events are being broadcast correctly.