Download the PHP package mrgarest/laravel-firebase-sender without Composer
On this page you can find all versions of the php package mrgarest/laravel-firebase-sender. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-firebase-sender
Laravel Firebase Sender
Laravel library for sending notifications with Firebase Cloud Messaging (FCM).
If you have previously used the old version of v2, you should read the instructions for migrating to v3.
⚠️ IMPORTANT UPDATE: This package has been renamed from mrgarest/laravel-firebase-sender to garest/firebase-sender.
Supported platforms
| ✅ | Platform |
|---|---|
| ✅ | Apns |
| ✅ | Android |
| ✅ | WebPush |
Installation
You can install the package via composer:
Configuration
After installing the package, you will need to publish the configuration file firebase-sender.php
After publishing the configuration file, you need to open it and add the Service account data from the Firebase console.
Usage
FirebaseSender is a class that is responsible for sending notification to devices via Firebase Cloud Messaging (FCM) using a service account with Firebase.
MY_SERVICE_ACCOUNT_NAME - the identifier of your service account registered in the firebase-sender.php configuration.
Send a notification to a specific device
To send a notification directly to the device, use the setDeviceToken method, passing in a unique device token generated by Firebase.
Note that you can use either setDeviceToken or setTopic. You cannot use both methods.
Send a notification on a specific topic
To send a notification to all devices subscribed to a specific topic, use the setTopic() method, passing the topic name as a string:
Topic conditions
The TopicCondition class allows you to create complex logical conditions for determining the topics to which a notification will be sent.
To send a notification to a combination of topics, you need to build a boolean expression that describes the target topics. The expression can contain the AND (&&) and OR (||) operators, as well as grouping using parentheses.
For example, to send a notification to devices subscribed to topicA and (topicB or topicC), you can build the following expression:
Set notifications
The setNotification method allows you to set the main content of the notification that will be sent through Firebase.
Set notifications for Android
The setAndroid method allows you to set the notification content for Android devices.
Set notifications for APNs
The setApns method allows you to set the notification content for APNs (Apple Push Notification Service).
Send a notification
After configuring the notification, you can send it by calling the send method.
If you don't want to send the message immediately, but want to schedule it for later, you can use the sendJob method. To use this method, queues must be configured in your Laravel project.
This method takes one required value and two optional values.
| Value | Type | Required | Description |
|---|---|---|---|
$scheduledAt |
Carbon |
Yes | Date when notification should be sent |
$chunkLength |
int |
No | Allows you to split messages into chunks |
$maxRand |
int |
No | Adds a random number of seconds to the chunk dispatch schedule |
Clear
When you need to send new notifications, you can simply clear the previously sent data without having to re-announce the class.
Grouping
Using the setGroup grouping method, you can send multiple messages at once by combining messages into groups.
Each group must have its own index, recipient, and message body.
Example of sending group notifications:
Custom messages
With this method, you can specify a custom data structure for the messages to be sent through FCM. This can be useful for sending additional information that is not included in the standard notification options.
When using setMessages, the setNotification, setAndroid and setApns methods will not work.
Localized notifications
AndroidPush and ApnsPush support sending localized notifications, which allows you to dynamically display text depending on the user's language.
To do this, use the titleLocKey and bodyLocKey parameters, which specify the keys to localized strings in your application's resources.
You can also specify the titleLocArgs and bodyLocArgs parameters, which can be used to pass values that will be inserted into localized notification templates.
Notification log
If you want to use the log of sent notifications, you will also need to publish the migration file and perform the migration.
To store information about sent notifications in the database, you can enable the event log.
The event log also supports two additional methods for adding payloads to the log.
FirebaseSenderLog Query Scopes
messageId
Filter logs by the message ID.
serviceAccount
Filter logs by the service account used to send the notification.
deviceToken
Filter logs by the device token (for notifications sent to a specific device).
Topic
Filters records where the topic exactly matches the value passed.
If you need to search for a topic that may appear as part of a condition, use the matchTopic method. It allows matching both exact topics and topics used in conditions.
By default, matchTopic checks for both exact and conditional matches. If you want to search only within conditions, pass true as the second argument:
Payload
payload1 and payload2 filter logs by the first value of the user payload.
createdBetween
Filter logs created between two dates.
sentBetween
Filter logs where the notification was sent between two dates.
scheduledBetween
Filter logs where the notification was scheduled between two dates.
failedBetween
Filter logs where the notification failed between two dates.
Google Access Token
If you only need an access token from Google to send messages from other platforms or for any other purpose, you can use the following example:
Events
When Firebase returns an error during sending (for example, invalid token or quota exhausted), the package generates a Garest\FirebaseSender\Events\FirebaseMessageFailed event. You can subscribe to this event to perform some actions.
