PHPackages                             vergil-lai/wecom-aibot-php-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. [HTTP & Networking](/categories/http)
4. /
5. vergil-lai/wecom-aibot-php-sdk

ActiveLibrary[HTTP & Networking](/categories/http)

vergil-lai/wecom-aibot-php-sdk
==============================

企业微信智能机器人 PHP SDK - 基于 ReactPHP WebSocket 长连接

v1.0.7(3w ago)216↓50%MITPHPPHP >=8.1

Since Apr 10Pushed 3w agoCompare

[ Source](https://github.com/vergil-lai/wecom-aibot-php-sdk)[ Packagist](https://packagist.org/packages/vergil-lai/wecom-aibot-php-sdk)[ RSS](/packages/vergil-lai-wecom-aibot-php-sdk/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (5)Dependencies (9)Versions (9)Used By (0)

wecom-aibot-php-sdk
===================

[](#wecom-aibot-php-sdk)

[企业微信智能机器人](https://developer.work.weixin.qq.com/document/path/101463) PHP SDK —— 基于 ReactPHP WebSocket 长连接通道，提供消息收发、流式回复、模板卡片、事件回调、文件下载解密、媒体素材上传等核心能力。

本 SDK 从官方 [Node.js SDK](https://github.com/WecomTeam/aibot-node-sdk) 移植而来，API 设计保持一致。

特性
--

[](#特性)

- **WebSocket 长连接** — 基于 `wss://openws.work.weixin.qq.com` 内置默认地址，开箱即用
- **自动认证** — 连接建立后自动发送认证帧（botId + secret）
- **心跳保活** — 自动维护心跳，连续未收到 ack 时自动判定连接异常
- **断线重连** — 指数退避重连策略（1s -> 2s -> 4s -> ... -> 30s 上限），支持自定义最大重连次数
- **消息分发** — 自动解析消息类型并触发对应事件（text / image / mixed / voice / file / video）
- **流式回复** — 内置流式回复方法，支持 Markdown 和图文混排
- **模板卡片** — 支持回复模板卡片消息、流式+卡片组合回复、更新卡片
- **主动推送** — 支持向指定会话主动发送 Markdown、模板卡片或媒体消息，无需依赖回调帧
- **事件回调** — 支持进入会话、模板卡片按钮点击、用户反馈等事件
- **串行回复队列** — 同一 req\_id 的回复消息串行发送，自动等待回执
- **文件下载解密** — 内置 AES-256-CBC 文件解密，每个图片/文件消息自带独立的 aeskey
- **媒体素材上传** — 支持分片上传临时素材（file/image/voice/video），自动管理并发与重试
- **可插拔日志** — 支持自定义 Logger，内置带时间戳的 DefaultLogger
- **异步非阻塞** — 基于 ReactPHP 事件循环，单线程高并发

安装
--

[](#安装)

```
composer require vergil-lai/wecom-aibot-php-sdk
```

### 系统要求

[](#系统要求)

- PHP >= 8.1
- ext-openssl

快速开始
----

[](#快速开始)

```