PHPackages                             xfstudio/yii2-wechat - 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. xfstudio/yii2-wechat

ActiveYii2-extension[API Development](/categories/api)

xfstudio/yii2-wechat
====================

The wechat api for the Yii2 framework

2143

Since Jan 20Compare

[ Source](https://github.com/xfstudio/yii2-wechat)[ Packagist](https://packagist.org/packages/xfstudio/yii2-wechat)[ RSS](/packages/xfstudio-yii2-wechat/feed)WikiDiscussions Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

yii2-wechat-sdk
===============

[](#yii2-wechat-sdk)

感谢选择 yii2-wechat-sdk 扩展, 该扩展是基于[Yii2](https://github.com/yiisoft/yii2)框架基础开发,借助Yii2的强劲特性可以定制开发属于您自己的微信公众号

[![Latest Stable Version](https://camo.githubusercontent.com/d01b6f820134f8ac9acb09bb215f1ed4bdf9c43c0fcff9f6141006172284d919/68747470733a2f2f706f7365722e707567782e6f72672f786673747564696f2f796969322d7765636861742f762f737461626c652e737667)](https://packagist.org/packages/xfstudio/yii2-wechat) [![Total Downloads](https://camo.githubusercontent.com/060d0ad0a12f66ce1f3689287f9f9eb75419ba6a05f7ce506c16dccc71d31ab6/68747470733a2f2f706f7365722e707567782e6f72672f786673747564696f2f796969322d7765636861742f646f776e6c6f6164732e737667)](https://packagist.org/packages/xfstudio/yii2-wechat) [![Latest Unstable Version](https://camo.githubusercontent.com/06414cff078bfafdcb8317f93bc46e769334d46a3ed31e12d8724d529ff77f6a/68747470733a2f2f706f7365722e707567782e6f72672f786673747564696f2f796969322d7765636861742f762f756e737461626c652e737667)](https://packagist.org/packages/xfstudio/yii2-wechat) [![License](https://camo.githubusercontent.com/e8b2020418053cf416983bdc2daed31d9bc6eed73406239def3fb063bc49e313/68747470733a2f2f706f7365722e707567782e6f72672f786673747564696f2f796969322d7765636861742f6c6963656e73652e737667)](https://packagist.org/packages/xfstudio/yii2-wechat)

注意
--

[](#注意)

\*\* 新版本正在重构中, 直到1.0正式版发布前.你依然可以继续使用功能 \*\*

目前有3个主要文件可以使用

- `Wechat.php` 旧版微信公众号操作类(在新版\[1.0\]发布后会删除)
- `MpWechat.php` 新版微信公众号操作类(更标准,更完善), 如果您是新使用该库请按照文档说明替换旧版`Wechat.php`使用
- `QyWechat.php` 新版微信企业号操作类(为了更加全面的微信功能操作, 将在\[1.1版本中完善发布\]), 强势集成企业号功能

环境条件
----

[](#环境条件)

- > = php5.4
- Yii2

安装
--

[](#安装)

您可以使用composer来安装, 添加下列代码在您的`composer.json`文件中并执行`composer update`操作

```
{
    "require": {
       "xfstudio/yii2-wechat": "dev-master"
    }
}
```

使用示例
----

[](#使用示例)

在使用前,请先参考微信公众平台的[开发文档](http://mp.weixin.qq.com/wiki/index.php?title=%E9%A6%96%E9%A1%B5)

Wechat定义方式

```
//在config/web.php配置文件中定义component配置信息
'components' => [
  .....
  'wechat' => [
    'class' => 'xfstudio\wechat\Wechat',
    'appId' => '微信公众平台中的appid',
    'appSecret' => '微信公众平台中的secret',
    'token' => '微信服务器对接您的服务器验证token'
  ]
  ....
]
// 全局公众号sdk使用
$wechat = Yii::$app->wechat;

//多公众号使用方式
$wechat = Yii::createObject([
    'class' => 'xfstudio\wechat\Wechat',
    'appId' => '微信公众平台中的appid',
    'appSecret' => '微信公众平台中的secret',
    'token' => '微信服务器对接您的服务器验证token'
]);
```

Wechat方法使用(部分示例)

```
//获取access_token
var_dump($wechat->accessToken);

//获取二维码ticket
$qrcode = $wechat->createQrCode(123);
var_dump($qrcode);

//获取二维码
$imgRawData = $wechat->getQrCodeUrl($qrcode['ticket']);

//获取群组列表
var_dump($wechat->getGroups());

//创建分组
$group = $wechat->createGroup('测试分组');
echo $group ? '测试分组创建成功' : '测试分组创建失败';

//修改分组
echo $wechat->updateGroupName($group['id'], '修改测试分组') ? '修改测试分组成功' : '测试分组创建失败';

//根据关注者ID获取关注者所在分组ID
$openID = 'oiNHQjh-8k4DrQgY5H7xofx_ayfQ'; //此处应填写公众号关注者的唯一openId

//修改关注者所在分组
echo $wechat->updateMemberGroup($openID, 1) ? '修改关注者分组成功' : '修改关注者分组失败';

//获取关注者所在分组
echo $wechat->getGroupId($openID);

//修改关注者备注
echo $wechat->updateMemberRemark($openID, '测试更改备注') ? '关注者备注修改成功' : '关注者备注修改失败';

//获取关注者基本信息
var_dump($wechat->getMemberInfo($openID));

//获取关注者列表
var_dump($wechat->getMemberList());

//获取关注者的客服聊天记录,
var_dump($wechat->getCustomerServiceRecords($openID, mktime(0, 0, 0, 1, 1, date('Y')), time())); //获取今年的聊天数据(可能获取不到数据)

//上传媒体文件
$filePath = '图片绝对路径'; //目前微信只开发jpg上传
var_dump($media = $wechat->uploadMedia(realpath($filePath), 'image'));

//下载媒体文件
echo $wechat->getMedia($media['media_id']) ? 'media下载成功' : 'media下载失败';
```

反馈或贡献代码
-------

[](#反馈或贡献代码)

您可以在[这里](https://github.com/xfstudio/yii2-wechat/issues)给我提出在使用中碰到的问题或Bug. 我会在第一时间回复您并修复.

您也可以 发送邮件给我并且说明您的问题.

如果你有更好代码实现,请fork项目并发起您的pull request.我会及时处理. 感谢!

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity43

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/577552a93d0b40f2ff30f7b3fd2be53c1bcbbd109da4754bc4cc7d2c84d39c19?d=identicon)[xfstudio](/maintainers/xfstudio)

---

Top Contributors

[![xfstudio](https://avatars.githubusercontent.com/u/2246799?v=4)](https://github.com/xfstudio "xfstudio (5 commits)")

### Embed Badge

![Health badge](/badges/xfstudio-yii2-wechat/health.svg)

```
[![Health](https://phpackages.com/badges/xfstudio-yii2-wechat/health.svg)](https://phpackages.com/packages/xfstudio-yii2-wechat)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

94452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

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