carloswgama/php-fcm

Class PHP para o uso do Firebase Cloud Message

PHP - FCM

Classe facilitar o uso do Firebase Cloud Message através de um Webservice com PHP, _(*1)

Essa biblioteca PHP será útil para quem já usa o FCM para o uso Push Notification em seus Smartphones, porém necessita que o envio da notificação seja feito por um servidor em PHP., _(*2)

Obtendo a Chave do Servidor

Esse tutorial está levando em considerção que já tenha criado um projeto no Firebase e configurado no seu aplicativo, ou seja, apenas será demonstrado como usar essa biblioteca no servidor PHP para o envio do Push Notification e não o recebimento no Smartphone., _(*3)

Caso tenha dúvidas de como receber a notificação, basta olhar a documentação do Google para o recebimento de notificações, _(*4)

Documentação de como Receber Notificações no Aplicativo, _(*5)

Inicialmelnte entre no seu Console do Firebase e escolha o projeto que deseja trabalhar: , _(*6)

Após acessar o seu projeto, clique na engrenagem para acessar as configurações do projeto: , _(*7)

Na tela de configurações, basta clicar na aba Cloud Message e já poderá ver a Chave do Servidor (Inclusive adicionar novas chaves) , _(*8)

Baixando o projeto

Para usar esse projeto, basta baixar esse repositório em seu projeto e importar a classe em src/FCM.php ou usar o composer que é o mais indicado:, _(*9)

composer require carloswgama/php-fcm

Caso seu projeto já possua um arquivo composer.json, você pode também adiciona-lo nas dependências require e rodar um composer install:, _(*10)

{
    "require": {
        "carloswgama/php-fcm"
    }
}

Exemplos

Abaixo segue alguns exemplos de como usar a classe, _(*11)

Enviando para um Dispositivo

``` php <?php require_once(dirname(FILE).'/vendor/autoload.php'); use CWG\Firebase\FCM;, <sub>(*12)</sub>

//Chave do Servidor para o envio de Push Notificação $chaveServidor = 'AAAAgRytSgU:APA91bHeexGgSTjr6imnXCqxnP_k_tZ6VqPOZQ1QQ4Ck3-ozyNq5BP3fULtu-YGTZgZMF27QOfYQFqM8szV0t_nxNSCeu7dO1mWMMTOR7L_onWZLb8CC3ZIG-OQxUgiBNqNwV5HtGqw';, <sub>(*13)</sub>

//Token do Dispositivo $tokenDispositivo = 'ePQ_mDC90Hs:APA91bF-nz_jkGunC3eGU5hz2EhXGXute9AI2XlYLgC3XlY6MLDSw-GE5jhF7X77FFKLqFyW_S15RPx4qmAiqEl9I7V8n9N7QHc2OUP70ML14FK5KFMBrfKjtUVU0jcE0B9ropjIOmk';, <sub>(*14)</sub>

//Classe para o envio $fcm = new FCM($chaveServidor);, <sub>(*15)</sub>

try { $resultado = $fcm->setTitulo('Título - Dispositívo') ->setTexto('Textoo - Dispositívo') ->enviarPara($tokenDispositivo);, <sub>(*16)</sub>

echo "Enviado com sucesso!<br/>";
print_r($resultado);

} catch(Exception $e) { echo "Erro: " . $e->getMessage(); }, <sub>(*17)</sub>

### Enviando para um tópico

``` php
<?php
require_once(dirname(__FILE__).'/vendor/autoload.php');
use CWG\Firebase\FCM;

//Chave do Servidor para o envio de Push Notificação
$chaveServidor = 'AAAAgRytSgU:APA91bHeexGgSTjr6imnXCqxnP_k_tZ6VqPOZQ1QQ4Ck3-ozyNq5BP3fULtu-YGTZgZMF27QOfYQFqM8szV0t_nxNSCeu7dO1mWMMTOR7L_onWZLb8CC3ZIG-OQxUgiBNqNwV5HtGqw';

//Classe para enviar 
$fcm = new FCM($chaveServidor);

try {
    $resultado = $fcm->setTitulo('Título - Dispositívo')
                        ->setTexto('Textoo - Dispositívo')
                        ->enviarTopico('literatura');

    echo "Enviado com sucesso!<br/>";
    print_r($resultado);    
} catch(Exception $e) {
    echo "Erro: " . $e->getMessage();
}

Enviando com dados extras (data)

``` php <?php require_once(dirname(FILE).'/vendor/autoload.php'); use CWG\Firebase\FCM;, <sub>(*18)</sub>

//Chave do Servidor para o envio de Push Notificação $chaveServidor = 'AAAAgRytSgU:APA91bHeexGgSTjr6imnXCqxnP_k_tZ6VqPOZQ1QQ4Ck3-ozyNq5BP3fULtu-YGTZgZMF27QOfYQFqM8szV0t_nxNSCeu7dO1mWMMTOR7L_onWZLb8CC3ZIG-OQxUgiBNqNwV5HtGqw';, <sub>(*19)</sub>

//Classe para enviar $fcm = new FCM($chaveServidor);, <sub>(*20)</sub>

$dadosExtras = ['nome' => 'Carlos', 'cargo' => 'programador'];, <sub>(*21)</sub>

try { $resultado = $fcm->setTitulo('Título - Dispositívo') ->setTexto('Textoo - Dispositívo') ->setExtras($dadosExtras) ->enviarTopico('literatura');, <sub>(*22)</sub>

echo "Enviado com sucesso!<br/>";
print_r($resultado);    

} catch(Exception $e) { echo "Erro: " . $e->getMessage(); } ```, <sub>(*23)</sub>

Nos links acima você poderá ver diversos exemples para criar plano, assinatura, compra, notificações..., <sub>(*24)</sub>

Autor: Carlos W. Gama (carloswgama@gmail.com) Licença: MIT, <sub>(*25)</sub>

Livre para usar, modificar como desejar e destribuir como quiser, <sub>(*26)</sub>