dwivedianuj9118/firebase-fcm-notification

This is laravel Firebase Cloud Messaging(FCM) Notification package for Php developer

dev-main 2025-05-11 15:48 UTC

Requires

• php: ^7.4|^8.0
• ext-json: *
• illuminate/support: ^8.0

Requires (Dev)

• guzzlehttp/guzzle: ^6.2|^7.0
• kreait/firebase-php: ^7.16
• orchestra/testbench: ^6.0
• phpunit/phpunit: ^9.0

MIT

• Anuj Dwivedi

• notifications
• laravel
• firebase
• FCM
• dwivedianuj9118
• firebase-fcm-notification

README

A Laravel wrapper to send Firebase Cloud Messaging (FCM) notifications via tokens, topics, or multicast using the kreait/firebase-php SDK.

📦 Installation

Install the package via Composer:

composer require dwivedianuj9118/firebase-fcm-notification

Vendor Publish

php artisan vendor:publish --tag=papaya-fcm-config

🔐 Setup

Add your Firebase credentials:

Download your firebase_credentials.json from Firebase Console.

Place the file at the following location in your Laravel project:

/public/firebase_credentials.json

✅ Features

Send push notifications to:

1. Individual device tokens
2. Topics
3. Multiple devices (Multicast)
4. Send both notification and data payloads
5. Logs notifications via Laravel logging

🚀 Usage

Import the NotificationService class:

use Dwivedianuj9118\FirebaseFcmNotification\NotificationService;

🔹 Send Notification to Device Token

NotificationService::sendTokenFcm(
    $fcmToken,
    'Welcome!', // Title
    'You have a new message.', // body Description
    'https://example.com/image.jpg' // Optional image
    'sound url' //Optional Sound 
);

🔹 Send Notification to Topic

NotificationService::sendTopicFcm(
    'news', // topic name
    'Breaking News!', // Title
    'Check out our latest update', // body Description
    null, // Optional image
    'default' //Optional Sound 
);

🔹 Send Multicast Notification (Multiple Devices)

NotificationService::sendMulticastFCM(
    [$token1, $token2], // multiple token separated by ,(commas)
    'Group Message', //Title 
    'This is sent to multiple devices.' // Body
);

Send Custom Notice (Flexible)

$data = [
    'title' => 'Custom Title',
    'body' => 'This is a custom message body',
    'custom_key' => 'custom_value'
];

// For notification
NotificationService::sendNotice($data, 'token', $fcmToken, 'notification');

// For data only
NotificationService::sendNotice($data, 'token', $fcmToken, 'data');

📝 Logging

All notifications and errors are automatically logged via Laravel’s Log::info and Log::error.

🛠 Dependencies

• kreait/firebase-php
• Laravel 8+

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Anuj Dwivedi
• All Contributors

License

The MIT License (MIT). Please see License File for more information.