glacier / ent-wechat
微信企业号接口SDK
0.1.0
2016-12-22 06:56 UTC
Requires
- php: >=5.4.0
- glacier/widgets: ^0.1.0
This package is not auto-updated.
Last update: 2025-06-16 19:06:20 UTC
README
微信企业号SDK 安装:composer require glacier/ent-wechat
先配置好EntConfig
EntSendMsg:发送企业号消息
发送文本消息:sendTxt($content,$agentId,$user,$type='user')
- $content string 文本消息
- $agentId int 应用ID
- $user string|int|array 发送对象,多个可以用数组
- string $type string 'user','tag','party'
- 返回值 bool|null|string http请求成功返回微信送回的json(已解码成数组),错误返回false,通过
errorMsg
属性可以查看失败原因
例子:
use glacier\EntWechat\EntSendMsg;
$a=new EntSendMsg();
$a->sendTxt('test',1,'user1');
$a->sendTxt('test',1,'@all');
$a->sendTxt('test',1,['user1','user2']);
$msg=$a->sendTxt('test',1,['tag1','tag2'],'tag');
var_dump($msg);
//string(27) "{"errcode":0,"errmsg":"ok"}"
发送图文消息:
sendNews(array $news,$agentId,$user,$type='user')
发送消息内容自定义的json内容(文本,图文其他都可以结构参看微信文档):
sendMsg($data)
EntUser:用户管理
增加:create(array $user)
更新:update(array $user)
具体数组$user
的结构参看MsgFormater::entUser
的注释
删除:delete($userid)
获取user信息:listUser($status=0)
验证用户是否会企业号成员:oauth($code)
返回值: 成功返回微信返回的json(已经解码成数组格式),失败返回false
,通过errorMsg
属性可以查看失败原因
例子:
use glacier\EntWechat\EntUser;
$a=new EntUser();
$res=$a->listUser();
//失败打印出错误信息
if(!$res){
var_dump($a->errorMsg);
}
var_dump($res)
/**
array(16) {
[0]=>
array(6) {
["userid"]=>
string(11) "userid1"
["name"]=>
string(9) "xx"
..此处省略X字
*/
验证用户
/**
* 原理:
* 员工要点击的连接URL构造,点击后会跳转到redirect_uri
* https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect
* 员工点击后,页面将跳转至 redirect_uri?code=CODE&state=STATE,微信加上了queryString企业可根据code参数获得员工的userid。
* 脚本根据获取code 找微信验证登录的用户信息
* https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE
*/
//获取code,这个是微信生成的
$code=$_GET['code'];
//如果code获取不到可能不是通过微信来的访问,做点什么。。。。
$a=new EntUser();
$res=$a->oauth($code);
//验证失败返回false,成功返回用户信息数组。
EntMsgHandler:解析用户在应用里发送的消息
<?php
require 'vendor/autoload.php';
use glacier\EntWechat\EntMsgHandler;
use glacier\EntWechat\MsgFormater;
//如果存在首次验证url的时候构造函数会自动解密返回echostr
$a=new EntMsgHandler();
//得到微信解密后返回数组(微信给的是xml格式已经解码)
$msg=$a->getMsgArray();
//格式化文本消息字符串,该例子是把微信post过来的数据json序列化后原样当成text输出
$msg=MsgFormater::text(json_encode($msg,JSON_UNESCAPED_UNICODE));
//$msg=MsgFormater::news($array); 返回的内容为news类型具体看注释
//将要返回的内容加密
$c=$a->responseMsg($msg);
//这里可以做一些log之流的操作
//返回内容给用户
echo $c;