包简介

Yii2 frameworki uchun Firebase Cloud Messaging orqali push xabar yuborish va veb saytda qabul qilish uchun kengaytma.

README 文档

README

Yii2 frameworki uchun Firebase Cloud Messaging orqali push xabar yuborish va veb saytda qabul qilish uchun kengaytma.

Eslatma: Ushbu kengaytma, Cloud Messaging API (Legacy) dan foydalanadi.

Avvalam bor firebase saytidan ro'yhatdan o'tishingiz va loyiha yaratishingiz lozim. So'ng, yangi loyihangizning sozlamalaridan "Cloud Messaging" bo'limiga kirib, Cloud Messaging API (Legacy) ni faollashtirish kerak bo'ladi.

Faollashtirganingizdan so'ng Server key beriladi. Ushbu Keyni keyinroq config/web.php fayliga yozish kerak bo'ladi.

O'rnatish

composer require uzdevid/yii2-fcm

yoki

php composer.phar require uzdevid/yii2-fcm

yoki composer.json fayliga ushbu qatorni qo'shing

"uzdevid/yii2-fcm": "*"

Sozlash

config/web.php

return [
    // ...
    'components' => [
        // ...
        'notifier' => [
            'class' => 'uzdevid\fcm\Notifier',
            'serverKey' => '{serverKey}', // Cloud Messaging API (Legacy) ni faollashtirganingizdan so'ng, "Server key" beriladi.
        ],
        // ...
    ],
    // ...
]

Push habar yuborish

$token = "frYfozsx0K7e..."; // Push habar qabul qiluvchi qurilmaning tokeni
$notification = [
    'title' => 'Salom, dunyo!',
    'body' => 'Bu birinchi push habarim',
    'data' => [
        // qo'shimcha ma'lumotlar
    ]
];

$params = [
    // qo'shimcha parametrlar (majburiy emas)
];

Yii::app()->notifier->notify($token, $notification, $params);

Eslatma: Push habar qabul qiluvchi qurilmaning tokenini mijoz (veb, mobil, ...) ilovalari serverga yuborishi kerak bo'ladi.

Eslatma: Yuqorida foydalanilgan notify() metodida xatolik yuz bersa Exception va BadRequestHttpException istisnolarini larni qaytarishi mumkin.

Shular bilan server tomonidan qilinadigan ishlar tugadi.

Veb saytda push habar qabul qilish

Eslatma: Push habarlarni qabul qilish va uni ustida qandaydir amal bajarish faqat mijoz tarafida amalga oshiriladi. Hozirgi holatda mijoz bu veb sayt.

Eslatma: Push habarlar foydalanuvchiga ko'rsatilishi uchun Operatsion tizim (Windows, Android, ...) brauzerga ruxsat bergan bo'lishi va brauzer ham veb saytga ruxsat bergan bo'lishi hamda veb sayt https holatida ishlashi shart.

Firebase loyihangizning bosh sahifasida veb ilova yaratishingiz lozim. Ilova yaratilganidan so'ng, Sizga mijoz tarafni sozlash uchun kerakli ma'lumotlar beriladi.

1. Sozlash

Yuqorida berilgan ma'lumotlarni config/params.php fayliga yozishingiz kerak.

return [
    // ...
    'fcm' => [
        'apiKey' => '{apiKey}',
        'authDomain' => '{authDomain}',
        'databaseURL' => '{databaseURL}',
        'projectId' => '{projectId}',
        'storageBucket' => '{storageBucket}',
        'messagingSenderId' => '{messagingSenderId}',
        'appId' => '{appId}',
        'measurementId' => '{measurementId}',
        'vapidKey' => '{vapidKey}',
    ],
    // ...
];

yoki <head> tegi ichiga quyidagi konstantani yozishingiz kerak.

const firebaseConfig = {
    apiKey: "{apiKey}",
    authDomain: "{authDomain}",
    databaseURL: "{databaseURL}",
    projectId: "{projectId}",
    storageBucket: "{storageBucket}",
    messagingSenderId: "{messagingSenderId}",
    appId: "{appId}",
    measurementId: "{measurementId}",
    vapidKey: "{vapidKey}"
};

Eslatma: vapidKey parametrini olish uchun Web Push Certificate yaratishingiz kerak bo'ladi. Web Push Certificates (Project settings/Cloud Messaging/Web configuration) bo'limida yaratib olishingiz mumkin.

2. Fayllarni ulash

layouts/main.php - faylingizga (yoki boshqa umumiy layout fayliga) ushbu qatorni qo'shing. Ushbu qator sahifaga kerakli bo'lgan js fayllarini ulaydi.

\uzdevid\fcm\FcmAsset::register($this);

3. Qurilma tokenini qabul qilish va serverga yuborish

<head> tegi ichiga quyidagi javascript funksiyani yarating va serverga yuborish uchun kodni yozing. Ushbu funksiya qurilma tokeni qabul qilinganda kengaytma tomonidan ishga tushuriladi

function saveToken(token) {
    // serverga yuborish uchun kodni yozing
}

4. Push habarni sahifada qabul qilish

<head> tegi ichiga quyidagi javascript kodni yozing. Ushbu funksiya yangi push habar kelganida kengaytma tomonidan ishga tushuriladi. payload - serverdan yuborilgan ma'lumotlar

function onNotify(payload) {
    // habarni foydalanuvchiga ko'rsatish, yoki boshqa amallarni bajarish uchun kodni yozing
}

onNotify() funksiyasi foydalanuvchi veb sahifada faol bo'lgan vaqti kelgan push habarni ko'rsatish uchun kerak bo'ladi.

5. Brauzer faol bo'lmagan vaqti push habarlarni qabul qilish

web papkasi ichiga firebase-messaging-sw.js faylini yarating va quyidagi kodni yozing.

web/firebase-messaging-sw.js

importScripts("https://www.gstatic.com/firebasejs/9.1.3/firebase-app-compat.js");
importScripts("https://www.gstatic.com/firebasejs/9.1.3/firebase-messaging-compat.js");

firebase.initializeApp({
    apiKey: "{apiKey}",
    authDomain: "{authDomain}",
    projectId: "{projectId}",
    storageBucket: "{storageBucket}",
    messagingSenderId: "{messagingSenderId}",
    appId: "{appId}",
    measurementId: "{measurementId}",
    vapidKey: "{vapidKey}"
});

const messaging = firebase.messaging();

Ushbu kod faylni brauzeringiz Service worker sifatida faollashtiradi. Tekshirib ko'rishingiz uchun ctrl+shift+i tugmalarini bosing va Application/Service workers bo'limiga o'ting.

6. Tekshirish

Barchasini sozlab bo'lganingizdan so'ng, server yoki curl, postman yoki boshqa yo'llar orqali push habar yuborib tekshirib ko'rishingiz mumkin.

curl --location 'https://fcm.googleapis.com/fcm/send' \
--header 'Authorization: key={serverKey}' \
--header 'Content-Type: application/json' \
--data '{
    "to": "{token}",
    "notification": {
        "title": "test",
        "body": "test",
        "data": {}
    }
}'

Taklif va shikoyatlar uchun: https://devid.uz
Moddiy taraflama qo'llab quvvatlash uchun: https://payme.uz/@uzdevid

uzdevid/yii2-fcm 适用场景与选型建议

uzdevid/yii2-fcm 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 160 次下载、GitHub Stars 达 4，最近一次更新时间为 2023 年 04 月 20 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「extension」「push notifications」「yii2」「firebase」「FCM」「cloud messaging」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 uzdevid/yii2-fcm 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 uzdevid/yii2-fcm 我们能提供哪些服务？

定制开发 / 二次开发

基于 uzdevid/yii2-fcm 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 uzdevid/yii2-fcm 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

coreproc/nova-notification-feed 99

A Laravel Nova package that adds a notification feed in your Nova app.

geertw/yii2-translatable-url-rule 14

A custom URL rule class for Yii 2 which allows to create translated URL rules

slavkovrn/yii2-imagecarousel 5

The Yii2 extension uses jQuery jquery.carousel-1.1.min.js and makes image carousel from php array of structure defined.

t3brightside/gallerycontent 0

TYPO3 CMS extension to create gallery content element with preset crop ratios and pagination

egorov/yii2-uikit 0

UI Kit 3 Extension for Yii2

litalino/flarum-more-bbcode 2

Adds more BBCode

uzdevid/yii2-fcm

包简介

关键字：