Download the PHP package elitexp/fcm without Composer
On this page you can find all versions of the php package elitexp/fcm. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package fcm
Short Description Laravel / Lumen package for Firebase Cloud Messaging forked from brozot
License MIT
Informations about the package fcm
Laravel-FCM
Introduction
Laravel-FCM is an easy to use package working with both Laravel and Lumen for sending push notification with Firebase Cloud Messaging (FCM).
It currently only supports HTTP protocol for :
- sending a downstream message to one or multiple devices
- managing groups and sending message to a group
- sending topics messages
Note: The XMPP protocol is not currently supported.
Installation
To get the latest version of Laravel-FCM on your project, require it from "composer":
$ composer require brozot/laravel-fcm
Or you can add it directly in your composer.json file:
Laravel
Register the provider directly in your app configuration file config/app.php config/app.php
:
Laravel >= 5.5 provides package auto-discovery, thanks to rasmuscnielsen and luiztessadri who help to implement this feature in Laravel-FCM, the registration of the provider and the facades should not be necessary anymore.
Add the facade aliases in the same file:
Note: The
FCMGroup
facade is needed only if you want to manage groups messages in your application.
Publish the package config file using the following command:
$ php artisan vendor:publish --provider="LaravelFCM\FCMServiceProvider"
Lumen
Register the provider in your bootstrap app file
Add the following line in the "Register Service Providers" section at the bottom of the file.
For facades, add the following lines in the section "Create The Application" . FCMGroup facade is only necessary if you want to use groups message in your application.
Copy the config file manually from the directory to the directory (you may need to create this directory).
Package Configuration
In your .env
file, add the server key and the secret key for the Firebase Cloud Messaging:
To get these keys, you must create a new application on the firebase cloud messaging console.
After the creation of your application on Firebase, you can find keys in project settings -> cloud messaging
.
Basic Usage
Two types of messages can be sent using Laravel-FCM:
- Notification messages, sometimes thought of as "display messages"
- Data messages, which are handled by the client app
More information is available in the official documentation.
Downstream Messages
A downstream message is a notification message, a data message, or both, that you send to a target device or to multiple target devices using its registration_Ids.
The following use statements are required for the examples below:
Sending a Downstream Message to a Device
Sending a Downstream Message to Multiple Devices
Kindly refer Downstream message error response codes documentation for more information.
Topics Messages
A topics message is a notification message, data message, or both, that you send to all the devices registered to this topic.
Note: Topic names must be managed by your app and known by your server. The Laravel-FCM package or fcm doesn't provide an easy way to do that.
The following use statement is required for the examples below:
Sending a Message to a Topic
Sending a Message to Multiple Topics
It sends notification to devices registered at the following topics:
- news and economic
- news and cultural
Note : Conditions for topics support two operators per expression
Group Messages
Sending a Notification to a Group
Creating a Group
Adding Devices to a Group
Deleting Devices from a Group
Note if all devices are removed from the group, the group is automatically removed in "fcm".
Options
Laravel-FCM supports options based on the options of Firebase Cloud Messaging. These options can help you to define the specificity of your notification.
You can construct an option as follows:
Notification Messages
Notification payload is used to send a notification, the behaviour is defined by the App State and the OS of the receptor device.
Notification messages are delivered to the notification tray when the app is in the background. For apps in the foreground, messages are handled by these callbacks:
- didReceiveRemoteNotification: on iOS
- onMessageReceived() on Android. The notification key in the data bundle contains the notification.
See the official documentation.
Data Messages
Set the data key with your custom key-value pairs to send a data payload to the client app. Data messages can have a 4KB maximum payload.
- iOS, FCM stores the message and delivers it only when the app is in the foreground and has established a FCM connection.
- Android, a client app receives a data message in onMessageReceived() and can handle the key-value pairs accordingly.
See the official documentation.
Notification & Data Messages
App behavior when receiving messages that include both notification and data payloads depends on whether the app is in the background or the foreground—essentially, whether or not it is active at the time of receipt (source).
- Background, apps receive notification payload in the notification tray, and only handle the data payload when the user taps on the notification.
- Foreground, your app receives a message object with both payloads available.
Topics
For topics message, Laravel-FCM offers an easy to use api which abstract firebase conditions. To make the condition given for example in the firebase official documentation it must be done with Laravel-FCM like below:
Official documentation condition
Testing
For integration testing, you can mock the responses with mockery and Mocks provided by the package.
There are 3 kinds of "MockResponse" given by the package:
- MockDownstreamResponse
- MockGroupResponse
- MockTopicResponse
You can mock the FCM call as in the following example:
API Documentation
You can find more documentation about the API in the API reference.
Licence
This library is open-sourced software licensed under the MIT license.
Some of this documentation is coming from the official documentation. You can find it completely on the Firebase Cloud Messaging Website.