PHPackages                             suxianjia/xianjia\_getui\_sdk - 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. suxianjia/xianjia\_getui\_sdk

ActiveLibrary[API Development](/categories/api)

suxianjia/xianjia\_getui\_sdk
=============================

xianjia\_getui\_sdk\_code 是一个为个推（Getui）推送服务封装的 PHP SDK 项目，目标是提供一套基于 REST API 的服务端推送功能，方便开发者集成个推的消息推送能力，如单播、批量推送、别名管理、标签绑定等功能。https://docs.getui.com/getui/server/rest\_v2/service\_sdk/ 有 PHP 版本吗? 确认了，没有呢，那就自己写一个吧！

v1.0.8(9mo ago)02MITPHPPHP ^8.0|&gt;=8.3.3

Since Jul 24Pushed 9mo agoCompare

[ Source](https://github.com/suxianjia/xianjia_getui_sdk)[ Packagist](https://packagist.org/packages/suxianjia/xianjia_getui_sdk)[ RSS](/packages/suxianjia-xianjia-getui-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (7)Used By (0)

xianjia\_getui\_sdk
===================

[](#xianjia_getui_sdk)

xianjia\_getui\_sdk\_code 是一个为 个推（Getui）推送服务 封装的 PHP SDK 和示例代码项目。它的主要目的是简化开发者将个推的消息推送能力集成到 PHP 后端服务中的流程，提供了一系列针对个推 REST API 的 PHP 封装方法，包括： 单播/批量 CID 或别名推送 绑定/解绑别名（alias） 绑定自定义标签 查询设备状态、用户别名、CID 等 黑名单管理 推送结果状态追踪

```
composer require suxianjia/xianjia_getui_sdk

```

xianjia\_getui\_sdk
===================

[](#xianjia_getui_sdk-1)

```
项目用途

方面	说明
🧩 是什么？	一个封装了 个推（Getui）官方 REST API 的 PHP SDK，以及配套的调用示例
🎯 用来做什么？	帮助 PHP 开发者快速实现：消息推送、用户标签/别名管理、设备状态查询、黑名单等后台功能，无需直接调用复杂的个推 HTTP API
📦 提供了什么？	一系列封装好的 PHP 方法，如 push、bind_alias、find_cid、delete_alias 等
🧪 如何测试？	通过运行 demo/ 下的各个 PHP 文件，例如 find_alias.php、push_single_cid.php，可快速体验各项功能
⚙️ 依赖什么？	PHP 8.0+，以及通过 Composer 安装的 predis/predis（用于可选的 Redis 缓存）
✅ 总结一句话

xianjia_getui_sdk_code 是一个专为 PHP 开发者打造的个推（Getui）推送服务 SDK，封装了消息推送、别名管理、用户状态查询等功能，并通过丰富的 demo 示例展示如何使用，目标是让 PHP 后端快速、轻松地接入个推服务。

xianjia_getui_sdk_code 是一个为个推（Getui）推送服务封装的 PHP SDK 项目，目标是提供一套基于 REST API 的服务端推送功能，方便开发者集成个推的消息推送能力，如单播、批量推送、别名管理、标签绑定等功能。

xianjia_getui_sdk_code 是一个为 个推（Getui）推送服务 封装的 PHP SDK 和示例代码项目。它的主要目的是简化开发者将个推的消息推送能力集成到 PHP 后端服务中的流程，提供了一系列针对个推 REST API 的 PHP 封装方法，包括：

单播/批量 CID 或别名推送
绑定/解绑别名（alias）
绑定自定义标签
查询设备状态、用户别名、CID 等
黑名单管理
推送结果状态追踪

src/ 存放源代码文件
vendor/ 存放第三方依赖
composer.json 定义项目的元数据和依赖信息
README.md 项目的说明文档

|
|-- Core/
|    |-- HttpClient.php：负责发送 HTTP 请求到个推服务器，处理鉴权头、请求构造、响应解析及异常捕获。错误如 “target user is invalid” 就是在这里被捕获并转换为异常的。
|    |-- Cache.php：缓存管理类，支持 file / redis / session 等多种存储方式，默认使用文件缓存，也集成了 predis/predis 作为 Redis 客户端（但当前使用较少）。
|-- src/    包源码
|    |-- orm/ 数据库操作层
|    |-- sitemap/ 业务处理
|    |-- fun.php	公共方法
|    |-- SDK.php核心类，封装了所有对接个推 REST API 的主要方法，例如：
|            推送功能（单播 / 批量 CID / 别名推送）
|            别名管理（绑定、查询、删除等）
|            用户状态查询、黑名单、标签绑定
|            HTTP 请求与鉴权逻辑
|    |-- myApp.php 对 SDK 的进一步封装，提供更易用的接口（如 push_single_alias()、find_alias() 等），便于在项目中直接调用，属于对 SDK 的 “应用层包装”。
|-- example  一些实例
|
|-- example_bin  一些实例
|--  |-- test.php 入口
|
|-- README.md
|
|-- composer.json
|-- demo/

# 架构文档

## 项目结构

- **核心模块**
  - `src/SDK.php`: 主入口类
  - `src/Core/HttpClient.php`: HTTP客户端实现
  - `src/Core/Cache.php`: 缓存功能实现

- **配置模块**
  - `src/myConfig.php`: 配置管理类

- **应用模块**
  - `src/myApp.php`: 应用逻辑类

## 类关系图

```mermaid
classDiagram
    class SDK {
        +__construct()
        +run()
    }

    class HttpClient {
        +request()
    }

    class Cache {
        +get()
        +set()
    }

    class myConfig {
        +load()
    }

    class myApp {
        +execute()
    }

    SDK --> HttpClient
    SDK --> Cache
    SDK --> myConfig
    myApp --> SDK

```

功能描述
----

[](#功能描述)

1. **SDK**: 提供主入口功能，协调其他模块的工作。
2. **HttpClient**: 处理HTTP请求，支持与外部服务的通信。
3. **Cache**: 提供数据缓存功能，提升性能。
4. **myConfig**: 管理应用配置，支持动态加载。
5. **myApp**: 封装业务逻辑，调用SDK完成功能。

依赖关系
----

[](#依赖关系)

- 项目依赖通过 `composer.json` 管理。
- 核心模块依赖于 `src/Core` 目录下的实现。

核心价值：提供各种常见使用场景的调用范例，可直接运行测试

该目录下包含多个 PHP 脚本，展示如何使用 SDK 提供的接口，例如：

文件 功能说明 push\_single\_cid.php 向单个 CID 推送消息 push\_single\_alias.php 向单个别名推送消息 push\_single\_batch\_cid.php / push\_single\_batch\_alias.php 批量向多个 CID / 别名推送 find\_alias.php 通过别名或 CID 查询用户信息 bind\_alias.php 绑定 CID 和 别名 delete\_batch\_alias.php / delete\_all\_alias.php 批量或全部删除别名绑定 find\_cid.php 查询 CID 相关信息 bind\_custom\_tag.php 绑定自定义标签 set\_badge.php 设置应用角标数字（iOS） add\_blacklist.php / delete\_blacklist.php 用户黑名单管理 ✅ 每个示例都包含： 引入 autoload 初始化配置（通过 myConfig 或直接调用） 调用 myApp 的方法（如 push\_single\_cid()、find\_alias()） 打印返回的 JSON 结果 项目结构

src/: 存放源代码文件，包括核心功能、服务、客户端、配置、驱动、工厂、接口、ORM、服务器和站点地图等模块。 demo/: 包含一些示例文件和配置文件，用于演示如何使用该项目。 examples/: 可能包含更多的示例代码。 tests/: 测试文件目录。 vendor/: 第三方依赖库。

git filter-repo --path-glob '\*.so' --invert-paths --force git push origin --force --all

rm composer.lock composer install --ignore-platform-reqs # 临时忽略环境检查

rm composer.lock php82 composer82.phar install --ignore-platform-reqs

composer update --dry-run

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance56

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 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 ~0 days

Total

6

Last Release

293d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b0cb0235817f73a2d8904656e08b066263abbf368b158bc241bbb5fff244ee5a?d=identicon)[su0012004](/maintainers/su0012004)

---

Top Contributors

[![suxianjia](https://avatars.githubusercontent.com/u/51219621?v=4)](https://github.com/suxianjia "suxianjia (1 commits)")

### Embed Badge

![Health badge](/badges/suxianjia-xianjia-getui-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/suxianjia-xianjia-getui-sdk/health.svg)](https://phpackages.com/packages/suxianjia-xianjia-getui-sdk)
```

###  Alternatives

[badaso/core

The API &amp; platform builder, build your apps 10x faster even more, it's open source &amp; 100% free !

1.3k16.2k10](/packages/badaso-core)[stfalcon-studio/api-bundle

Base classes and helper services to build API application via Symfony.

1032.1k](/packages/stfalcon-studio-api-bundle)[d-scribe/laraquick

A collection of classes to be extended/used in laravel applications for quick development

371.8k1](/packages/d-scribe-laraquick)[koot-labs/telegram-bot-dialogs

Telegram Bot API PHP SDK extension that allows to implement dialogs in bots

142.0k](/packages/koot-labs-telegram-bot-dialogs)

PHPackages © 2026

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