Download the PHP package yuanshe/wechat-sdk without Composer

足够简洁的微信公众平台接口封装，只需要简单的配置即可轻松使用公众平台接口

PS: 使用此工具前需要对微信公众平台对接流程有一定了解，或结合微信官方文档使用

特点

• 清晰简单的结构，容易上手，开发者还可以很轻松地扩展
• 高度集成的封装，开发者不需要关心太多细节
• 编码遵守PSR规范，没有混乱的代码
• 完善的注释，符合PHPDoc标准，对IDE非常友好
• 良好的兼容性，可在任意框架和任意环境上使用

运行环境

• PHP 7.0+
• OpenSSL扩展
• SimpleXML扩展
• libxml扩展
• Composer

PHP7已全面流行，PHP官方也不再提供PHP5的支持，因此项目不会考虑PHP7以下版本的兼容

安装

基本示例

example目录下是常见使用示例，使用方式可参考 example说明

开始

Tips: 项目主命名空间为Yuanshe\WeChatSDK，说明中出现的类名称均省略命名空间

初始化

使用任何功能前，要实例化一个WeChat对象，所有功能都是通过这个对象调用

• config array类型。公众平台配置，配置项参考 配置
• cacheClass string类型。缓存类类名。由于使用微信公众平台接口时，需要对access token等数据进行缓存。开发者需要编写一个实现CacheInterface接口的类，并将完整类名传入到该参数中，以供内部调用。参考 缓存类

配置

配置参数以键值对数组的形式传入，以下为配置项列表:

缓存类

为尽可能避免出现重复的代码和不必要的依赖，项目中仅定义了缓存接口，并交由开发者自行实现。开发者需要编写一个实现CacheInterface接口的类，可参考example/Cache (该文件仅供参考，实际开发时应尽量利用项目、框架中现有的缓存功能)

需要实现的方法:

• __construct(string $prefix = '') 构造函数
  • prefix 缓存前缀。传入的值为config中的cache_prefix配置项，在实现缓存功能时请务必使用该前缀，确保缓存的唯一性，防止与项目中其它缓存重名
    
    
• get(string $name) 获取一条缓存数据
  • name 缓存名称
  • @return 返回缓存数据，若缓存不存在或已过期则返回null
    
    
• put(string $name, $value, int $seconds): bool 写入一条缓存
  • name 缓存名称
  • value 缓存内容
  • seconds 有效时长（秒）
  • @return 成功返回true，失败返回false
    
    
• del(string $name): bool 删除一条缓存
  • name 缓存名称
  • @return 成功返回true，失败返回false

接口调用

基本用法

接口以Model Class的形式封装，可以通过以下方式调用:

对于IDE使用者，更推荐以属性的形式调用，因为IDE可以自动提示和补全。但无论使用哪种调用方式，都应区分大小写

Demo

获取关注用户列表:

获取公众号菜单内容:

Throws

如果公众平台接口返回错误码，程序会抛出ModelException异常，可以通过getCode和getMessage方法获取错误码和错误消息，getModel方法可以获取到Model名称

Model列表

• Core 核心公共接口
• Menu 自定义菜单
• Material 素材管理
• Comment 图文消息留言管理
• User 用户管理
• Tag 用户标签管理
• Template 模板消息
• OAuth 微信网页OAuth2.0授权
• CustomService 客服系统
• MassMessage 群发消息

更多接口正在完善中...

消息通知

用于接收公众号的事件推送以及用户消息，并可以自动回复用户

验证通知来源

为确保进一步安全，可验证消息来源IP是否在微信服务器列表中。此步骤非必须

• notifyIP 消息通知来源IP(即请求的客户端IP),通常为$_SERVER['REMOTE_ADDR']
• @return 验证通过返回true，不通过返回false

接收消息

• queries array类型。请求URL的query部分，以数组键值对的形式传入。通常传入$_GET即可
• body string类型。请求体的原始数据，通常传入file_get_contents('php://input')即可
• @return 返回值有两种情况。返回string类型时，通知仅用作平台校验，将返回值原样输出即可。否则返回Notify对象，包含了本次消息的所有信息
• @throws:
  • NotifyException 消息验证不通过时会抛出该异常
  • ConfigException 配置参数出错时抛出该异常

处理消息

Notify对象中包含消息的所有信息，可用以下方法获取:

• getType(): int 消息的类型。为Notify::TYPE_MESSAGE(消息) 或 Notify::TYPE_EVENT(事件)的值
• getSubType(): string 通知的子类型。例如消息中的text、image，事件中的subscribe、scan等。所有值均为小写
• getContent(string $name = '') 消息内容。传入name时返回消息对应字段的值，默认返回消息全部内容的数组
• getFromUserName(): string 获取通知发送者用户名。一般为用户的OpenID
• getToUserName(): string 获取通知接收者用户名。一般为公众号帐号，与配置项"account"一致
• getCreateTime(): string 获取消息的创建时间

回复消息

Notify类已封装消息回复方法，方法将数据处理成字符串后返回，开发者将其输出即可

方法用法及列表如下

• replyText(string $content) 回复文本消息。传入消息文本
• replyImage(string $mediaID) 回复图片消息。传入图片素材的media_id
• replyVoice(string $mediaID) 回复语音消息。传入语音素材的media_id
• replyVideo(string $mediaID, string $title = '', string $description = '') 回复视频消息
  • mediaID 视频素材的media_id
  • title 视频标题
  • description 视频描述
• replyNews(array $articles) 回复图文消息。传入articles结构，格式请参考微信官方文档。(一次最多发送8篇文章)
• replyMusic(string $title, string $description, string $musicURL, string $hqMusicURL, string $thumbMediaID = '') 回复音乐消息
  • title 音乐标题
  • description 音乐描述
  • musicURL 音乐链接
  • hqMusicURL 高质量音乐链接，WIFI环境优先使用该链接播放音乐
  • thumbMediaID 缩略图的素材id，通过素材管理接口上传thumb类型素材，得到的id
• replyTransferCustomerService(string $kfAccount = '') 将消息转发到客服。传入客服账号。请参考客服消息文档
• reply(string $msgType, array $content = []) 消息回复通用方法。用于后期扩展，一般情况无需使用

授权登录

参考example/oauth.php

JS-SDK

调用$wechat->jsSdk方法，将返回值转换为JS对象，前端传参给wx.config即可

参考example/jssdk.php

异常处理

此项目异常类的命名空间为Yuanshe\WeChatSDK\Exception，以下列出项目中定义的所有异常类，开发者可根据需要自行捕获处理

• Exception 其它异常类的基类
  • ConfigException 配置参数不正确时会抛出该异常
  • NotifyException 通知校验未通过时抛出该异常
  • ModelException 公众平台接口返回错误码时会抛出该异常。可以通过getCode和getMessage方法获取错误码和错误消息，getModel方法可以获取到Model名称

License

LGPL