Thông báo đẩy trên trình duyệt (Web Push Notification) là công cụ giữ chân khách hàng mạnh mẽ nhất hiện nay với tỷ lệ mở cao gấp 5 đến 7 lần so với Email Marketing truyền thống. Trong bài viết kỹ thuật này, Kỹ sư Nguyễn Ngọc Lợi sẽ hướng dẫn bạn toàn bộ quy trình tích hợp Web Push vào website PHP bằng chuẩn mã hóa VAPID hiện đại.
- 1. Nguyên lý vận hành của chuẩn W3C Web Push & VAPID
- 2. Bước 1: Khởi tạo cặp khóa VAPID bảo mật (Public/Private Key)
- 3. Bước 2: Thu thập PushSubscription phía Client bằng JavaScript
- 4. Bước 3: Lưu trữ Subscription vào cơ sở dữ liệu MySQL
- 5. Bước 4: Viết mã nguồn PHP gửi Push Payload qua Minishlink/web-push
- 6. Bước 5: Tiếp nhận và hiển thị thông báo trên Service Worker
- 7. Những lưu ý để thông báo hiển thị tốt trên iOS Safari và Android
1. Nguyên lý vận hành của chuẩn W3C Web Push & VAPID
Quy trình gửi Web Push không gửi trực tiếp từ máy chủ web tới điện thoại người dùng, mà phải đi qua dịch vụ điều phối trung gian gọi là Push Service (Google FCM cho Chrome, Apple Push Notification service APNs cho Safari, Mozilla Autopush cho Firefox).
Chuẩn VAPID (Voluntary Application Server Identification) sử dụng cặp khóa bất đối xứng (Public Key & Private Key) để máy chủ PHP xác thực danh tính hợp pháp với Push Service mà không cần đăng ký tài khoản rườm rà.
2. Bước 1: Khởi tạo cặp khóa VAPID bảo mật
Bạn có thể sinh cặp khóa VAPID thông qua thư viện PHP minishlink/web-push hoặc dùng dòng lệnh npm:
// Sử dụng Composer cài đặt thư viện PHP chuẩn
composer require minishlink/web-push
// Hoặc sinh cặp khóa VAPID nhanh bằng npx
npx web-push generate-vapid-keys
Kết quả bạn nhận được gồm 2 chuỗi ký tự Base64 URL-safe:
publicKey: Đặt ở phía JavaScript để xin quyền người dùng.privateKey: Lưu bí mật tuyệt đối trên máy chủ PHP, không bao giờ lộ ra Client.
3. Bước 2: Thu thập PushSubscription phía Client
// client-push.js
async function subscribeUserToPush() {
if (!('serviceWorker' in navigator) || !('PushManager' in window)) {
console.warn('Trình duyệt không hỗ trợ Web Push!');
return;
}
const registration = await navigator.serviceWorker.ready;
// Xin quyền người dùng
const permission = await Notification.requestPermission();
if (permission !== 'granted') {
alert('Bạn đã từ chối nhận thông báo.');
return;
}
// Đăng ký nhận push qua PushManager
const subscription = await registration.pushManager.subscribe({
userVisibleOnly: true,
applicationServerKey: 'YOUR_VAPID_PUBLIC_KEY_HERE'
});
// Gửi đối tượng Subscription về máy chủ PHP
await fetch('/api/save-subscription.php', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(subscription)
});
}
4. Bước 3: Lưu trữ Subscription vào MySQL
CREATE TABLE `push_subscriptions` (
`id` INT AUTO_INCREMENT PRIMARY KEY,
`endpoint` TEXT NOT NULL,
`p256dh` VARCHAR(255) NOT NULL,
`auth` VARCHAR(255) NOT NULL,
`user_agent` VARCHAR(255) NULL,
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
5. Bước 4: Viết mã nguồn PHP gửi Push Payload
<?php
require_once __DIR__ . '/vendor/autoload.php';
use Minishlink\WebPush\WebPush;
use Minishlink\WebPush\Subscription;
$auth = [
'VAPID' => [
'subject' => 'mailto:loinguyen120299@gmail.com',
'publicKey' => 'YOUR_VAPID_PUBLIC_KEY',
'privateKey' => 'YOUR_VAPID_PRIVATE_KEY',
],
];
$webPush = new WebPush($auth);
// Lấy danh sách thiết bị từ MySQL
$subscription = Subscription::create([
'endpoint' => $row['endpoint'],
'publicKey' => $row['p256dh'],
'authToken' => $row['auth'],
]);
$payload = json_encode([
'title' => 'Đơn hàng #1024 đã được xác nhận!',
'body' => 'Kỹ sư Ngọc Lợi đang chuẩn bị triển khai hệ thống cho bạn.',
'icon' => '/images/logo-192.png',
'url' => '/tin-tuc/progressive-web-app-pwa'
]);
$report = $webPush->sendOneNotification($subscription, $payload);
if ($report->isSuccess()) {
echo "Gửi thông báo thành công!";
} else {
echo "Lỗi gửi thông báo: " . $report->getReason();
}
6. Bước 5: Tiếp nhận sự kiện trên Service Worker
// sw.js - Service Worker xử lý sự kiện ngầm
self.addEventListener('push', event => {
const data = event.data ? event.data.json() : {};
const title = data.title || 'Thông báo mới từ Ngọc Lợi Digital';
const options = {
body: data.body,
icon: data.icon || '/images/logo-192.png',
badge: '/images/badge-72.png',
data: { url: data.url || '/' }
};
event.waitUntil(self.registration.showNotification(title, options));
});
self.addEventListener('notificationclick', event => {
event.notification.close();
event.waitUntil(
clients.openWindow(event.notification.data.url)
);
});
7. Những lưu ý quan trọng để thông báo hiển thị tốt trên iOS
- Yêu cầu HTTPS tuyệt đối: Trình duyệt sẽ chặn toàn bộ API nếu website không có chứng chỉ bảo mật SSL.
- Chính sách iOS Safari: Trên iPhone, người dùng bắt buộc phải thêm website vào màn hình chính (Add to Home Screen) thì Push Notification mới có thể hoạt động.
- Dọn dẹp Endpoint hết hạn (410 Gone): Khi người dùng gỡ app hoặc hủy quyền, Push Service sẽ trả về mã HTTP 410. Cần xóa ngay bản ghi đó khỏi MySQL để tránh tốn thời gian gửi vô ích.