微信公众号开发 php微信公众号开发，开发什么？备忘。。php微信公众号开发教程
2022-07-26
这太令人沮丧和难以理解。也太坑了。
以下是这几天微信公众号相关工作的总结。不全面，只是作为初学者的记录，仅供参考。
一、微信公众号开发，开发什么？
公众号不同于小程序。小程序类似于手机APP，是独立开发的。微信只提供入口；而公众号基本在微信框架内。微信公众号本质上是用户的一个联系人，但只是一个特殊的联系人。通过微信提供的公众号管理后台，无需任何编程，即可快速搭建像样的公众号，菜单、机器人客服、文章更新一应俱全。
但是小程序开发，如果你想要更多的权力，你需要开发它。比如机器人客服。通过公众号管理后台网站模板，可以定义一些自动回复语句，但毕竟还不够智能。这时候，我们可以在互联网上搭建一个服务器，提供相应的服务。当然，这需要准备好URL和域名。
第二，菜单。点击公众号的菜单项后，可以回复一些消息，跳转到小程序，或者打开网页。如果打开网页，如果是未经验证的公众号，则只能打开公众号内的素材，或当前公众号已发表的文章、图片、视频等；和经过验证的公众号，可以直接打开任意网址。这些网页通常是部署在互联网上的所谓微信网页。他们使用微信JS-SDK，上面有各种微信元素，比如扫描、分享到朋友圈等等。当然，这部分需要开发。
并向关注者发送消息。我认为这是微信公众号最大的卖点。比如我关注了某个公众号，通过这个公众号的菜单打开相关小程序做事，当事情进展的时候，系统可以通过这个公众号给我发消息提醒我目前的工作进展。我认为这是公众号开发中最有价值的工作。
当然，也有可以在公众号上自动发布文章的程序。不过这种事情也可以在公众号管理后台手动完成，无非就是动手。
二、发展铺垫
在开发之前，有必要了解相关规范。建议同时阅读开发文档的开头：微信公众平台开发概述
1、公众号分类
衣着三色，食分五品。所谓微信公众号分为订阅号和服务号。个人只能申请订阅号，企业可以申请订阅号和服务号。然后公众号分为认证和未认证。公众号的类型，是否经过认证，决定了是否可以调用很多微信服务。没有认证，基本没什么玩的。而且很遗憾，个人申请的订阅号根本无法通过微信认证，直接挡住了门。
如何开发它？微信还非常“贴心”地提供了测试号机制。不用申请公众号，我们可以先申请一个测试号，用这个号来测试微信服务接口。测试号所有微信服务接口均可访问。当然是鹅！和微信网页一样，需要在手机上运行才能看到效果，如果使用测试号，有些东西是无法渲染的。比如所谓的微信开放标签（即微信定义的标签，类似于HTML）。
订阅帐号和服务帐号的侧重点不同。据我了解，订阅号侧重于发布文章，而服务号侧重于发送有针对性的通知。一般来说，服务帐户比订阅帐户更强大。
从表面上看，订阅号每天可以发送 1 条消息微信公众号开发 php，而服务号每月只能发送 4 条消息，订阅号更强。问题是，群发消息有什么用？当我们在网上做事时，我们想要的是对我来说是新闻。只有服务帐号可以发送此有针对性的通知消息。
在文档中，这种类型的消息称为模板消息。为什么叫模板消息？这是因为这种消息是结合模板生成的。就像我们的手机短信一样。做过手机短信开发的都知道，手机短信是不能随便发的。因为众所周知的原因，肯定有所谓的模板，就是怕内容不合法，内容离谱，也就是短信的格式是固定的，而且很多字也是固定的，我们只需要填写每次我们发送它时都会包含一些内容。此模板必须事先创建并获得电信运营商的批准。微信消息也使用模板。调用发送接口时，需要将模板ID作为参数传递。
目前小程序的模板消息功能已经废弃，取而代之的是所谓的“统一服务消息”，实际上是通过服务号发送的。也就是说，小程序要给用户发送通知，就必须对应一个服务号。
但世界上还有一种叫做订阅消息的东西。公众号叫订阅通知，小程序叫订阅消息。有两种类型：一次性和长期。订阅消息需要用户主动订阅。例如，使用麦当劳小程序点餐时，每次付款后，都会询问您是否接受取餐通知。长期只对部分民生和医院公众账号开放。这是在申请公共帐户时给出的。不要冒险微信公众号开发 php，低估微信折腾人的能力。否则发送时对方永远收不到，也可能没有错误信息；
模板消息和订阅消息有什么区别？订阅新闻不仅仅是要求用户手动订阅，也没什么。问题是，这必须用手机来完成。如果我通过 PC 做事并想在手机上接收提醒怎么办？订阅新闻已完成。
2、公众号调试工具
是微信开发者工具。请注意，它是开发人员工具，而不是开发工具。这个工具确实是小程序的开发工具；对于公众号，它只是一个调试工具，无法通过它输入任何代码；它只是微信网页的调试工具。此时它只是一个微信浏览器。方法是在微信开发者工具顶部输入微信网页地址进行浏览调试，类似普通浏览器按F12。
3、查看微信网页运行结果
公众号可以通过微信客户端查看。这里所说的查看结果是指查看微信网页的运行结果。虽然有“网页”二字，但这不是一个普通的网页。可以用普通浏览器访问，虽然没有报错，但是看不到效果。它应该通过微信浏览器或微信开发者工具运行。需要注意的是，手机上没有微信浏览器这个app，是微信暗示的。如何召唤它？你可以把微信网页的地址发给微信上的朋友，比如“文件传输助手”，然后在聊天记录里点击这个网址，就会用微信浏览器打开。绝对给力的是微信浏览器，QQ浏览器不好用。
4、开发文档
基于微信进行二次开发，上网查资料基本没用。最好老老实实阅读微信官方开发文档。
在公众号管理后台-设置与开发-开发者工具-开发文档中打开公众号开发文档。
微信有两个平台，小程序叫“微信开发开放平台”，公众号叫“微信开发公共平台”。
5、一些术语
1）管理员和操作员
在开发过程中，不可避免地会访问微信公众号管理后台修改或设置一些设置，但要更改设置，必须扫描二维码进行身份认证。这很尴尬。申请公众号的人是管理员，但不一定参与开发。提醒大老板扫描二维码会很不方便，甚至是不可能的。您可以将开发人员添加到操作员列表并自行扫描代码。运营商分为长期和短期两种。他们应该是具有足够权限的长期运营商。
可以在微信公众号管理后台-设置与开发-人事设置中设置。
2）IP 白名单
在开发过程中，我们需要访问微信服务器，比如采集。发出请求的 IP 需要在白名单中。这个IP是指互联网IP。如果我们在腾云网内部开发，那么这个IP就是腾云网的IP，用于上网。问题是，这个IP经常变化。不知道有什么好办法，所以基本上一天换一次白名单。
IP白名单是供我们在本地调试微信开发者工具的。无需手机操作。
3）开发者微信
官方账号管理后台-设置与开发-web开发者工具，添加我们开发者的微信账号。这是用来开发微信网页的。因为微信开发者工具需要微信登录。
4）JS接口安全域名
公众号管理后台-设置与开发-公众号设置-功能设置。
微信网页开发也需要它。我们的页面需要放在这个域名下，才能使用微信的js-sdk。
填写这个域名时，需要下载一个txt文件放在域名下，微信可以验证域名的真实性后再保存。但是填完之后，我们在本地开发的时候，可以修改host文件，把本地ip映射到域名。毕竟是前端的东西。 js-sdk本身需要微信浏览器的支持，它无法判断请求来自哪个IP，我们传给它什么都会相信。
5）微信打开标签
类似于HTML，微信独有的标签。比如
跳转小程序：<wx-open-launch-weapp>
跳转App：<wx-open-launch-app>
服务号订阅通知：<wx-open-subscribe>
音频播放：<wx-open-audio>
三、微信网页开发
1、概览
微信网页其实就是网页，只不过它引用了微信提供的JS库，可能会使用微信独有的所谓开放标签，类似于html。而这个微信网页似乎是在一个普通的浏览器上运行的。虽然不会报错，但似乎没有任何作用。只能在微信浏览器或微信开发者工具上运行。
以下是微信网页（boot下，合并）
DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<title>wechattitle>
<script type="text/javascript" src="http://res.wx.qq.com/open/js/jweixin-1.6.0.js">script>
<script src="./libs/jquery.min.js">script>
<style>
.sao{
text-align: center;width: 100%;height:5.5em;background-color: #ddd;line-height: 5.5em;
cursor:pointer;
}
.block{
height: 100px;
border:solid 1px red;
}
style>
head>
<body>
<div class="sao qr_btn">扫一扫div>
<div class="block">
<wx-open-subscribe th:template="${template}" id="subscribe-btn">
<script type="text/wxtag-template" slot="style">
<style>
.subscribe-btn {
color: #fff;
background-color: #07c160;
}
</style>
script>
<script type="text/wxtag-template">
<button class="subscribe-btn">
模版消息订阅
</button>
script>
wx-open-subscribe>
div>
body>
<script th:inline="javascript">
//微信验证
wx.config({
debug: true,
appId: /*[[${wc.appId}]]*/'',
timestamp: /*[[${wc.timestamp}]]*/'',
nonceStr: /*[[${wc.nonceStr}]]*/'',//随机串
signature: /*[[${wc.signature}]]*/'',
jsApiList: ['chooseImage','scanQRCode','updateAppMessageShareData','updateTimelineShareData'],//需要使用的微信js-sdk函数列表
openTagList: ['wx-open-subscribe']//开放标签列表
});
wx.ready(function () {
// 微信分享 -- 分享给朋友
wx.updateAppMessageShareData({
title: '分享给您的猪朋狗友吧',
desc: '独食难肥',
link: location.href.split('#')[0],
imgUrl: "http://test.duduchuhai.com/images/share.png",
success: function(res) {
console.log(res);
}
});
// 微信分享 -- 分享到朋友圈
wx.updateTimelineShareData({
title: '分享到猪圈',
link: location.href.split('#')[0],
imgUrl: "http://test.duduchuhai.com/images/share.png",
success: function(res) {
console.log(res);
}
});
});
wx.error(function (res) {
console.log(res); // res为微信返回的错误结果
});
// 微信扫一扫
$(".qr_btn").on('click', function() {
wx.scanQRCode({
needResult: 0, // 默认为0，扫描结果由微信处理，1则直接返回扫描结果，
scanType: ["qrCode","barCode"], // 可以指定扫二维码还是一维码，默认二者都有
success: function (res) {
var result = res.resultStr; // 当needResult 为 1 时，扫码返回的结果
}
});
});
script>
<script>
var btn = document.getElementById('subscribe-btn');
console.log(btn);
btn.addEventListener('success', function (e) {
console.log('success', e.detail);
});
btn.addEventListener('error',function (e) {
console.log('fail', e.detail);
});
script>
html>
2、验证
微信网页在运行时，必须先通过微信验证，然后才能正常使用微信的各种功能。验证过程是，
1）访问微信服务器获取
2）访问微信服务器
3）使用、随机字符串、时间戳、当前页面地址依次组成一个字符串，然后对该字符串进行sha hash运算得到摘要
4）使用摘要访问微信服务器获取签名
5）注册、时间戳、随机字符串、签名、本页面使用的微信功能、微信打开标签到微信
在上面的例子中，
wx.config({
debug: true,
appId: /*[[${wc.appId}]]*/'',
timestamp: /*[[${wc.timestamp}]]*/'',//注意是秒，不是毫秒
nonceStr: /*[[${wc.nonceStr}]]*/'',//随机串
signature: /*[[${wc.signature}]]*/'',//关键所在
jsApiList: ['chooseImage','scanQRCode','updateAppMessageShareData','updateTimelineShareData'],//需要使用的微信js-sdk函数列表
openTagList: ['wx-open-subscribe']//开放标签列表
});
获取这个json对象并不容易。可以在微信公众号管理后台获取，每个公众号都有唯一的；时间戳也很容易获得；随机字符串由自己决定，比较容易；最麻烦的是这个签名，我调试了一天左右，总的意思是非法签名。
获取这个json对象的java代码：
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import redis.clients.jedis.Jedis;
import javax.annotation.PostConstruct;
import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLConnection;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Date;
import java.util.Random;
import java.util.concurrent.locks.ReentrantLock;
@Service
public class WxServiceImpl implements WxService {
@Override
public WxConfig getWxConfig(String url) {//url是微信网页地址
WxConfig wc = new WxConfig();//这个是自定义的对象，不必深究
wc.setAppId(APPID);
wc.setNonceStr(getNonceStr());//随机串
wc.setTimestamp((long) (new Date()).getTime() / 1000);//时间戳
wc.setSignature(getSignature(wc.getNonceStr(), wc.getTimestamp(), url));//签名
return wc;
}
@PostConstruct
void init() {
/*
由于从微信服务器获取token和ticket的函数有调用次数限制（每天<=2000），因此用redis将它们缓存起来
*/
this.jedis = new Jedis(redis的IP, redis端口号);
}
private String getSignature(String nonceStr, long timestamp, String url) {//获取签名
String signature = null;
String ticket = getTicket();
if (ticket != null) {
String string1 = String.format("jsapi_ticket=%s&noncestr=%s×tamp=%d&url=%s",
ticket,
nonceStr,
timestamp,
url);
signature = getSha1(string1);
}
return signature;
}
//redis对象
private Jedis jedis;
//除了redis缓存，也用静态变量保存一份。不过，应用程序重启它们就消失了，并且不会自动过期
//而从微信获取到的token和ticket有效期是7200秒
private String _ticket = null;
private String _token = null;
//锁。为避免并发，使用锁机制，不要大家都去获取token和ticket
private ReentrantLock lockTok = new ReentrantLock();
private ReentrantLock lockTik = new ReentrantLock();
private String getTicket() {
String ticket = null;
String key = "ticket";
ticket = getKey(key, this._ticket);
if (ticket == null) {
//锁定。
lockTik.lock();
ticket = getKey(key, this._ticket);//再努力一把
if (ticket == null) {
String token = getToken();
if (token != null) {
ticket = callGet(String.format("https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=%s&type=jsapi",
token), "ticket");
if (ticket != null) {
this._ticket = ticket;
setKey(key, ticket);
}
}
}
//解锁
lockTik.unlock();
}
return ticket;
}
private String getToken() {
String token = null;
String key = "token";
token = getKey(key, this._token);
if (token == null) {
lockTok.lock();
token = getKey(key, this._token);
if (token == null) {
token = callGet(String.format("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=%s&secret=%s",APPID,AppSecret),
"access_token");
if (token != null) {
this._token = token;
setKey(key, token);
}
}
lockTok.unlock();
}
return token;
}
final static int EXPIRTED = 7200;
private String getKey(String key, String v) {
String value = null;
try {
value = jedis.get(key);
} catch (Exception ex) {
value = v;//如果无法从redis中读取则将候补变量值返回。但变量值可能有过期的问题
System.err.println(ex.getMessage());
}
return value;
}
private void setKey(String key, String value) {
try {
jedis.set(key, value);
jedis.expire(key, EXPIRTED);
} catch (Exception ex) {
System.err.println(ex.getMessage());
}
}
final static int NONCESTR = 16;//随机串的长度为16。这个数值是自己定的
private String getNonceStr() {// 生成随机字符串noncestr
String chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
StringBuffer noncestr = new StringBuffer();
int limit = chars.length() - 1;
for (int i = 0; i < NONCESTR; i++) {
Random r = new Random();
int j = r.nextInt(limit);
noncestr.append(chars.substring(j, j + 1));
}
return noncestr.toString();
}
private static String getSha1(String string1) {
MessageDigest sha = null; // 此处的sha代表sha1
try {
sha = MessageDigest.getInstance("SHA");
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
}
byte[] md5Bytes = new byte[0];
try {
md5Bytes = sha.digest(string1.getBytes("UTF-8"));
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
StringBuffer hexValue = new StringBuffer();
for (int i = 0; i < md5Bytes.length; i++) {
int val = ((int) md5Bytes[i]) & 0xff;
if (val < 16) {
hexValue.append("0");
}
hexValue.append(Integer.toHexString(val));
}
return hexValue.toString();
}
public static String callGet(String api, String key) {//get的方式访问微信api
String re = null;
System.out.println(String.format("正在获取 %s : %s", key, api));
try {
URL url = new URL(api);
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.connect();
BufferedReader br = new BufferedReader(
new InputStreamReader(connection.getInputStream(), "UTF-8"));
String line;
StringBuilder sb = new StringBuilder();
while ((line = br.readLine()) != null) {
sb.append(line);
}
br.close();
connection.disconnect();
JSONObject json = JSON.parseObject(sb.toString());
if (json.containsKey(key)) {
re = json.getString(key);
}
System.out.println(re);
} catch (Exception ex) {
ex.printStackTrace();
System.out.println(String.format("访问接口%s失败", api));
}
return re;
}
}
3、调试
在微信开发者工具上，输入微信网页地址，运行，得到很多提示。对于微信公众号来说，微信开发者工具是一个调试工具，一个开启调试模式的浏览器。但一开始，它总是失败。现在，我在示例中声明需要使用以下微信功能：
wx.config({
debug: true,
appId: /*[[${wc.appId}]]*/'',
timestamp: /*[[${wc.timestamp}]]*/'',//注意是秒，不是毫秒
nonceStr: /*[[${wc.nonceStr}]]*/'',//随机串
signature: /*[[${wc.signature}]]*/'',//关键所在
jsApiList: ['chooseImage','scanQRCode','updateAppMessageShareData','updateTimelineShareData'],//需要使用的微信js-sdk函数列表
openTagList: ['wx-open-subscribe']//开放标签列表
});
结果从返回的信息来看，我能访问的函数是0。除此之外，到处都是“失败，就是”之类的提示。
开启微信开发者工具的调试模式：在微信开发者工具中，顶部菜单“微信开发者工具”-调试-“调试微信开发者工具”-，看这个的返回信息？_r=... , 结果是 { : , : " "}!
签名算法有问题吗？在微信公众号管理后台，我使用了他们提供的微信JS接口签名验证工具，结果完全一致，所以不存在算法错误的问题。
4、填坑
后来发现是网址有问题。在生成签名的过程中，需要传递当前微信网页的URL参与构造字符串，然后对字符串进行哈希处理，传递给微信服务器获取签名。问题是，这个URL应该怎么写？由于我的微信页面名为.html，所以我在访问的时候一般在浏览器上输入地址是这样的： 所以我也用这个地址参与了签名的构建，结果总是提示签名是无效的。后来把地址全写了：，一下子就OK了。
但是官方开发文档里写的是什么呢？
不认真复习问题会害死人。
