git wechat.class.php,wechat-php-sdk/qywechat.class.php at master · gitye/wechat-php-sdk · GitHub
/**
*微信公眾平臺企業號PHP-SDK, 官方API類庫
* @author binsee
* @link https://github.com/binsee/wechat-php-sdk
* @version 1.0
* usage:
* $options = array(
*'token'=>'tokenaccesskey', //填寫應用接口的Token
*'encodingaeskey'=>'encodingaeskey', //填寫加密用的EncodingAESKey
*'appid'=>'wxdk1234567890', //填寫高級調用功能的app id
*'appsecret'=>'xxxxxxxxxxxxxxxxxxx', //填寫高級調用功能的密鑰
*'agentid'=>'1', //應用的id
*'debug'=>false, //調試開關
*'_logcallback'=>'logg', //調試輸出方法，需要有一個string類型的參數
*);
*
*/
class Wechat
{
const MSGTYPE_TEXT = 'text';
const MSGTYPE_IMAGE = 'image';
const MSGTYPE_LOCATION = 'location';
const MSGTYPE_LINK = 'link'; //暫不支持
const MSGTYPE_EVENT = 'event';
const MSGTYPE_MUSIC = 'music'; //暫不支持
const MSGTYPE_NEWS = 'news';
const MSGTYPE_VOICE = 'voice';
const MSGTYPE_VIDEO = 'video';
const API_URL_PREFIX = 'https://qyapi.weixin.qq.com/cgi-bin';
const USER_CREATE_URL = '/user/create?';
const USER_UPDATE_URL = '/user/update?';
const USER_DELETE_URL = '/user/delete?';
const USER_GET_URL = '/user/get?';
const USER_LIST_URL = '/user/simplelist?';
const USER_GETINFO_URL = '/user/getuserinfo?';
const DEPARTMENT_CREATE_URL = '/department/create?';
const DEPARTMENT_UPDATE_URL = '/department/update?';
const DEPARTMENT_DELETE_URL = '/department/delete?';
const DEPARTMENT_MOVE_URL = '/department/move?';
const DEPARTMENT_LIST_URL = '/department/list?';
const TAG_CREATE_URL = '/tag/create?';
const TAG_UPDATE_URL = '/tag/update?';
const TAG_DELETE_URL = '/tag/delete?';
const TAG_GET_URL = '/tag/get?';
const TAG_ADDUSER_URL = '/tag/addtagusers?';
const TAG_DELUSER_URL = '/tag/deltagusers?';
const TAG_LIST_URL = '/tag/list?';
const MEDIA_UPLOAD_URL = '/media/upload?';
const MEDIA_GET_URL = '/media/get?';
const AUTHSUCC_URL = '/user/authsucc?';
const MASS_SEND_URL = '/message/send?';
const MENU_CREATE_URL = '/menu/create?';
const MENU_GET_URL = '/menu/get?';
const MENU_DELETE_URL = '/menu/delete?';
const TOKEN_GET_URL = '/gettoken?';
const OAUTH_PREFIX = 'https://open.weixin.qq.com/connect/oauth2';
const OAUTH_AUTHORIZE_URL = '/authorize?';
private $token;
private $encodingAesKey;
private $appid; //也就是企業號的CorpID
private $appsecret;
private $access_token;
private $agentid; //應用id AgentID
private $postxml;
private $agentidxml; //接收的應用id AgentID
private $_msg;
private $_receive;
private $_sendmsg; //主動發送消息的內容
private $_text_filter = true;
public $debug = false;
public $errCode = 40001;
public $errMsg = "no access";
private $_logcallback;
public function __construct($options)
{
$this->token = isset($options['token'])?$options['token']:'';
$this->encodingAesKey = isset($options['encodingaeskey'])?$options['encodingaeskey']:'';
$this->appid = isset($options['appid'])?$options['appid']:'';
$this->appsecret = isset($options['appsecret'])?$options['appsecret']:'';
$this->agentid = isset($options['agentid'])?$options['agentid']:'';
$this->debug = isset($options['debug'])?$options['debug']:false;
$this->_logcallback = isset($options['logcallback'])?$options['logcallback']:false;
}
private function log($log){
if ($this->debug && function_exists($this->_logcallback)) {
if (is_array($log)) $log = print_r($log,true);
return call_user_func($this->_logcallback,$log);
}
}
/**
* 數據XML編碼
* @param mixed $data 數據
* @return string
*/
public static function data_to_xml($data) {
$xml = '';
foreach ($data as $key => $val) {
is_numeric($key) && $key = "item id=\"$key\"";
$xml .= "";
$xml .= ( is_array($val) || is_object($val)) ? self::data_to_xml($val) : self::xmlSafeStr($val);
list($key, ) = explode(' ', $key);
$xml .= "$key>";
}
return $xml;
}
public static function xmlSafeStr($str)
{
return '';
}
/**
* XML編碼
* @param mixed $data 數據
* @param string $root 根節點名
* @param string $item 數字索引的子節點名
* @param string $attr 根節點屬性
* @param string $id 數字索引子節點key轉換的屬性名
* @param string $encoding 數據編碼
* @return string
*/
public function xml_encode($data, $root='xml', $item='item', $attr='', $id='id', $encoding='utf-8') {
if(is_array($attr)){
$_attr = array();
foreach ($attr as $key => $value) {
$_attr[] = "{$key}=\"{$value}\"";
}
$attr = implode(' ', $_attr);
}
$attr = trim($attr);
$attr = empty($attr) ? '' : " {$attr}";
$xml = "";
$xml .= self::data_to_xml($data, $item, $id);
$xml .= "{$root}>";
return $xml;
}
/**
* 微信api不支持中文轉義的json結構
* @param array $arr
*/
static function json_encode($arr) {
$parts = array ();
$is_list = false;
//Find out if the given array is a numerical array
$keys = array_keys ( $arr );
$max_length = count ( $arr ) - 1;
if (($keys [0] === 0) && ($keys [$max_length] === $max_length )) { //See if the first key is 0 and last key is length - 1
$is_list = true;
for($i = 0; $i < count ( $keys ); $i ++) { //See if each key correspondes to its position
if ($i != $keys [$i]) { //A key fails at position check.
$is_list = false; //It is an associative array.
break;
}
}
}
foreach ( $arr as $key => $value ) {
if (is_array ( $value )) { //Custom handling for arrays
if ($is_list)
$parts [] = self::json_encode ( $value ); /* :RECURSION: */
else
$parts [] = '"' . $key . '":' . self::json_encode ( $value ); /* :RECURSION: */
} else {
$str = '';
if (! $is_list)
$str = '"' . $key . '":';
//Custom handling for multiple data types
if (!is_string ( $value ) && is_numeric ( $value ) && $value<2000000000)
$str .= $value; //Numbers
elseif ($value === false)
$str .= 'false'; //The booleans
elseif ($value === true)
$str .= 'true';
else
$str .= '"' . addslashes ( $value ) . '"'; //All other things
// :TODO: Is there any more datatype we should be in the lookout for? (Object?)
$parts [] = $str;
}
}
$json = implode ( ',', $parts );
if ($is_list)
return '[' . $json . ']'; //Return numerical JSON
return '{' . $json . '}'; //Return associative JSON
}
/**
* 過濾文字回復\r\n換行符
* @param string $text
* @return string|mixed
*/
private function _auto_text_filter($text) {
if (!$this->_text_filter) return $text;
return str_replace("\r\n", "\n", $text);
}
/**
* GET 請求
* @param string $url
*/
private function http_get($url){
$oCurl = curl_init();
if(stripos($url,"https://")!==FALSE){
curl_setopt($oCurl, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($oCurl, CURLOPT_SSL_VERIFYHOST, FALSE);
curl_setopt($oCurl, CURLOPT_SSLVERSION, 1); //CURL_SSLVERSION_TLSv1
}
curl_setopt($oCurl, CURLOPT_URL, $url);
curl_setopt($oCurl, CURLOPT_RETURNTRANSFER, 1 );
$sContent = curl_exec($oCurl);
$aStatus = curl_getinfo($oCurl);
curl_close($oCurl);
if(intval($aStatus["http_code"])==200){
return $sContent;
}else{
return false;
}
}
/**
* POST 請求
* @param string $url
* @param array $param
* @param boolean $post_file 是否文件上傳
* @return string content
*/
private function http_post($url,$param,$post_file=false){
$oCurl = curl_init();
if(stripos($url,"https://")!==FALSE){
curl_setopt($oCurl, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($oCurl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($oCurl, CURLOPT_SSLVERSION, 1); //CURL_SSLVERSION_TLSv1
}
if (is_string($param) || $post_file) {
$strPOST = $param;
} else {
$aPOST = array();
foreach($param as $key=>$val){
$aPOST[] = $key."=".urlencode($val);
}
$strPOST = join("&", $aPOST);
}
curl_setopt($oCurl, CURLOPT_URL, $url);
curl_setopt($oCurl, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt($oCurl, CURLOPT_POST,true);
curl_setopt($oCurl, CURLOPT_POSTFIELDS,$strPOST);
$sContent = curl_exec($oCurl);
$aStatus = curl_getinfo($oCurl);
curl_close($oCurl);
if(intval($aStatus["http_code"])==200){
return $sContent;
}else{
return false;
}
}
/**
* For weixin server validation
*/
private function checkSignature($str)
{
$signature = isset($_GET["msg_signature"])?$_GET["msg_signature"]:'';
$timestamp = isset($_GET["timestamp"])?$_GET["timestamp"]:'';
$nonce = isset($_GET["nonce"])?$_GET["nonce"]:'';
$tmpArr = array($str,$this->token, $timestamp, $nonce);//比普通公眾平臺多了一個加密的密文
sort($tmpArr, SORT_STRING);
$tmpStr = implode($tmpArr);
$shaStr = sha1($tmpStr);
if( $shaStr == $signature ){
return true;
}else{
return false;
}
}
/**
* 微信驗證，包括post來的xml解密
* @param bool $return 是否返回
*/
public function valid($return=false)
{
$encryptStr="";
if ($_SERVER['REQUEST_METHOD'] == "POST") {
$postStr = file_get_contents("php://input");
$array = (array)simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
$this->log($postStr);
if (isset($array['Encrypt'])) {
$encryptStr = $array['Encrypt'];
$this->agentidxml = isset($array['AgentID']) ? $array['AgentID']: '';
}
} else {
$encryptStr = isset($_GET["echostr"]) ? $_GET["echostr"]: '';
}
if ($encryptStr) {
$ret=$this->checkSignature($encryptStr);
}
if (!isset($ret) || !$ret) {
if (!$return) {
die('no access');
} else {
return false;
}
}
$pc = new Prpcrypt($this->encodingAesKey);
$array = $pc->decrypt($encryptStr,$this->appid);
if (!isset($array[0]) || ($array[0] != 0)) {
if (!$return) {
die('解密失敗！');
} else {
return false;
}
}
if ($_SERVER['REQUEST_METHOD'] == "POST") {
$this->postxml = $array[1];
//$this->log($array[1]);
return ($this->postxml!="");
} else {
$echoStr = $array[1];
if ($return) {
return $echoStr;
} else {
die($echoStr);
}
}
return false;
}
/**
* 獲取微信服務器發來的信息
*/
public function getRev()
{
if ($this->_receive) return $this;
$postStr = $this->postxml;
$this->log($postStr);
if (!empty($postStr)) {
$this->_receive = (array)simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
if (!isset($this->_receive['AgentID'])) {
$this->_receive['AgentID']=$this->agentidxml; //當前接收消息的應用id
}
}
return $this;
}
/**
* 獲取微信服務器發來的信息
*/
public function getRevData()
{
return $this->_receive;
}
/**
* 獲取微信服務器發來的原始加密信息
*/
public function getRevPostXml()
{
return $this->postxml;
}
/**
* 獲取消息發送者
*/
public function getRevFrom() {
if (isset($this->_receive['FromUserName']))
return $this->_receive['FromUserName'];
else
return false;
}
/**
* 獲取消息接受者
*/
public function getRevTo() {
if (isset($this->_receive['ToUserName']))
return $this->_receive['ToUserName'];
else
return false;
}
/**
* 獲取接收消息的應用id
*/
public function getRevAgentID() {
if (isset($this->_receive['AgentID']))
return $this->_receive['AgentID'];
else
return false;
}
/**
* 獲取接收消息的類型
*/
public function getRevType() {
if (isset($this->_receive['MsgType']))
return $this->_receive['MsgType'];
else
return false;
}
/**
* 獲取消息ID
*/
public function getRevID() {
if (isset($this->_receive['MsgId']))
return $this->_receive['MsgId'];
else
return false;
}
/**
* 獲取消息發送時間
*/
public function getRevCtime() {
if (isset($this->_receive['CreateTime']))
return $this->_receive['CreateTime'];
else
return false;
}
/**
* 獲取接收消息內容正文
*/
public function getRevContent(){
if (isset($this->_receive['Content']))
return $this->_receive['Content'];
else
return false;
}
/**
* 獲取接收消息圖片
*/
public function getRevPic(){
if (isset($this->_receive['PicUrl']))
return array(
'mediaid'=>$this->_receive['MediaId'],
'picurl'=>(string)$this->_receive['PicUrl'], //防止picurl為空導致解析出錯
);
else
return false;
}
/**
* 獲取接收地理位置
*/
public function getRevGeo(){
if (isset($this->_receive['Location_X'])){
return array(
'x'=>$this->_receive['Location_X'],
'y'=>$this->_receive['Location_Y'],
'scale'=>(string)$this->_receive['Scale'],
'label'=>(string)$this->_receive['Label']
);
} else
return false;
}
/**
* 獲取上報地理位置事件
*/
public function getRevEventGeo(){
if (isset($this->_receive['Latitude'])){
return array(
'x'=>$this->_receive['Latitude'],
'y'=>$this->_receive['Longitude'],
'precision'=>$this->_receive['Precision'],
);
} else
return false;
}
/**
* 獲取接收事件推送
*/
public function getRevEvent(){
if (isset($this->_receive['Event'])){
$array['event'] = $this->_receive['Event'];
}
if (isset($this->_receive['EventKey'])){
$array['key'] = $this->_receive['EventKey'];
}
if (isset($array) && count($array) > 0) {
return $array;
} else {
return false;
}
}
/**
* 獲取自定義菜單的掃碼推事件信息
*
* 事件類型為以下兩種時則調用此方法有效
* Event 事件類型，scancode_push
* Event 事件類型，scancode_waitmsg
*
* @return: array | false
* array (
* 'ScanType'=>'qrcode',
* 'ScanResult'=>'123123'
* )
*/
public function getRevScanInfo(){
if (isset($this->_receive['ScanCodeInfo'])){
if (!is_array($this->_receive['SendPicsInfo'])) {
$array=(array)$this->_receive['ScanCodeInfo'];
$this->_receive['ScanCodeInfo']=$array;
}else {
$array=$this->_receive['ScanCodeInfo'];
}
}
if (isset($array) && count($array) > 0) {
return $array;
} else {
return false;
}
}
/**
* 獲取自定義菜單的圖片發送事件信息
*
* 事件類型為以下三種時則調用此方法有效
* Event 事件類型，pic_sysphoto 彈出系統拍照發圖的事件推送
* Event 事件類型，pic_photo_or_album 彈出拍照或者相冊發圖的事件推送
* Event 事件類型，pic_weixin 彈出微信相冊發圖器的事件推送
*
* @return: array | false
* array (
* 'Count' => '2',
* 'PicList' =>array (
* 'item' =>array (
* 0 =>array ('PicMd5Sum' => 'aaae42617cf2a14342d96005af53624c'),
* 1 =>array ('PicMd5Sum' => '149bd39e296860a2adc2f1bb81616ff8'),
* ),
* ),
* )
*
*/
public function getRevSendPicsInfo(){
if (isset($this->_receive['SendPicsInfo'])){
if (!is_array($this->_receive['SendPicsInfo'])) {
$array=(array)$this->_receive['SendPicsInfo'];
if (isset($array['PicList'])){
$array['PicList']=(array)$array['PicList'];
$item=$array['PicList']['item'];
$array['PicList']['item']=array();
foreach ( $item as $key => $value ){
$array['PicList']['item'][$key]=(array)$value;
}
}
$this->_receive['SendPicsInfo']=$array;
} else {
$array=$this->_receive['SendPicsInfo'];
}
}
if (isset($array) && count($array) > 0) {
return $array;
} else {
return false;
}
}
/**
* 獲取自定義菜單的地理位置選擇器事件推送
*
* 事件類型為以下時則可以調用此方法有效
* Event 事件類型，location_select 彈出系統拍照發圖的事件推送
*
* @return: array | false
* array (
* 'Location_X' => '33.731655000061',
* 'Location_Y' => '113.29955200008047',
* 'Scale' => '16',
* 'Label' => '某某市某某區某某路',
* 'Poiname' => '',
* )
*
*/
public function getRevSendGeoInfo(){
if (isset($this->_receive['SendLocationInfo'])){
if (!is_array($this->_receive['SendLocationInfo'])) {
$array=(array)$this->_receive['SendLocationInfo'];
if (empty($array['Poiname'])) {
$array['Poiname']="";
}
if (empty($array['Label'])) {
$array['Label']="";
}
$this->_receive['SendLocationInfo']=$array;
} else {
$array=$this->_receive['SendLocationInfo'];
}
}
if (isset($array) && count($array) > 0) {
return $array;
} else {
return false;
}
}
/**
* 獲取接收語音推送
*/
public function getRevVoice(){
if (isset($this->_receive['MediaId'])){
return array(
'mediaid'=>$this->_receive['MediaId'],
'format'=>$this->_receive['Format'],
);
} else
return false;
}
/**
* 獲取接收視頻推送
*/
public function getRevVideo(){
if (isset($this->_receive['MediaId'])){
return array(
'mediaid'=>$this->_receive['MediaId'],
'thumbmediaid'=>$this->_receive['ThumbMediaId']
);
} else
return false;
}
/**
* 設置回復消息
* Example: $obj->text('hello')->reply();
* @param string $text
*/
public function text($text='')
{
$msg = array(
'ToUserName' => $this->getRevFrom(),
'FromUserName'=>$this->getRevTo(),
'MsgType'=>self::MSGTYPE_TEXT,
'Content'=>$this->_auto_text_filter($text),
'CreateTime'=>time(),
);
$this->Message($msg);
return $this;
}
/**
* 設置回復消息
* Example: $obj->image('media_id')->reply();
* @param string $mediaid
*/
public function image($mediaid='')
{
$msg = array(
'ToUserName' => $this->getRevFrom(),
'FromUserName'=>$this->getRevTo(),
'MsgType'=>self::MSGTYPE_IMAGE,
'Image'=>array('MediaId'=>$mediaid),
'CreateTime'=>time(),
);
$this->Message($msg);
return $this;
}
/**
* 設置回復消息
* Example: $obj->voice('media_id')->reply();
* @param string $mediaid
*/
public function voice($mediaid='')
{
$msg = array(
'ToUserName' => $this->getRevFrom(),
'FromUserName'=>$this->getRevTo(),
'MsgType'=>self::MSGTYPE_IMAGE,
'Voice'=>array('MediaId'=>$mediaid),
'CreateTime'=>time(),
);
$this->Message($msg);
return $this;
}
/**
* 設置回復消息
* Example: $obj->video('media_id','title','description')->reply();
* @param string $mediaid
*/
public function video($mediaid='',$title='',$description='')
{
$msg = array(
'ToUserName' => $this->getRevFrom(),
'FromUserName'=>$this->getRevTo(),
'MsgType'=>self::MSGTYPE_IMAGE,
'Video'=>array(
'MediaId'=>$mediaid,
'Title'=>$title,
'Description'=>$description
),
'CreateTime'=>time(),
);
$this->Message($msg);
return $this;
}
/**
* 設置回復圖文
* @param array $newsData
* 數組結構:
* array(
* "0"=>array(
* 'Title'=>'msg title',
* 'Description'=>'summary text',
* 'PicUrl'=>'http://www.domain.com/1.jpg',
* 'Url'=>'http://www.domain.com/1.html'
* ),
* "1"=>....
* )
*/
public function news($newsData=array())
{
$count = count($newsData);
$msg = array(
'ToUserName' => $this->getRevFrom(),
'FromUserName'=>$this->getRevTo(),
'MsgType'=>self::MSGTYPE_NEWS,
'CreateTime'=>time(),
'ArticleCount'=>$count,
'Articles'=>$newsData,
);
$this->Message($msg);
return $this;
}
/**
* 設置發送消息
* @param array $msg 消息數組
* @param bool $append 是否在原消息數組追加
*/
public function Message($msg = '',$append = false){
if (is_null($msg)) {
$this->_msg =array();
}elseif (is_array($msg)) {
if ($append)
$this->_msg = array_merge($this->_msg,$msg);
else
$this->_msg = $msg;
return $this->_msg;
} else {
return $this->_msg;
}
}
/**
*
* 回復微信服務器, 此函數支持鏈式操作
* Example: $this->text('msg tips')->reply();
* @param string $msg 要發送的信息, 默認取$this->_msg
* @param bool $return 是否返回信息而不拋出到瀏覽器 默認:否
*/
public function reply($msg=array(),$return = false)
{
if (empty($msg))
$msg = $this->_msg;
$xmldata= $this->xml_encode($msg);
$this->log($xmldata);
$pc = new Prpcrypt($this->encodingAesKey);
$array = $pc->encrypt($xmldata, $this->appid);
$ret = $array[0];
if ($ret != 0) {
$this->log('encrypt err!');
return false;
}
$timestamp = time();
$nonce = rand(77,999)*rand(605,888)*rand(11,99);
$encrypt = $array[1];
$tmpArr = array($this->token, $timestamp, $nonce,$encrypt);//比普通公眾平臺多了一個加密的密文
sort($tmpArr, SORT_STRING);
$signature = implode($tmpArr);
$signature = sha1($signature);
$smsg = $this->generate($encrypt, $signature, $timestamp, $nonce);
$this->log($smsg);
if ($return)
return $smsg;
elseif ($smsg){
echo $smsg;
return true;
}else
return false;
}
private function generate($encrypt, $signature, $timestamp, $nonce)
{
//格式化加密信息
$format = "
%s
";
return sprintf($format, $encrypt, $signature, $timestamp, $nonce);
}
/**
* 通用auth驗證方法
* @param string $appid
* @param string $appsecret
* @param string $token 手動指定access_token，非必要情況不建議用
*/
public function checkAuth($appid='',$appsecret='',$token=''){
if (!$appid || !$appsecret) {
$appid = $this->appid;
$appsecret = $this->appsecret;
}
if ($token) { //手動指定token，優先使用
$this->access_token=$token;
return $this->access_token;
}
//TODO: get the cache access_token
$result = $this->http_get(self::API_URL_PREFIX.self::TOKEN_GET_URL.'corpid='.$appid.'&corpsecret='.$appsecret);
if ($result)
{
$json = json_decode($result,true);
if (!$json || isset($json['errcode'])) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
$this->access_token = $json['access_token'];
$expire = $json['expires_in'] ? intval($json['expires_in'])-100 : 3600;
//TODO: cache access_token
return $this->access_token;
}
return false;
}
/**
* 刪除驗證數據
* @param string $appid
*/
public function resetAuth($appid=''){
if (!$appid) $appid = $this->appid;
$this->access_token = '';
//TODO: remove cache
return true;
}
/**
* 創建菜單
* @param array $data 菜單數組數據
* example:
* array (
* 'button' => array (
* 0 => array (
* 'name' => '掃碼',
* 'sub_button' => array (
* 0 => array (
* 'type' => 'scancode_waitmsg',
* 'name' => '掃碼帶提示',
* 'key' => 'rselfmenu_0_0',
* ),
* 1 => array (
* 'type' => 'scancode_push',
* 'name' => '掃碼推事件',
* 'key' => 'rselfmenu_0_1',
* ),
* ),
* ),
* 1 => array (
* 'name' => '發圖',
* 'sub_button' => array (
* 0 => array (
* 'type' => 'pic_sysphoto',
* 'name' => '系統拍照發圖',
* 'key' => 'rselfmenu_1_0',
* ),
* 1 => array (
* 'type' => 'pic_photo_or_album',
* 'name' => '拍照或者相冊發圖',
* 'key' => 'rselfmenu_1_1',
* )
* ),
* ),
* 2 => array (
* 'type' => 'location_select',
* 'name' => '發送位置',
* 'key' => 'rselfmenu_2_0'
* ),
* ),
* )
* type可以選擇為以下幾種，會收到相應類型的事件推送。請注意，3到8的所有事件，僅支持微信iPhone5.4.1以上版本，
* 和Android5.4以上版本的微信用戶，舊版本微信用戶點擊后將沒有回應，開發者也不能正常接收到事件推送。
* 1、click：點擊推事件
* 2、view：跳轉URL
* 3、scancode_push：掃碼推事件
* 4、scancode_waitmsg：掃碼推事件且彈出“消息接收中”提示框
* 5、pic_sysphoto：彈出系統拍照發圖
* 6、pic_photo_or_album：彈出拍照或者相冊發圖
* 7、pic_weixin：彈出微信相冊發圖器
* 8、location_select：彈出地理位置選擇器
*/
public function createMenu($data,$agentid=''){
if ($agentid=='') {
$agentid=$this->agentid;
}
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::MENU_CREATE_URL.'access_token='.$this->access_token.'&agentid='.$agentid,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return true;
}
return false;
}
/**
* 獲取菜單
* @return array('menu'=>array(....s))
*/
public function getMenu($agentid=''){
if ($agentid=='') {
$agentid=$this->agentid;
}
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::MENU_GET_URL.'access_token='.$this->access_token.'&agentid='.$agentid);
if ($result)
{
$json = json_decode($result,true);
if (!$json || isset($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 刪除菜單
* @return boolean
*/
public function deleteMenu($agentid=''){
if ($agentid=='') {
$agentid=$this->agentid;
}
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::MENU_DELETE_URL.'access_token='.$this->access_token.'&agentid='.$agentid);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode'])) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return true;
}
return false;
}
/**
* 上傳多媒體文件 (只有三天的有效期，過期自動被刪除)
* 注意：數組的鍵值任意，但文件名前必須加@，使用單引號以避免本地路徑斜杠被轉義
* @param array $data {"media":'@Path\filename.jpg'}
* @param type 媒體文件類型:圖片(image)、語音(voice)、視頻(video)，普通文件(file)
* @return boolean|array
* {
* "type": "image",
* "media_id": "0000001",
* "created_at": "1380000000"
* }
*/
public function uploadMedia($data, $type){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::MEDIA_UPLOAD.'access_token='.$this->access_token.'&type='.$type,$data,true);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode'])) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 根據媒體文件ID獲取媒體文件
* @param string $media_id 媒體文件id
* @return raw data
*/
public function getMedia($media_id){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::MEDIA_GET_URL.'access_token='.$this->access_token.'&media_id='.$media_id);
if ($result)
{
$json = json_decode($result,true);
if (isset($json['errcode'])) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $result;
}
return false;
}
/**
* 創建部門
* @param array $data 結構體為:
* array (
* "name" => "郵箱產品組", //部門名稱
* "parentid" => "1" //父部門id
* "order" => "1", //(非必須)在父部門中的次序。從1開始，數字越大排序越靠后
* )
* @return boolean|array
* 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "created", //對返回碼的文本描述內容
* "id": 2 //創建的部門id。
* }
*/
public function createDepartment($data){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::DEPARTMENT_CREATE_URL.'access_token='.$this->access_token,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 更新部門
* @param array $data 結構體為:
* array(
* "id" => "1" //(必須)部門id
* "name" => "郵箱產品組", //(非必須)部門名稱
* "parentid" => "1", //(非必須)父親部門id。根部門id為1
* "order" => "1", //(非必須)在父部門中的次序。從1開始，數字越大排序越靠后
* )
* @return boolean|array 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "updated" //對返回碼的文本描述內容
* }
*/
public function updateDepartment($data){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::DEPARTMENT_UPDATE_URL.'access_token='.$this->access_token,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 刪除部門
* @param $id
* @return boolean|array 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "deleted" //對返回碼的文本描述內容
* }
*/
public function deleteDepartment($id){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::DEPARTMENT_DELETE_URL.'access_token='.$this->access_token.'&id='.$id);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 移動部門
* @param $data
* array(
* "department_id" => "5",//所要移動的部門
* "to_parentid" => "2",//想移動到的父部門節點，根部門為1
* "to_position" => "1"//(非必須)想移動到的父部門下的位置，1表示最上方，往后位置為2，3，4，以此類推，默認為1
* )
* @return boolean|array 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "ok" //對返回碼的文本描述內容
* }
*/
public function moveDepartment($data){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::DEPARTMENT_MOVE_URL.'access_token='.$this->access_token,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 獲取部門列表
* @return boolean|array 成功返回結果
* {
* "errcode": 0,
* "errmsg": "ok",
* "department": [ //部門列表數據。以部門的order字段從小到大排列
* {
* "id": 1,
* "name": "廣州研發中心",
* "parentid": 0
* },
* {
* "id": 2
* "name": "郵箱產品部",
* "parentid": 1
* }
* ]
* }
*/
public function getDepartment(){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::DEPARTMENT_LIST_URL.'access_token='.$this->access_token);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode'])) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 創建成員
* @param array $data 結構體為:
* array(
* "userid" => "zhangsan",
* "name" => "張三",
* "department" => [1, 2],
* "position" => "產品經理",
* "mobile" => "15913215421",
* "gender" => 1, //性別。gender=0表示男，=1表示女
* "tel" => "62394",
* "email" => "zhangsan@gzdev.com",
* "weixinid" => "zhangsan4dev"
* )
* @return boolean|array
* 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "created", //對返回碼的文本描述內容
* }
*/
public function createUser($data){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::USER_CREATE_URL.'access_token='.$this->access_token,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 更新成員
* @param array $data 結構體為:
* array(
* "userid" => "zhangsan",
* "name" => "張三",
* "department" => [1, 2],
* "position" => "產品經理",
* "mobile" => "15913215421",
* "gender" => 1, //性別。gender=0表示男，=1表示女
* "tel" => "62394",
* "email" => "zhangsan@gzdev.com",
* "weixinid" => "zhangsan4dev"
* )
* @return boolean|array 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "updated" //對返回碼的文本描述內容
* }
*/
public function updateUser($data){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::USER_UPDATE_URL.'access_token='.$this->access_token,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 刪除成員
* @param $userid 員工UserID。對應管理端的帳號
* @return boolean|array 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "deleted" //對返回碼的文本描述內容
* }
*/
public function deleteUser($userid){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::USER_DELETE_URL.'access_token='.$this->access_token.'&userid='.$userid);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 獲取成員信息
* @param $userid 員工UserID。對應管理端的帳號
* @return boolean|array 成功返回結果
* {
* "errcode": 0,
* "errmsg": "ok",
* "userid": "zhangsan",
* "name": "李四",
* "department": [1, 2],
* "position": "后臺工程師",
* "mobile": "15913215421",
* "gender": 1, //性別。gender=0表示男，=1表示女
* "tel": "62394",
* "email": "zhangsan@gzdev.com",
* "weixinid": "lisifordev", //微信號
* "avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3W..../0", //頭像url。注：如果要獲取小圖將url最后的"/0"改成"/64"即可
* "status": 1 //關注狀態: 1=已關注，2=已凍結，4=未關注
* }
*/
public function getUserInfo($userid){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::USER_GET_URL.'access_token='.$this->access_token.'&userid='.$userid);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 獲取部門成員
* @param $department_id 部門id
* @param $fetch_child 1/0：是否遞歸獲取子部門下面的成員
* @param $status 0獲取全部員工，1獲取已關注成員列表，2獲取禁用成員列表，4獲取未關注成員列表。status可疊加
* @return boolean|array 成功返回結果
* {
* "errcode": 0,
* "errmsg": "ok",
* "userlist": [
* {
* "userid": "zhangsan",
* "name": "李四"
* }
* ]
* }
*/
public function getUserList($department_id,$fetch_child=0,$status=0){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::USER_LIST_URL.'access_token='.$this->access_token
.'&department_id='.$department_id.'&fetch_child='.$fetch_child.'&status='.$status);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 根據code獲取成員信息
* 通過Oauth2.0或者設置了二次驗證時獲取的code，用于換取成員的UserId和DeviceId
*
* @param $code Oauth2.0或者二次驗證時返回的code值
* @param $agentid 跳轉鏈接時所在的企業應用ID，未填則默認為當前配置的應用id
* @return boolean|array 成功返回數組
* array(
* 'UserId' => 'USERID', //員工UserID
* 'DeviceId' => 'DEVICEID' //手機設備號(由微信在安裝時隨機生成)
* )
*/
public function getUserId($code,$agentid=0){
if (!$agentid) $agentid=$this->agentid;
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::USER_GETINFO_URL.'access_token='.$this->access_token.'&code='.$code.'&agentid'.$agentid);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 創建標簽
* @param array $data 結構體為:
* array(
* "tagname" => "UI"
* )
* @return boolean|array
* 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "created", //對返回碼的文本描述內容
* "tagid": "1"
* }
*/
public function createTag($data){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::TAG_CREATE_URL.'access_token='.$this->access_token,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 更新標簽
* @param array $data 結構體為:
* array(
* "tagid" => "1",
* "tagname" => "UI design"
* )
* @return boolean|array 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "updated" //對返回碼的文本描述內容
* }
*/
public function updateTag($data){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::TAG_UPDATE_URL.'access_token='.$this->access_token,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 刪除標簽
* @param $tagid 標簽TagID
* @return boolean|array 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "deleted" //對返回碼的文本描述內容
* }
*/
public function deleteTag($tagid){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::TAG_DELETE_URL.'access_token='.$this->access_token.'&tagid='.$tagid);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 獲取標簽成員
* @param $tagid 標簽TagID
* @return boolean|array 成功返回結果
* {
* "errcode": 0,
* "errmsg": "ok",
* "userlist": [
* {
* "userid": "zhangsan",
* "name": "李四"
* }
* ]
* }
*/
public function getTag($tagid){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::TAG_GET_URL.'access_token='.$this->access_token.'&tagid='.$tagid);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 增加標簽成員
* @param array $data 結構體為:
* array (
* "tagid" => "1",
* "userlist" => array( //企業員工ID列表
* "user1",
* "user2"
* )
* )
* @return boolean|array
* 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "ok", //對返回碼的文本描述內容
* "invalidlist"："usr1|usr2|usr" //若部分userid非法，則會有此段。不在權限內的員工ID列表，以“|”分隔
* }
*/
public function addTagUser($data){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::TAG_ADDUSER_URL.'access_token='.$this->access_token,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 刪除標簽成員
* @param array $data 結構體為:
* array (
* "tagid" => "1",
* "userlist" => array( //企業員工ID列表
* "user1",
* "user2"
* )
* )
* @return boolean|array
* 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "deleted", //對返回碼的文本描述內容
* "invalidlist"："usr1|usr2|usr" //若部分userid非法，則會有此段。不在權限內的員工ID列表，以“|”分隔
* }
*/
public function delTagUser($data){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::TAG_DELUSER_URL.'access_token='.$this->access_token,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 獲取標簽列表
* @return boolean|array 成功返回數組結果，這里附上json樣例
* {
* "errcode": 0,
* "errmsg": "ok",
* "taglist":[
* {"tagid":1,"tagname":"a"},
* {"tagid":2,"tagname":"b"}
* ]
* }
*/
public function getTagList(){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::TAG_LIST_URL.'access_token='.$this->access_token);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode'])) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 主動發送信息接口
* @param array $data 結構體為:
* array(
* "touser" => "UserID1|UserID2|UserID3",
* "toparty" => "PartyID1|PartyID2 ",
* "totag" => "TagID1|TagID2 ",
* "safe":"0"//是否為保密消息，對于news無效
* "agentid" => "001",//應用id
* "msgtype" => "text", //根據信息類型，選擇下面對應的信息結構體
*
* "text" => array(
* "content" => "Holiday Request For Pony(http://xxxxx)"
* ),
*
* "image" => array(
* "media_id" => "MEDIA_ID"
* ),
*
* "voice" => array(
* "media_id" => "MEDIA_ID"
* ),
*
* " video" => array(
* "media_id" => "MEDIA_ID",
* "title" => "Title",
* "description" => "Description"
* ),
*
* "file" => array(
* "media_id" => "MEDIA_ID"
* ),
*
* "news" => array(//不支持保密
* "articles" => array( //articles 圖文消息，一個圖文消息支持1到10個圖文
* array(
* "title" => "Title", //標題
* "description" => "Description", //描述
* "url" => "URL", //點擊后跳轉的鏈接。可根據url里面帶的code參數校驗員工的真實身份。
* "picurl" => "PIC_URL", //圖文消息的圖片鏈接,支持JPG、PNG格式，較好的效果為大圖640*320，
* //小圖80*80。如不填，在客戶端不顯示圖片
* ),
* )
* ),
*
* "mpnews" => array(
* "articles" => array( //articles 圖文消息，一個圖文消息支持1到10個圖文
* array(
* "title" => "Title", //圖文消息的標題
* "thumb_media_id" => "id", //圖文消息縮略圖的media_id
* "author" => "Author", //圖文消息的作者(可空)
* "content_source_url" => "URL", //圖文消息點擊“閱讀原文”之后的頁面鏈接(可空)
* "content" => "Content" //圖文消息的內容，支持html標簽
* "digest" => "Digest description", //圖文消息的描述
* "show_cover_pic" => "0" //是否顯示封面，1為顯示，0為不顯示(可空)
* ),
* )
* )
* )
* 請查看官方開發文檔中的 發送消息 -> 消息類型及數據格式
*
* @return boolean|array
* 如果對應用或收件人、部門、標簽任何一個無權限，則本次發送失敗；
* 如果收件人、部門或標簽不存在，發送仍然執行，但返回無效的部分。
* {
* "errcode": 0,
* "errmsg": "ok",
* "invaliduser": "UserID1",
* "invalidparty":"PartyID1",
* "invalidtag":"TagID1"
* }
*/
public function sendMessage($data){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_post(self::API_URL_PREFIX.self::MASS_SEND_URL.'access_token='.$this->access_token,self::json_encode($data));
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* 二次驗證
* 企業在開啟二次驗證時，必須填寫企業二次驗證頁面的url。
* 當員工綁定通訊錄中的帳號后，會收到一條圖文消息，
* 引導員工到企業的驗證頁面驗證身份，企業在員工驗證成功后，
* 調用如下接口即可讓員工關注成功。
*
* @param $userid
* @return boolean|array 成功返回結果
* {
* "errcode": 0, //返回碼
* "errmsg": "ok" //對返回碼的文本描述內容
* }
*/
public function authSucc($userid){
if (!$this->access_token && !$this->checkAuth()) return false;
$result = $this->http_get(self::API_URL_PREFIX.self::AUTHSUCC_URL.'access_token='.$this->access_token.'&userid='.$userid);
if ($result)
{
$json = json_decode($result,true);
if (!$json || !empty($json['errcode']) || $json['errcode']!=0) {
$this->errCode = $json['errcode'];
$this->errMsg = $json['errmsg'];
return false;
}
return $json;
}
return false;
}
/**
* oauth 授權跳轉接口
* @param string $callback 回調URI
* @param string $state 重定向后會帶上state參數，企業可以填寫a-zA-Z0-9的參數值
* @return string
*/
public function getOauthRedirect($callback,$state='STATE',$scope='snsapi_base'){
return self::OAUTH_PREFIX.self::OAUTH_AUTHORIZE_URL.'appid='.$this->appid.'&redirect_uri='.urlencode($callback).'&response_type=code&scope='.$scope.'&state='.$state.'#wechat_redirect';
}
}
/**
* PKCS7Encoder class
*
* 提供基于PKCS7算法的加解密接口.
*/
class PKCS7Encoder
{
public static $block_size = 32;
/**
* 對需要加密的明文進行填充補位
* @param $text 需要進行填充補位操作的明文
* @return 補齊明文字符串
*/
function encode($text)
{
$block_size = PKCS7Encoder::$block_size;
$text_length = strlen($text);
//計算需要填充的位數
$amount_to_pad = PKCS7Encoder::$block_size - ($text_length % PKCS7Encoder::$block_size);
if ($amount_to_pad == 0) {
$amount_to_pad = PKCS7Encoder::block_size;
}
//獲得補位所用的字符
$pad_chr = chr($amount_to_pad);
$tmp = "";
for ($index = 0; $index < $amount_to_pad; $index++) {
$tmp .= $pad_chr;
}
return $text . $tmp;
}
/**
* 對解密后的明文進行補位刪除
* @param decrypted 解密后的明文
* @return 刪除填充補位后的明文
*/
function decode($text)
{
$pad = ord(substr($text, -1));
if ($pad < 1 || $pad > PKCS7Encoder::$block_size) {
$pad = 0;
}
return substr($text, 0, (strlen($text) - $pad));
}
}
/**
* Prpcrypt class
*
* 提供接收和推送給公眾平臺消息的加解密接口.
*/
class Prpcrypt
{
public $key;
function Prpcrypt($k)
{
$this->key = base64_decode($k . "=");
}
/**
* 對明文進行加密
* @param string $text 需要加密的明文
* @return string 加密后的密文
*/
public function encrypt($text, $appid)
{
try {
//獲得16位隨機字符串，填充到明文之前
$random = $this->getRandomStr();//"aaaabbbbccccdddd";
$text = $random . pack("N", strlen($text)) . $text . $appid;
// 網絡字節序
$size = mcrypt_get_block_size(MCRYPT_RIJNDAEL_128, MCRYPT_MODE_CBC);
$module = mcrypt_module_open(MCRYPT_RIJNDAEL_128, '', MCRYPT_MODE_CBC, '');
$iv = substr($this->key, 0, 16);
//使用自定義的填充方式對明文進行補位填充
$pkc_encoder = new PKCS7Encoder;
$text = $pkc_encoder->encode($text);
mcrypt_generic_init($module, $this->key, $iv);
//加密
$encrypted = mcrypt_generic($module, $text);
mcrypt_generic_deinit($module);
mcrypt_module_close($module);
//print(base64_encode($encrypted));
//使用BASE64對加密后的字符串進行編碼
return array(ErrorCode::$OK, base64_encode($encrypted));
} catch (Exception $e) {
//print $e;
return array(ErrorCode::$EncryptAESError, null);
}
}
/**
* 對密文進行解密
* @param string $encrypted 需要解密的密文
* @return string 解密得到的明文
*/
public function decrypt($encrypted, $appid)
{
try {
//使用BASE64對需要解密的字符串進行解碼
$ciphertext_dec = base64_decode($encrypted);
$module = mcrypt_module_open(MCRYPT_RIJNDAEL_128, '', MCRYPT_MODE_CBC, '');
$iv = substr($this->key, 0, 16);
mcrypt_generic_init($module, $this->key, $iv);
//解密
$decrypted = mdecrypt_generic($module, $ciphertext_dec);
mcrypt_generic_deinit($module);
mcrypt_module_close($module);
} catch (Exception $e) {
return array(ErrorCode::$DecryptAESError, null);
}
try {
//去除補位字符
$pkc_encoder = new PKCS7Encoder;
$result = $pkc_encoder->decode($decrypted);
//去除16位隨機字符串,網絡字節序和AppId
if (strlen($result) < 16)
return "";
$content = substr($result, 16, strlen($result));
$len_list = unpack("N", substr($content, 0, 4));
$xml_len = $len_list[1];
$xml_content = substr($content, 4, $xml_len);
$from_appid = substr($content, $xml_len + 4);
} catch (Exception $e) {
//print $e;
return array(ErrorCode::$IllegalBuffer, null);
}
if ($from_appid != $appid)
return array(ErrorCode::$ValidateAppidError, null);
return array(0, $xml_content);
}
/**
* 隨機生成16位字符串
* @return string 生成的字符串
*/
function getRandomStr()
{
$str = "";
$str_pol = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcdefghijklmnopqrstuvwxyz";
$max = strlen($str_pol) - 1;
for ($i = 0; $i < 16; $i++) {
$str .= $str_pol[mt_rand(0, $max)];
}
return $str;
}
}
/**
* error code
* 僅用作類內部使用，不用于官方API接口的errCode碼
*/
class ErrorCode
{
public static $OK = 0;
public static $ValidateSignatureError = 40001;
public static $ParseXmlError = 40002;
public static $ComputeSignatureError = 40003;
public static $IllegalAesKey = 40004;
public static $ValidateAppidError = 40005;
public static $EncryptAESError = 40006;
public static $DecryptAESError = 40007;
public static $IllegalBuffer = 40008;
public static $EncodeBase64Error = 40009;
public static $DecodeBase64Error = 40010;
public static $GenReturnXmlError = 40011;
public static $errCode=array(
'0'=>'無問題',
'40001'=>'簽名驗證錯誤',
'40002'=>'xml解析失敗',
'40003'=>'sha加密生成簽名失敗',
'40004'=>'encodingAesKey 非法',
'40005'=>'appid 校驗錯誤',
'40006'=>'aes 加密失敗',
'40007'=>'aes 解密失敗',
'40008'=>'解密后得到的buffer非法',
'40009'=>'base64加密失敗',
'40010'=>'base64解密失敗',
'40011'=>'生成xml失敗',
);
public static function getErrText($err) {
if (isset(self::$errCode[$err])) {
return self::$errCode[$err];
}else {
return false;
};
}
}
總結
以上是生活随笔為你收集整理的git wechat.class.php,wechat-php-sdk/qywechat.class.php at master · gitye/wechat-php-sdk · GitHub的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 大白菜PE里怎么硬盘 大白菜PE如何适配
- 下一篇： 轻博客框架 php,DouPHP轻博客