Awesome
Notificato for Symfony2 & Symfony3
Notificato takes care of push notifications in your Symfony2 & Symfony3 projects.
Italian: notificato è: participio passato English: notified
What is Notificato?
Notificato makes you send push messages from PHP projects, this repository is a Symfony2 & Symfony3 bundle to easily integrate into Symfony. Want to know more about Notificato? Please check out the Notificate repository for more information.
Installation
1. Add Composer dependency
Installation with Composer is recommended. Run the require command to add Notificato to your project:
composer require wrep/notificato-symfony
2. Include the bundle in your Kernel
Add NotificatoBundle
to app/AppKernel.php
:
public function registerBundles()
{
$bundles = array(
...
new Wrep\Bundle\NotificatoBundle\NotificatoBundle(),
...
);
}
3. Configuration of the default certificate
Add the following configuration options to your app/config.yml
:
notificato:
apns:
certificate:
pem: /path/to/pem/certificate.pem # Required if you want to use a default certificate
passphrase: the-passphrase-of-the-pem # Required if you want to use a default certificate
validate: true # Optional, default true, set to false if certificate validation fails
environment: sandbox # Optional, autodetect by default, set to production/sandbox if certificate validation fails
The given certificate will be used as default certificate. It's completely optional to set a default certificate, but recommended if you only push to one App.
Getting started
Once installed you can start using Notificato quite easily from any ContainerAware
-environment. Lets say you want to send a pushmessage from a controller:
class PushController extends Controller
{
public function indexAction()
{
// First we get a Notificato instance
$notificato = $this->get('notificato');
// Now let us get a fresh message from Notificato
// This message will be send to device with pushtoken 'fffff...'
// it will automaticly be associated with the default certificate
$message = $notificato->createMessage('ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff');
// Let's set App icon badge with this push to 1
$message->setBadge(1);
// The message is ready, let's send it!
// Be aware that this method is blocking and on failure Notificato will retry a few times
$messageEnvelope = $notificato->send($message);
// The returned envelope contains usefull information about how many retries where needed and if sending succeeded
echo $messageEnvelope->getFinalStatusDescription();
// Of course you should return a nice Response here!
}
}
Use $this->get('notificato');
to get a Notificato object that is already set up with the default certificate from the config. From there everything is the same as using the normal Notificato library, so check out the docs and API description over there for more tips and tricks.
Note that there are more services available to get deeper into the Notificare structure, take a look at the services.xml if you're interested.
Contribute
We'll love contributions, read the Notificato Contribute.md for some more info on what you can do and stuff that you should know if you want to help!
Please note that issues and feature requests specific to Notificato for Symfony2 & Symfony3 are tracked in the GitHub issue tracker with this repository. Issues and feature requests for Noticare itself can be submitted at the issue tracker at that repository.
License & Credits
Notificato for Symfony2 & Symfony3 is released under the MIT License by Rick Pastoor & Mathijs Kadijk, so feel free to use it in commercial and non-commercial projects.