2017 © Pedro Peláez
 

library ent-wechat

微信企业号接口SDK

image

glacier/ent-wechat

微信企业号接口SDK

  • Friday, December 23, 2016
  • by glacier
  • Repository
  • 1 Watchers
  • 6 Stars
  • 14 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 2 Versions
  • 0 % Grown

The README.md

EntWechat

微信企业号SDK 安装:composer require glacier/ent-wechat, (*1)

先配置好EntConfig, (*2)

EntSendMsg:发送企业号消息

发送文本消息:sendTxt($content,$agentId,$user,$type='user'), (*3)

  • $content string 文本消息
  • $agentId int 应用ID
  • $user string|int|array 发送对象,多个可以用数组
  • string $type string 'user','tag','party'
  • 返回值 bool|null|string http请求成功返回微信送回的json(已解码成数组),错误返回false,通过errorMsg属性可以查看失败原因

例子:, (*4)

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'), (*5)

发送消息内容自定义的json内容(文本,图文其他都可以结构参看微信文档): sendMsg($data), (*6)

EntUser:用户管理

增加:create(array $user) 更新:update(array $user) 具体数组$user的结构参看MsgFormater::entUser的注释 删除:delete($userid) 获取user信息:listUser($status=0) 验证用户是否会企业号成员:oauth($code) 返回值: 成功返回微信返回的json(已经解码成数组格式),失败返回false,通过errorMsg属性可以查看失败原因, (*7)

例子:, (*8)

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字
*/

验证用户, (*9)

    /**
     * 原理:
     * 员工要点击的连接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;

The Versions

23/12 2016

dev-master

9999999-dev

微信企业号接口SDK

  Sources   Download

MIT

The Requires

 

22/12 2016

0.1.0

0.1.0.0

微信企业号接口SDK

  Sources   Download

MIT

The Requires