Si të dërgoni njoftime Push Mobile me PHP dhe Firebase

Shërbimi i Google Firebase Cloud Messaging (FCM) është një mënyrë e lirë dhe e përshtatshme për të shpërndarë njoftime shtytëse në pajisjet celulare. Ai funksionon me objektivat iOS, Android dhe ueb, duke abstraguar dallimet midis platformave. Ju dërgoni ngarkesën tuaj një herë në API të Firebase dhe merrni dorëzim në kohë reale për të gjithë përdoruesit tuaj.

Në këtë artikull, ne do të tregojmë se si të përdorim Firebase për të dërguar njoftime shtytëse nga kodi juaj PHP nga ana e serverit. Ne po përdorim bibliotekën e palëve të treta php-firebase-cloud-messaging (PHP-FCM) për të thjeshtuar më tej integrimin e Firebase.

Përvijimi i Arkitekturës

Dërgimi i suksesshëm i një njoftimi shtytës kërkon që disa komponentë të punojnë së bashku. Së pari ju duhet një llogari aktive Firebase me një projekt që ka aktivizuar FCM. Ne do ta rregullojmë këtë në hapat e mëposhtëm. Do t'ju lëshohet një çelës serveri që mbështetja juaj PHP duhet të përfshijë me kërkesat e tij Firebase.

Do t'ju duhet gjithashtu një aplikacion që përdor Firebase SDK për të prodhuar një shenjë regjistrimi të klientit. Kjo shenjë duhet të dërgohet në bazën tuaj të PHP-së. Mbajeni atë në bazën tuaj të të dhënave së bashku me informacionin që identifikon klientin, si p.sh. ID-ja e përdoruesit të regjistruar brenda aplikacionit tuaj.

Meqenëse ky artikull fokusohet në integrimin e backend-it, ne do të supozojmë se keni tashmë një aplikacion klienti Firebase që pajtohet në njoftime dhe merr një shenjë regjistrimi. Mund të ndiqni dokumentacionin për të krijuar një aplikacion bazë Android nëse keni nevojë për një projekt shembull. Brenda kodit të klientit, dërgoni tokenin Firebase në një pikë fundore API që do të krijoni në shërbimin tuaj PHP.

Pasi të keni në dispozicion disa shenja klienti në serverin tuaj, mund të dërgoni njoftime shtytëse duke bërë kërkesa HTTP në API FCM. Firebase do të ndërmjetësojë me platformat individuale të shpërndarjes së njoftimeve, duke e shtyrë sinjalizimin tuaj në pajisjet e specifikuara. FCM harton nga brenda çdo shenjë klienti në platformën e duhur, të tilla si Shërbimet e Google Play për Android dhe Shërbimi i Njoftimeve Push Apple (APNS) për iOS.

Krijimi i projektit tuaj Firebase

Drejtohuni te Konsola e Firebase, identifikohuni dhe klikoni Shto projekt për të filluar konfigurimin e integrimit tuaj. Jepni një emër projektit tuaj dhe klikoni përmes kërkesave të konfigurimit fillestar. Klikoni butonin e cilësimeve në pjesën e sipërme majtas kur të arrini në panelin e kontrollit. Zgjidhni Cilësimet e projektit nga menyja që shfaqet.

Shkoni te skeda Mesazhet në renë kompjuterike dhe shënoni çelësin tuaj të serverit. Shërbimi juaj PHP do ta përdorë këtë kredenciale për të dërguar njoftime në API të Firebase.

Duhet të regjistroni aplikacionet tuaja celulare brenda konsolës Firebase. Kthehuni në faqen kryesore, përdorni butonat Shto një aplikacion për të shtuar komponentët tuaj iOS dhe Android. Ndiqni magjistarin e konfigurimit për të siguruar të dhënat e aplikacionit tuaj dhe për të shkarkuar skedarin e konfigurimit të tij Firebase. Kjo duhet të referohet kur inicializon Firebase në kodin e klientit.

Nëse po ndërtoni një aplikacion iOS, duhet të lidhni manualisht çelësin tuaj APNS me Firebase. Klikoni butonin e cilësimeve në pjesën e sipërme majtas, zgjidhni Cilësimet e projektit dhe lundroni përsëri te Mesazhet në renë kompjuterike. Një seksion Apple Apps do të shfaqet kur të keni një komponent iOS në projektin tuaj. Shtoni një çelës APNS ose certifikatë nga llogaria juaj e zhvilluesit të Apple për të përfunduar integrimin. Kjo lejon FCM të dërgojë njoftime në APNS në emrin tuaj.

Përgatitja e aplikacionit tuaj PHP

Filloni projektin tuaj PHP duke shtuar bibliotekën PHP-FCM duke përdorur Composer:

composer require sngrl/php-firebase-cloud-messaging

Brenda kodit tuaj, krijoni një shembull të klasës Klient të PHP-FCM:

use sngrlPhpFirebaseCloudMessagingClientClient;
 
$client = new Client();
$client -> setApiKey("FCM-SERVER-KEY");
$client -> injectGuzzleHttpClient(new GuzzleHttpClient());

$token = $_POST["fcmToken"];
$userId = ((int) $_POST["userId"]);
 
/**
 * Call a function which persists a user/token 
 * association to your database
 */
saveUserFcmToken($userId, $token);

use sngrlPhpFirebaseCloudMessagingClientNotification;
 
$notification = new Notification(
    "Notification Title",
    "The longer text of the notification, displayed below the title."
);

use sngrlPhpFirebaseCloudMessagingClientMessage;
 
$message = new Message();
$message -> setNotification($notification);

use sngrlPhpFirebaseCloudMessagingClientRecipientDevice;
 
$message -> addReceipient(new Device("FCM-CLIENT-TOKEN-USER-1"));
$message -> addReceipient(new Device("FCM-CLIENT-TOKEN-USER-2"));

$client -> send($message);

use sngrlPhpFirebaseCloudMessagingClientClient;
use sngrlPhpFirebaseCloudMessagingClientMessage;
use sngrlPhpFirebaseCloudMessagingClientNotification;
use sngrlPhpFirebaseCloudMessagingClientRecipientDevice;
 
$client = new Client();
$client -> setApiKey("FCM-SERVER-KEY");
$client -> injectGuzzleHttpClient(new GuzzleHttpClient());
 
function sendNotification(
    Client $client,
    string $title,
    string $body,
    string ...$clientTokens) : void {
 
    $message = new Message();
 
    $message -> setNotification(
        new Notification(
            $title,
            $body
        )
    );
 
    foreach ($clientTokens as $clientToken) {
        $message -> addRecipient(new Device($clientToken));
    }
 
    $client -> send($message);
 
}
 
sendNotification($client, "Hello World", "Test Notification", "FCM-CLIENT-TOKEN-1");

$message = new Message();
$message -> setNotification(new Notification("Test", "Test"));
$message -> addReceipient(new Device("FCM-CLIENT-TOKEN-USER-1"));
$message -> addReceipient(new Device("FCM-CLIENT-TOKEN-USER-2"));
 
$response = $client -> send($message);
$responseData = $response -> json();

{
    "success": 1,
    "failure": 1,
    "results": [
        {
            "message_id": 100
        },
        {
            "error": "InvalidRegistration"
        }
    ]
}

$recipients = [
    "FCM-CLIENT-TOKEN-USER-1",
    "FCM-CLIENT-TOKEN-USER-2"
];
 
$message = new Message();
$message -> setNotification(new Notification("Test", "Test"));
 
foreach ($recipients as $recipient) {
    $message -> addReceipient(new Device($recipient));
}
 
$response = $client -> send($message);
$responseData = $response -> json();
 
foreach ($responseData["results"] as $i => $result) {
    if (isset($result["error"])) {
        deleteUserFcmToken($recipients[$i]);
    }
}

$message = new Message();
$message -> setNotification(
    new Notification(
        "Breaking News!",
        "A breaking news story is available."
    )
);
$message -> setData([
    "uri" => "/news/latest-stories"
]);

// Indicate a high-priority message
$message -> setPriority("high");

$message = new Message();
$message -> setNotification(
    new Notification(
        "Server rotation scheduled for 12pm",
        "Cancel within the next 10 minutes."
    )
);
$message -> setTimeToLive(600);

$message = new Message();
$notification = new Notification(
    "Server rotation scheduled for 12pm",
    "Cancel within the next 10 minutes."
);
$notification -> setBadge(1);
$message -> setNotification($notification);
$message -> setTimeToLive(600);