PHPackages                             maxsky/xg-push - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. maxsky/xg-push

AbandonedArchivedLibrary[API Development](/categories/api)

maxsky/xg-push
==============

Tencent XinGe Push Service.

v2.0.1(6y ago)34.0k↓37.5%Apache-2.0PHP

Since Oct 15Pushed 6y ago1 watchersCompare

[ Source](https://github.com/maxsky/XinGe-Push)[ Packagist](https://packagist.org/packages/maxsky/xg-push)[ RSS](/packages/maxsky-xg-push/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)DependenciesVersions (6)Used By (0)

xinge-api-php
=============

[](#xinge-api-php)

[![](https://camo.githubusercontent.com/ac8f294a80f65338db545230f1a881b9a382204a1f187c6ff40ee679d42d40ca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c696e6b2d3939362e6963752d7265642e737667)](https://996.icu)

Composer 安装：`composer require maxsky/xg-push`

概述
--

[](#概述)

[信鸽](http://xg.qq.com) 是腾讯云提供的一款支持**百亿级**消息的移动 App 推送平台，开发者可以调用 PHP SDK 访问信鸽推送服务。

官方客户端、服务端 SDK
-------------

[](#官方客户端服务端-sdk)

[信鸽官网](http://xg.qq.com/xg/ctr_index/download)

使用指南
----

[](#使用指南)

大幅修改了官方提供 PHP SDK，使其更友好。

### 初始化

[](#初始化)

```
use Tencent\XinGe\XingePush;

$xinge = XingePush::Init($AppID, $AppSecret);
```

### 简易推送

[](#简易推送)

我在每个方法的注释中贴上了该方法属于简易推送、基本（普通）推送、高级推送的标签。

例如：

```
use Tencent\XinGe\Message\AndroidMsg;
use Tencent\XinGe\Message\iOSMsg;

// Android 简易推送(通知)
$xinge->PushTokenAndroid($deviceToken, '推送标题', '推送内容');
// iOS 简易推送(通知)，正式环境将 iOSMsg::IOSENV_DEV 修改为 iOSMsg::IOSENV_PROD
// 注意 iOS 和 Android 的 AppID、AppSecret 并不相同，这种情况下需要使用 Init() 方法设置
XingePush::Init($iOSAppID, $iOSAppSecret)->PushTokenIos($deviceToken, '推送标题', '推送内容', iOSMsg::IOSENV_DEV);

/** 透传（后台）消息只需将 $messageType 设置为 'message' 即可 */
XingePush::Init($AndroidAppID, $AndroidAppSecret)->PushTokenAndroid($deviceToken, '推送标题', '推送内容', AndroidMsg::TYPE_MESSAGE);
XingePush::Init($iOSAppID, $iOSAppSecret)->PushTokenIos($deviceToken, '推送标题', '推送内容', iOSMsg::IOSENV_DEV, iOSMsg::TYPE_REMOTE_MESSAGE);
```

### 普通推送

[](#普通推送)

普通推送是指在简易推送的基础上多了 **点击通知行为**（Android）和 **自定义数据**（Android & iOS）

```
use Tencent\XinGe\Component\ClickAction;
use Tencent\XinGe\Message\AndroidMsg;

// ClickAction 数组中，第一个元素为操作类型，第二个为相关数据
// 仅打开 URL 时存在第三个元素，表示打开 URL 是否提示
XingePush::Init($AndroidAppID, $AndroidAppSecret)
  	->PushAccountAndroid('推送帐号', '推送标题', '推送内容', ['自定义键' => '自定义值'],
                        [ClickAction::TYPE_URL, 'https://m.baidu.com', 1],
                        AndroidMsg::TYPE_NOTIFICATION);
```

### 高级推送

[](#高级推送)

高级推送指完全自定义，存在的方法有如下 6 个：

- PushSingleDevice - 推送给单个设备
- PushSingleAccount - 推送给单个帐号
- PushTokenList - 推送给指定设备列表
- PushAccountList - 推送给帐号列表
- PushAllDevices - 推送给所有 Android/iOS 设备
- PushTags - 推送给指定标签设备

其中所有方法均含有 `$message` 参数，该参数类型为 `AndroidMsg|iOSMsg`，即 Android 或 iOS 的消息体

使用方法如下：（以下为 **Android** 示例，**iOS** 同理但更简单，无需设置 `Style` 及`ClickAction`）

```
use Tencent\XinGe\Component\Style;
use Tencent\XinGe\Message\AndroidMsg;
use Tencent\XinGe\XingePush;

// 实例化 Android 消息类
$message = new AndroidMsg();
// 设置标题、内容
$message->setTitle('我是标题');
$message->setContent('我是一个内容');
// 设置消息类型
$message->setMessageType(AndroidMsg::TYPE_NOTIFICATION);
// 实例化 Style 类
$style = new Style();
// 指定应用通知中 Icon 类型。默认 0 为应用本身图标，1 为指定图标资源
// IconType 为 1 时必需设置 IconRes
$style->setIconType(1);
$style->setIconRes('https://www.maxsky.cc/images/avatar.jpg');
// 实例化 ClickAction 类
$action = new ClickAction();
// 设置操作类型，打开 URL
$action->setActionType(ClickAction::TYPE_URL);
// 设置类型相关数据，此处为 URL 地址
$action->setUrl('https://m.baidu.com');
// 设置打开 URL 是否提示确认
$action->setConfirmOnUrl(0);
// 合并进消息类
$message->setAction($action);
$message->setStyle($style);
// 设置自定义数据
$message->setCustomData(['key' => 'value']);
// 设置富媒体资源地址（目前仅 Android，且只能设置 1 条数据）
// 设置后下拉戳开通知栏可以看到该资源
$message->setMediaResources('https://www.maxsky.cc/images/avatar.jpg');
// 设置完成后放进去就可以推送测试了
XingePush::Init($AppID, $AppSecret)->PushSingleAccount('maxsky', $message);
```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~61 days

Total

5

Last Release

2526d ago

Major Versions

v1.2.2 → v2.0.02019-04-17

### Community

Maintainers

![](https://www.gravatar.com/avatar/2f8f4aa99ca479f6fb6b162b4b56ce4e8e8e96518c828949a69b2db37ae4ecb0?d=identicon)[maxsky](/maintainers/maxsky)

---

Top Contributors

[![maxsky](https://avatars.githubusercontent.com/u/7405522?v=4)](https://github.com/maxsky "maxsky (16 commits)")

### Embed Badge

![Health badge](/badges/maxsky-xg-push/health.svg)

```
[![Health](https://phpackages.com/badges/maxsky-xg-push/health.svg)](https://phpackages.com/packages/maxsky-xg-push)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)