✦ UY TÍN HÀNG ĐẦU Đồng hành cùng 120+ Doanh nghiệp & Hộ kinh doanh · Kỹ sư trực tiếp thực hiện
Sẵn sàng hỗ trợ trực tiếp / Hotline: 0388.810.316 / Zalo Kỹ Sư
Phần Mềm & Ứng Dụng

Hướng Dẫn Tích Hợp Web Push Notification Cho Website PHP Chuẩn VAPID

Hướng Dẫn Tích Hợp Web Push Notification Cho Website PHP Chuẩn VAPID
Hướng dẫn kỹ thuật từng bước tích hợp thông báo đẩy Web Push Notifications cho website PHP thuần hoặc Laravel bằng thư viện Minishlink/web-push, sinh cặp khóa VAPID và tiếp nhận sự kiện qua Service Worker trên Android và iOS 16.4+.

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

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:

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

  1. 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.
  2. 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.
  3. 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.
📢 Chia sẻ bài viết này:
Nguyễn Ngọc Lợi

Nguyễn Ngọc Lợi

Kỹ Sư Giải Pháp Số & Fullstack Developer

Kỹ sư Công nghệ Thông tin (ĐH Cần Thơ), chuyên sâu về kiến trúc hệ thống web, phần mềm quản trị doanh nghiệp may đo (PHP/Laravel/Odoo) và Technical SEO On-page thực chiến.

Xem hồ sơ CV → Chat Zalo tư vấn →

Cần Triển Khai Giải Pháp Tương Tự?

Để lại thông tin, Kỹ sư Ngọc Lợi sẽ tư vấn chiến lược miễn phí 1:1 cho bạn.

📞 💬