微信开发之获取用户详细列表

原创 2017年06月08日 21:31:44

本文目录 :

  1. 获取access_token
  2. 获取用户id列表
  3. 获取单用户详细信息
  4. 综合获取用户详细列表
  5. 代码结构组织

php框架:Thinkphp
主题任务:微信公众平台开发,获取用户详细信息列表。

获取用户详细信息列表,有人会说直接去微信开发文档找到对应的Api不就得了,还有什么东西可写?
首先,微信没有直接提供这样的Api,所以只能将相关的接口进行组合使用。姑且做一下开发记录。


1、 获取access_token

微信开发文档入口:

https://mp.weixin.qq.com/wiki?action=doc&id=mp1421140183

我的代码:

public function getAccessToken()
{
    $wechat = $this->wx_user; //$this->wx_user:已从数据库中取出所需公众号信息
    if (empty($wechat)) {
        $this->setError("公众号不存在!");
        return false;
    }

    //判断是否过了缓存期
    $expire_time = $wechat['web_expires'];
    if($expire_time > time()){
       return $wechat['web_access_token'];
    }

    //调用微信提供的接口获取数据
    $appid = $wechat['appid'];
    $appsecret = $wechat['appsecret'];
    $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={$appid}&secret={$appsecret}";
    $return = httpRequest($url,'GET');
    if (empty($return)) {
        $this->setError("请求失败,获取access_token失败");
        return false;
    }

    $return = json_decode($return, true);
    if (isset($return['errcode']) && $return['errcode'] != 0) {
        $this->setError("get_access_token 错误代码;".$return['errcode']);
        return false;
    }

    //设置过期时间,保存进数据库,下次判断数据库中的时间是否过期,如上面代码所示
    $web_expires = time() + 7000; // 提前200秒过期
    M('wx_user')->where(array('id'=>$wechat['id']))->save(array('web_access_token'=>$return['access_token'],'web_expires'=>$web_expires));
    return $return['access_token'];
}

上面涉及到access_token的过期刷新方案。
因为每次从微信服务器拉取access_token时,之前用的access_token就没用了,也不是立即没用,会有个短暂的过渡期,但这个过渡期基本可以忽略不计。所以,总不能每次都生成新的access_token吧?所以要判断过期时间,在过期之前就只用保存的access_token。

这里面还有一个问题,就是如果很多人同时都在操作这个公众号的api,那么,在过期临界点的时候会有多次拉取新access_token的现象,导致有些先拉取access_token的操作会失败,所以,微信官方建议使用AccessToken中控服务器进行集中获取access_token,所以现在就只有中控服务器拉取access_token,没人跟它竞争,不会出现上述描述的场景,放一下官方建议的解决方案图:

因为项目这里是后台操作,一般只是管理员在操作,上述场景的情况几乎不会出现,所以简单场景应用简单解决方案。


2、 获取用户id列表

微信开发文档入口:

https://mp.weixin.qq.com/wiki?action=doc&id=mp1421140840

我的代码:

public function getFanIdList($next_openid='')
{
    $access_token = $this->getAccessToken();
    if (!$access_token) {
        return false;
    }

    //调用微信提供的接口获取数据
    $url ="https://api.weixin.qq.com/cgi-bin/user/get?access_token={$access_token}&next_openid={$next_openid}";//重头开始拉取,一次最多拉取10000个
    $return = httpRequest($url);
    $list = json_decode($return, true);
    if (isset($list['errcode']) && $list['errcode'] != 0) {
        $this->setError("错误代码:".$list['errcode']);
        return false;
    }
    return $list;
}

获取的数据如下:

//上边返回的$list[]元素:
//total 关注该公众账号的总用户数
//count 拉取的OPENID个数,最大值为10000
//data  列表数据,OPENID的列表
//next_openid   拉取列表的最后一个用户的OPENID
//样本数据:
{"total":2,"count":2,"data":{"openid":["OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}

可以看到,这里只提供了openid,我们要用这个openid去查询相应的粉丝详细信息。
题外话 :
微信目前拉取上述用户列表,一次只能拉取10000个用户。看微信的接口约束手册中,哦,接口约束手册描述接口单日可用最大次数,可以看到,获取单用户的详细信息的最大次数是拉取用户列表的最大次数的10000倍,我想这里的10000倍不是巧合。

约束手册入口:

https://mp.weixin.qq.com/wiki?action=doc&id=mp1433744592


3、 获取单用户详细信息

微信开发文档入口:

https://mp.weixin.qq.com/wiki?action=doc&id=mp1421140839

我的代码:

public function getFanInfo($openid, $access_token=null)
{
    if (null === $access_token) {
        $access_token = $this->getAccessToken();
        if (!$access_token) {
            return false;
        }
    }

    //调用微信提供的接口获取数据
    $url ="https://api.weixin.qq.com/cgi-bin/user/info?access_token={$access_token}&openid={$openid}&lang=zh_CN";
    $return = httpRequest($url);
    $wxdata = json_decode($return, true);
    if (isset($wxdata['errcode']) && $wxdata['errcode'] != 0) {
        $this->setError("错误代码;".$wxdata['errcode']);
        return false;
    }

    $wxdata['sex_name'] = $this->sexName($wxdata['sex']);
    return $wxdata;
}

public function sexName($sex_id)
{
    if ($sex_id == 1) {
        return '男';
    } else if ($sex_id == 2) {
        return '女';
    }
    return '未知';
}

上面返回的数据结构如下:

/* $wxdata[]元素:
 * subscribe    用户是否订阅该公众号标识,值为0时,代表此用户没有关注该公众号,拉取不到其余信息。
 * openid   用户的标识,对当前公众号唯一
 * nickname 用户的昵称
 * sex  用户的性别,值为1时是男性,值为2时是女性,值为0时是未知
 * city 用户所在城市
 * country  用户所在国家
 * province 用户所在省份
 * language 用户的语言,简体中文为zh_CN
 * headimgurl   用户头像,最后一个数值代表正方形头像大小(有0、46、64、96、132数值可选,0代表640*640正方形头像),用户没有头像时该项为空。若用户更换头像,原有头像URL将失效。
 * subscribe_time   用户关注时间,为时间戳。如果用户曾多次关注,则取最后关注时间
 * unionid  只有在用户将公众号绑定到微信开放平台帐号后,才会出现该字段。
 * remark   公众号运营者对粉丝的备注,公众号运营者可在微信公众平台用户管理界面对粉丝添加备注
 * groupid  用户所在的分组ID(兼容旧的用户分组接口)
 * tagid_list   用户被打上的标签ID列表
 */


4、 综合获取用户详细列表

我的代码:

public function fans_list()
{
    $wechatObj = new WechatLogic($this->wx_user);
    $access_token = $wechatObj->getAccessToken();
    if (!$access_token) {
        return $this->error($wechatObj->getError());
    }

    $next_openid = '';
    $p = intval(I('get.p')) ?: 1;
    for ($i = 1; $i <= $p; $i++) {
        $id_list = $wechatObj->getFanIdList($next_openid);
        if ($id_list === false) {
            return $this->error($wechatObj->getError());
        }
        $next_openid = $id_list['next_openid'];
    }

    $user_list = [];
    foreach ($id_list['data']['openid'] as $openid) {
        $user_list[$openid] = $wechatObj->getFanInfo($openid, $access_token);
        if ($user_list[$openid] === false) {
            return $this->error($wechatObj->getError());
        }
        $user_list[$openid]['tags'] = $wechatObj->getFanTagNames($user_list[$openid]['tagid_list']);
        if ($user_list[$openid]['tags'] === false) {
            return $this->error($wechatObj->getError());
        }
    }

    $page  = new Page($id_list['total'], $id_list['count']);
    $show = $page->show();
    $this->assign('pager',$page);
    $this->assign('page',$show);
    $this->assign('user_list', $user_list);
    return $this->fetch();
}

上面代码是有视图输出的,主要提供一种思路。

里边涉及到的其他代码:
涉及到获取公众号的用户标签,文档入口:

https://mp.weixin.qq.com/wiki?action=doc&id=mp1421140837

/**
 * 获取粉丝标签
 * @return type
 */
public function getAllFanTags()
{
    $access_token = $this->getAccessToken();
    if (!$access_token) {
        return false;
    }

    //调用微信提供的接口获取数据
    $url = "https://api.weixin.qq.com/cgi-bin/tags/get?access_token={$access_token}";
    $return = httpRequest($url);
    $wxdata = json_decode($return, true);
    if (isset($wxdata['errcode']) && $wxdata['errcode'] != 0) {
        $this->setError("错误代码;".$wxdata['errcode']);
        return false;
    }

    //$wxdata数据样例:{"tags":[{"id":1,"name":"每天一罐可乐星人","count":0/*此标签下粉丝数*/}, ...]}
    return $wxdata['tags'];
}

/**
 * 获取所有用户标签
 * @return array
 */
public function getAllFanTagsMap()
{
    if ($this->tags_map !== null) {
        return $this->tags_map;
    }

    $user_tags = $this->getAllFanTags();
    if ($user_tags === false) {
        return false;
    }

    $this->tags_map = [];
    foreach ($user_tags as $tag) {
        $this->tags_map[$tag['id']] = $this->tags_map[$tag['name']];
    }
    return $this->tags_map;
}

/**
 * 获取粉丝标签名
 * @param string $tagid_list
 * @param array $tags_map
 * @return array
 */
public function getFanTagNames($tagid_list)
{
    if ($this->tags_map === null) {
        $tags_map = $this->getAllFanTagsMap();
        if ($tags_map === false) {
            return false;
        }
        $this->tags_map = $tags_map;;
    }

    $tag_names = [];
    foreach ($tagid_list as $tag) {
        $tag_names[] = $this->tags_map[$tag];
    }
    return $tag_names;
}


5、 代码结构组织

  1. 因为调用官方接口如果出错,会有错误码和错误信息,可帮助定位问题,为了不浪费这个信息,做了setError()getError()这两个小函数记录,上面已多次使用。
  2. 除了最后的综合使用的业务函数之外,其他都是微信的常规操作,都放在一个微信的常规操作类WechatLogic里边,可以给多个业务使用。


总结
其实只要看看官方的手册,找到自己想要的接口,如果找不到直接的接口,就自己拼凑即可。


主要参考文档

微信开发入门:https://mp.weixin.qq.com/wiki?action=doc&id=mp1472017492_58YV5
微信开发文档:https://mp.weixin.qq.com/wiki

-end-

【系列课】Springmvc4+Mybatis3+Spring4+Bootstrap3之列表

-
  • 1970年01月01日 08:00

微信公众号--获取用户列表

之前其实写过一次微信号的简单开发,包括菜单自动回复拉取用户信息等简单的微信公众号的开发,今天又用到了,然后发现自己还是忘记了,看来记录下来是真的有必要的。我今天主要是写了拉取用户信息,所以我这比写的也...
  • zsal_cwy
  • zsal_cwy
  • 2016-04-18 15:20:06
  • 5958

微信授权获取用户列表

微信授权api:https://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html login页面: $("#wx").o...
  • y670340559
  • y670340559
  • 2017-03-17 16:22:38
  • 196

微信服务号开发-获取用户信息

1、获取用户基本信息(包括UnionID机制) 开发者可通过OpenID来获取用户基本信息。请使用https协议。 接口: http请求方式: GET https://api.weixin...
  • u014520797
  • u014520797
  • 2016-10-07 17:21:16
  • 2393

微信之关于如何获取用户基本信息

关于如何获取微信已关注用户的基本信息,我这里先说一下步骤:那些基本的信息就不多说了,如AppID,AppSecret1、首先成为开发者,需要外网,如果没有外网,建议在花生壳申请一个账号,通过映射,可以...
  • qq__1358521215
  • qq__1358521215
  • 2016-12-23 10:18:13
  • 1404

Java微信公众平台开发之用户管理(用户基本信息和关注列表)

一、用户基本信息 在关注者与公众号产生消息交互后,公众号可获得关注者的OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的。对于不同公众号,同一用户的openid不同)。公众号可通...
  • phil_jing
  • phil_jing
  • 2017-06-08 21:52:07
  • 2784

手把手教你如何获取微信公众号用户的个人信息(包括OpenId)

最近,对微信公众号有点兴趣,就自己研究了研究里面的一些内容,发现还挺有意思的,而且通过微信公众号可以调用一些比较有意思的接口,就比如百度开发服务平台 点击进入 里面的很有接口,就比较常见的翻译,语音识...
  • Cs_hnu_scw
  • Cs_hnu_scw
  • 2018-01-19 10:58:15
  • 4944

微信获取所有关注者信息

前提是你所使用的微信公众号已经有获取用户信息的权限 using System; using System.Collections.Generic; using System.IO; using...
  • for12
  • for12
  • 2016-01-05 17:53:00
  • 952

python-itchat 获取微信群用户信息

import itchat, time from itchat.content import TEXT #name = ' ' roomslist = [] itchat.auto_login(en...
  • localhost1113
  • localhost1113
  • 2018-03-05 10:59:57
  • 494

微信批量获取关注者信息列表php版本

微信批量获取关注者信息列表php版,当时自己开发时搜索不到类似文章,为了让大家节省时间,特此写下本篇内容。...
  • hanzhihuihan
  • hanzhihuihan
  • 2016-12-08 10:01:41
  • 1235
收藏助手
不良信息举报
您举报文章:微信开发之获取用户详细列表
举报原因:
原因补充:

(最多只允许输入30个字)