laravel-notification-channels / fcm by coreproc

FCM (Firebase Cloud Messaging) Notifications Driver for Laravel

2,870,739

429

Package Data
Maintainer Username:	coreproc
Maintainer Contact:	chris.bautista@coreproc.ph (Chris Bautista)
Package Create Date:	2019-09-18
Package Last Update:	2024-03-16
Home Page:	https://laravel-notification-channels.com/
Language:	PHP
License:	MIT
Last Refreshed:	2024-04-18 15:26:59

Package Statistics
Total Downloads:	2,870,739
Monthly Downloads:	99,965
Daily Downloads:	4,728
Total Stars:	429
Total Watchers:	12
Total Forks:	113
Total Open Issues:	1

Laravel FCM (Firebase Cloud Messaging) Notification Channel

This package makes it easy to send notifications using Firebase Cloud Messaging (FCM) with Laravel 5.5+, 6.x, and 7.x.

Version 2 Released (March 4, 2020)

V2.0.0 has been released and FCM API calls has been migrated from legacy HTTP to HTTP v1 (docs from Firebase here). This is a breaking change so notifications using v1.x should not upgrade to v2.x of this package unless you plan on migrating your notification classes.

Installation

Install this package with Composer:

composer require laravel-notification-channels/fcm:^2.0

Setting up the FCM service

This package now uses the laravel-firebase library to authenticate and make the API calls to Firebase. Follow the configuration steps specified in their readme before using this.

After following their configuration steps, make sure that you've specified your FIREBASE_CREDENTIALS in your .env file.

Usage

After setting up your Firebase credentials, you can now send notifications via FCM by a Notification class and sending it via the FcmChannel::class. Here is an example:

use Illuminate\Notifications\Notification;
use NotificationChannels\Fcm\FcmChannel;
use NotificationChannels\Fcm\FcmMessage;
use NotificationChannels\Fcm\Resources\AndroidConfig;
use NotificationChannels\Fcm\Resources\AndroidFcmOptions;
use NotificationChannels\Fcm\Resources\AndroidNotification;
use NotificationChannels\Fcm\Resources\ApnsConfig;
use NotificationChannels\Fcm\Resources\ApnsFcmOptions;

class AccountActivated extends Notification
{
    public function via($notifiable)
    {
        return [FcmChannel::class];
    }

    public function toFcm($notifiable)
    {
        return FcmMessage::create()
            ->setData(['data1' => 'value', 'data2' => 'value2'])
            ->setNotification(\NotificationChannels\Fcm\Resources\Notification::create()
                ->setTitle('Account Activated')
                ->setBody('Your account has been activated.')
                ->setImage('http://example.com/url-to-image-here.png'))
            ->setAndroid(
                AndroidConfig::create()
                    ->setFcmOptions(AndroidFcmOptions::create()->setAnalyticsLabel('analytics'))
                    ->setNotification(AndroidNotification::create()->setColor('#0A0A0A'))
            )->setApns(
                ApnsConfig::create()
                    ->setFcmOptions(ApnsFcmOptions::create()->setAnalyticsLabel('analytics_ios')));
    }
}

You will have to set a routeNotificationForFcm() method in your notifiable model. For example:

class User extends Authenticatable
{
    use Notifiable;

    ....

    /**
     * Specifies the user's FCM token
     *
     * @return string
     */
    public function routeNotificationForFcm()
    {
        return $this->fcm_token;
    }
}

Once you have that in place, you can simply send a notification to the user by doing the following:

$user->notify(new AccountActivated);

Available Message methods

The FcmMessage class contains the following methods for defining the payload. All these methods correspond to the available payload defined in the FCM API documentation. Refer to this link to find all the available data you can set in your FCM notification.

setName(string $name)

setData(array $data)

setNotification(\NotificationChannels\Fcm\Resources\Notification $notification)

setAndroid(NotificationChannels\Fcm\Resources\AndroidConfig $androidConfig)

setApns(NotificationChannels\Fcm\Resources\ApnsConfig $apnsConfig)

setWebpush(NotificationChannels\Fcm\Resources\WebpushConfig $webpushConfig)

setFcmOptions(NotificationChannels\Fcm\Resources\FcmOptions $fcmOptions)

setTopic(string $topic)

setCondition(string $condition)

Changelog

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Security

If you discover any security related issues, please email chrisbjr@gmail.com instead of using the issue tracker.