147 lines
5.1 KiB
PHP
147 lines
5.1 KiB
PHP
|
<?php
|
|||
|
|
|||
|
// +----------------------------------------------------------------------
|
|||
|
// | WeChatDeveloper
|
|||
|
// +----------------------------------------------------------------------
|
|||
|
// | 版权所有 2014~2022 广州楚才信息科技有限公司 [ http://www.cuci.cc ]
|
|||
|
// +----------------------------------------------------------------------
|
|||
|
// | 官方网站: https://thinkadmin.top
|
|||
|
// +----------------------------------------------------------------------
|
|||
|
// | 开源协议 ( https://mit-license.org )
|
|||
|
// +----------------------------------------------------------------------
|
|||
|
// | github开源项目:https://github.com/zoujingli/WeChatDeveloper
|
|||
|
// +----------------------------------------------------------------------
|
|||
|
|
|||
|
namespace WeChat;
|
|||
|
|
|||
|
use WeChat\Contracts\BasicWeChat;
|
|||
|
|
|||
|
/**
|
|||
|
* 微信粉丝管理
|
|||
|
* Class User
|
|||
|
* @package WeChat
|
|||
|
*/
|
|||
|
class User extends BasicWeChat
|
|||
|
{
|
|||
|
|
|||
|
/**
|
|||
|
* 设置用户备注名
|
|||
|
* @param string $openid
|
|||
|
* @param string $remark
|
|||
|
* @return array
|
|||
|
* @throws Exceptions\InvalidResponseException
|
|||
|
* @throws \WeChat\Exceptions\LocalCacheException
|
|||
|
*/
|
|||
|
public function updateMark($openid, $remark)
|
|||
|
{
|
|||
|
$url = 'https://api.weixin.qq.com/cgi-bin/user/info/updateremark?access_token=ACCESS_TOKEN';
|
|||
|
$this->registerApi($url, __FUNCTION__, func_get_args());
|
|||
|
return $this->httpPostForJson($url, ['openid' => $openid, 'remark' => $remark]);
|
|||
|
}
|
|||
|
|
|||
|
/**
|
|||
|
* 获取用户基本信息(包括UnionID机制)
|
|||
|
* @param string $openid
|
|||
|
* @param string $lang
|
|||
|
* @return array
|
|||
|
* @throws Exceptions\InvalidResponseException
|
|||
|
* @throws Exceptions\LocalCacheException
|
|||
|
*/
|
|||
|
public function getUserInfo($openid, $lang = 'zh_CN')
|
|||
|
{
|
|||
|
$url = "https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid={$openid}&lang={$lang}";
|
|||
|
$this->registerApi($url, __FUNCTION__, func_get_args());
|
|||
|
return $this->httpGetForJson($url);
|
|||
|
}
|
|||
|
|
|||
|
/**
|
|||
|
* 批量获取用户基本信息
|
|||
|
* @param array $openids
|
|||
|
* @param string $lang
|
|||
|
* @return array
|
|||
|
* @throws Exceptions\InvalidResponseException
|
|||
|
* @throws Exceptions\LocalCacheException
|
|||
|
*/
|
|||
|
public function getBatchUserInfo(array $openids, $lang = 'zh_CN')
|
|||
|
{
|
|||
|
$url = 'https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=ACCESS_TOKEN';
|
|||
|
$data = ['user_list' => []];
|
|||
|
foreach ($openids as $openid) {
|
|||
|
$data['user_list'][] = ['openid' => $openid, 'lang' => $lang];
|
|||
|
}
|
|||
|
$this->registerApi($url, __FUNCTION__, func_get_args());
|
|||
|
return $this->httpPostForJson($url, $data);
|
|||
|
}
|
|||
|
|
|||
|
/**
|
|||
|
* 获取用户列表
|
|||
|
* @param string $next_openid
|
|||
|
* @return array
|
|||
|
* @throws Exceptions\InvalidResponseException
|
|||
|
* @throws Exceptions\LocalCacheException
|
|||
|
*/
|
|||
|
public function getUserList($next_openid = '')
|
|||
|
{
|
|||
|
$url = "https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid={$next_openid}";
|
|||
|
$this->registerApi($url, __FUNCTION__, func_get_args());
|
|||
|
return $this->httpGetForJson($url);
|
|||
|
}
|
|||
|
|
|||
|
/**
|
|||
|
* 获取标签下粉丝列表
|
|||
|
* @param integer $tagid 标签ID
|
|||
|
* @param string $next_openid 第一个拉取的OPENID
|
|||
|
* @return array
|
|||
|
* @throws Exceptions\InvalidResponseException
|
|||
|
* @throws Exceptions\LocalCacheException
|
|||
|
*/
|
|||
|
public function getUserListByTag($tagid, $next_openid = '')
|
|||
|
{
|
|||
|
$url = 'https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token=ACCESS_TOKEN';
|
|||
|
$this->registerApi($url, __FUNCTION__, func_get_args());
|
|||
|
return $this->httpPostForJson($url, ['tagid' => $tagid, 'next_openid' => $next_openid]);
|
|||
|
}
|
|||
|
|
|||
|
/**
|
|||
|
* 获取公众号的黑名单列表
|
|||
|
* @param string $begin_openid
|
|||
|
* @return array
|
|||
|
* @throws Exceptions\InvalidResponseException
|
|||
|
* @throws Exceptions\LocalCacheException
|
|||
|
*/
|
|||
|
public function getBlackList($begin_openid = '')
|
|||
|
{
|
|||
|
$url = "https://api.weixin.qq.com/cgi-bin/tags/members/getblacklist?access_token=ACCESS_TOKEN";
|
|||
|
$this->registerApi($url, __FUNCTION__, func_get_args());
|
|||
|
return $this->httpPostForJson($url, ['begin_openid' => $begin_openid]);
|
|||
|
}
|
|||
|
|
|||
|
/**
|
|||
|
* 批量拉黑用户
|
|||
|
* @param array $openids
|
|||
|
* @return array
|
|||
|
* @throws Exceptions\InvalidResponseException
|
|||
|
* @throws Exceptions\LocalCacheException
|
|||
|
*/
|
|||
|
public function batchBlackList(array $openids)
|
|||
|
{
|
|||
|
$url = "https://api.weixin.qq.com/cgi-bin/tags/members/batchblacklist?access_token=ACCESS_TOKEN";
|
|||
|
$this->registerApi($url, __FUNCTION__, func_get_args());
|
|||
|
return $this->httpPostForJson($url, ['openid_list' => $openids]);
|
|||
|
}
|
|||
|
|
|||
|
/**
|
|||
|
* 批量取消拉黑用户
|
|||
|
* @param array $openids
|
|||
|
* @return array
|
|||
|
* @throws Exceptions\InvalidResponseException
|
|||
|
* @throws Exceptions\LocalCacheException
|
|||
|
*/
|
|||
|
public function batchUnblackList(array $openids)
|
|||
|
{
|
|||
|
$url = "https://api.weixin.qq.com/cgi-bin/tags/members/batchunblacklist?access_token=ACCESS_TOKEN";
|
|||
|
$this->registerApi($url, __FUNCTION__, func_get_args());
|
|||
|
return $this->httpPostForJson($url, ['openid_list' => $openids]);
|
|||
|
}
|
|||
|
|
|||
|
}
|