Download the PHP package larafact/spn without Composer

On this page you can find all versions of the php package larafact/spn. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package spn

SPN - Simple Push Notification

A very simple way for sending, and nothing else, push notifications using FireBase Clouding Messaging.

About

Package for Pushing Notifications using Firebase Cloud Messaging Protocol.

Such as its name suggests, the package is intended for providing a simple way for pushing notifications, and nothing else.

Note: It has not any support for pushing messages or notifications based on topics

Main features about SPN are:

For all about errors and exception triggering, please take a look at:

Installation

Require the latest version of Spn into your project

Or you can add it directly into your project's composer.json file:

Laravel configuration

Register the Spn Service Provider into your app configuration file config/app.php:

Then publish the package config file:

And finally in your .env file, add your Server's keys and project ID using the Keys you got from FCM:

To get these keys, you must create a new application on the Firebase Cloud Messaging console.

Getting started

Once everything is installed and configured, you can start to using all the helpers exposed by SPN, to achieve all tasks related with

Push Notifications

SPN can only handle Notification Messages via Firebase Http Protocol. The XMPP protocol is not currently supported.

Single Device

Multiple devices

Devices Group

Handling responses

Once a notification message has been sent, SPN holds the FCM response, so you can querying it for useful information. Check it out the following examples:

Getting the FCM's raw response

it returns:

Response's stats

it returns:

If you like to get only an specific stats information, you can use one of the following methods:

Note: For notification messages sent to a Device Group, the shouldBeDeleted, and shouldBeResend always be null.

Handling errors and Exceptions.

SPN config file config/spn.php defines 2 keys for specifying how errors should be handled:

SPN defines the following exceptions:

Device Group Messaging

According FCM:

"With device group messaging, you can send a single message to multiple instances of an app running on devices belonging to a group. Typically, "group" refers a set of different devices that belong to a single user. All devices in a group share a common notification key, which is the token that FCM uses to fan out messages to all devices in the group."

SPN exposes helpers for Device Group Management tasks:

Creating a Device Group

it replies with a notification_key:

Adding members to a Device Group

it replies with a notification_key:

Removing members from a Device Group

it replies with a notification_key:

License

Copyright (c) 2017 - Cobis ([email protected])

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


All versions of spn with dependencies

PHP Build Version
Package Version
Requires php Version ^7.0
guzzlehttp/guzzle Version ~6.0
illuminate/support Version >=5.2.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package larafact/spn contains the following files

Loading the files please wait ....