glacier/ent-wechat

微信企业号接口SDK

0.1.0 2016-12-22 06:56 UTC

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;