Si të dërgoni njoftime Push në ueb me PHP

Web Push API ju lejon të dërgoni njoftime shtytëse te shfletuesit dhe API-të e uebit. Ndërsa pjesa më e madhe e logjikës ndodh në shfletues, ju duhet ende një komponent nga ana e serverit për të gjeneruar njoftimet tuaja. Ja se si të implementoni një backend Web Push duke përdorur PHP.

Parakushtet

Për qëllimet e këtij tutoriali, ne do të supozojmë se jeni njohur me bazat e krijimit të API-ve HTTP në PHP. Do t'ju duhet të ekspozoni disa pika përfundimtare publike duke përdorur kornizën tuaj të internetit. Këto do të thirren nga JavaScript në shfletuesin tuaj për të regjistruar dhe çregjistruar pajisjet.

Ky artikull nuk do të prekë kodin e anës së shfletuesit ose mënyrën se si funksionon. Do t'ju duhet të krijoni një punonjës shërbimi që i përgjigjet ngjarjeve të hyrjes dhe i shfaq përdoruesit një njoftim.

Në një nivel të lartë, fluksi i Ueb Push duket si ky:

1. Një abonim push është regjistruar në shfletues. Shfletuesi lëshon një URL unike të pikës fundore në JavaScript.
2. JavaScript juaj dërgon të dhënat e abonimit në serverin tuaj dhe identifikon përdoruesin për të cilin aplikohet.
3. Kur backend-i juaj duhet të dërgojë një njoftim shtytës, krijoni një ngarkesë dhe dërgojeni në URL-në e pikës fundore të raportuar si pjesë e të dhënave të abonimit.
4. Shfletuesi i përdoruesit do të marrë ngarkesën përmes platformës së dërgimit të njoftimeve të shitësit. Punonjësi juaj i shërbimit JavaScript trajton ngjarjen pasuese dhe përdor API-në e njoftimit të shfletuesit për të paralajmëruar përdoruesin.

Ja se si të zbatoni aspektet e serverit të hapave 1 deri në 3.

Po merr konfigurimin

Ne do të përdorim paketën web-push Packagist nga minishlink. Kjo abstrakton ndërveprimet me çdo platformë njoftimi të shfletuesit, kështu që nuk keni nevojë të bëni dallimin manualisht midis llojeve të pikës fundore.

Shtoni paketën në projektin tuaj duke përdorur Composer:

composer require minishlink/web-push

Për të përdorur versionin më të fundit, ju nevojitet PHP 7.2 ose më i ri me gmp, mbstring, curl dhe openssl zgjerimet. Nëse duhet të përdorni një version më të vjetër PHP, kyçeni paketën në një version të mëparshëm për të ruajtur përputhshmërinë.

Biblioteka ekspozon një klasë thelbësore WebPush me metoda që ju lejojnë të dërgoni njoftime individualisht ose si grupe. Abonimet përfaqësohen nga shembuj të klasës Abonim.

Sigurimi i çelësave VAPID

Besimi në ekosistemin Web Push në përputhje me standardet zbatohet nëpërmjet përdorimit të çelësave VAPID. Serveri juaj ka nevojë për një çift çelësash VAPID në mënyrë që të mund të vërtetohet në shfletues. Çelësi publik duhet të ekspozohet nëpërmjet një pike fundore API.

Mund të gjeneroni një grup çelësash VAPID duke përdorur paketën web-push:

use MinishlinkWebPushVAPID;
 
$keyset = VAPID::createVapidKeys();
 
// public key - this needs to be accessible via an API endpoint
echo $keyset["publicKey"];
 
// private key - never expose this!
echo $keyset["privateKey"];
 
file_put_contents("vapid.json", json_encode($keyset));

use MinishlinkWebPushWebPush;
 
$webPush = new WebPush([
    "VAPID" => [
        "subject" => "https://example.com",
        "publicKey" => "VAPID_Public_Key_Here",
        "privateKey" => "VAPID_Private_Key_Here"
    ]
]);

use MinishlinkWebPushSubscription;
 
// Get user's push data...
// SELECT * FROM push_subscriptions WHERE user_id = 123456
 
$subscription = Subscription::create([
    "endpoint" => "https://fcm.google.com/...",
    "contentEncoding" => "aesgcm",
    "authToken" => "<auth token from JavaScript PushSubscription object>"
    "keys" => [
        "auth" => "<auth token from JavaScript PushSubscription object>",
        "p256dh" => "<p256dh token from JavaScript PushSubscription object>"
    ]
]);

$result = $webPush -> sendOneNotification(
    $subscription,
    json_encode([
        "message" => "Demo notification",
        "foo" => "bar"
    ])
);

if ($result -> isSuccess()) {
    // all good
}
else {
 
    // something went wrong
    error_log($result -> getReason());
 
    // provides raw HTTP response data
    error_log($result -> getResponse());
 
}

$webPush -> queueNotification($subscription, ["msg" => "first"]);
$webPush -> queueNotification($subscription, ["msg" => "second"]);
 
foreach ($webPush -> flush() as $i => $result) {
    echo ("Notification $i was " . ($result -> isSuccess() ? "sent" : "not sent"));
}

$webPush -> flush(100);     // send 100 messages

$webPush = new WebPush(["VAPID" => [...]], ["TTL" => 3600]);