ThinkPHP如何做微信小程序订阅消息_模板ID配置与推送【教程】

雨晨大大_7769

雨晨大大_7769

2026-06-02

1142人浏览

原创

thinkphp实现微信小程序订阅消息需两步:前端用户主动授权订阅+后端用有效模板id向用户openid推送;模板id须从微信公众平台模板库选用或审核通过,且推送前用户必须调用wx.requestsubscribemessage授权,后端使用easywechat调用subscribe_message->send发送。

thinkphp如何做微信小程序订阅消息_模板id配置与推送【教程】

ThinkPHP 实现微信小程序订阅消息,核心就两步:用户前端主动订阅 + 后端按模板 ID 推送。模板 ID 不是随便写的,必须来自微信官方模板库或审核通过的自定义模板,且每次推送都得带用户明确授权过的 ID。

模板 ID 怎么来?不能自己编

模板 ID 必须从微信公众平台(mp.weixin.qq.com)获取:

  • 登录小程序后台 → 「功能」→「订阅消息」→ 进入模板库
  • 搜索关键词(如“订单通知”“签到提醒”),选中合适模板后点击「选用」,系统自动生成唯一模板 ID
  • 若没有匹配模板,可点击「申请添加新模板」,填写标题、内容、使用场景,提交后等微信审核(通常1–3个工作日)
  • 选用/审核通过后,模板 ID 长这样:6io5lFLo4OEdNjl2_FKxHErBqXv3EF1QRZEm6RMdHLQ,复制保存,后端代码里直接用

前端必须先让用户点“允许”,否则后端推不了

微信强制要求:用户未主动订阅前,后端调用接口必失败。小程序里需调用 wx.requestSubscribeMessage:

  • 在页面 .js 中写(注意传入你拿到的真实模板 ID):


// index.js
handleSubscribe() {
  wx.requestSubscribeMessage({
    tmplIds: ['6io5lFLo4OEdNjl2_FKxHErBqXv3EF1QRZEm6RMdHLQ'],
    success: (res) => {
      if (res['6io5lFLo4OEdNjl2_FKxHErBqXv3EF1QRZEm6RMdHLQ'] === 'accept') {
        wx.showToast({ title: '已同意接收通知', icon: 'success' });
      }
    },
    fail: () => {
      wx.showToast({ title: '未授权,无法发送', icon: 'none' });
    }
  });
}

微信公众号自动发布增强版
微信公众号自动发布增强版

一键发布 Markdown/HTML 文章至微信公众号草稿箱,支持自动配图、排版美化、UTF‑8编码

下载
  • 用户点击“允许”后,该模板 ID 才算被授权;后续后端可用它向这个用户的 openid 推送一次(单次授权仅限一次下发)

后端推送:ThinkPHP + 模板 ID + 用户 openid + access_token

推荐用 EasyWeChat 6.x(兼容 TP5/6/8),配置好小程序 app_id 和 secret 后即可发:

  • 在 config/wechat.php 中填入小程序凭证:

return [
  'mini_program' => [
    'app_id' => 'wxd1234567890abcde',
    'secret' => 'your_miniapp_secret_here',
  ],
];

  • 控制器中推送示例(TP8 写法):

use EasyWeChat\MiniApp\Application;

$app = new Application(config('wechat.mini_program'));
$data = [
  'template_id' => '6io5lFLo4OEdNjl2_FKxHErBqXv3EF1QRZEm6RMdHLQ',
  'touser' => 'o8oTs5AwK3Roma4mwtj6oNE7BIbk', // 用户真实 openid
  'page' => 'pages/order/detail?id=123',
  'data' => [
    'thing1' => ['value' => '订单已支付'],
    'date1' => ['value' => date('Y-m-d H:i')],
    'number1' => ['value' => '¥299.00'],
  ],
];

$app->subscribe_message->send($data);

  • 注意:touser 是用户在当前小程序的 openid,不是 unionid 或公众号 openid
  • 每个模板字段 key(如 thing1)必须与模板库里定义的 keyword 完全一致,大小写敏感

常见报错和避坑点

推送失败多数卡在这几个地方:

  • “errcode: 43101”:用户没点允许,或点了“拒绝”,或授权的模板 ID 和推送时用的不一致
  • “errcode: 40003”:touser 填错了,不是当前小程序的 openid(比如误用了公众号的)
  • “errcode: 41028”:模板 ID 无效,可能已被删除、未审核通过,或不属于当前小程序主体
  • access_token 过期(2小时):EasyWeChat 默认会自动刷新,但若手动拼 URL 调用 API,需确保 token 有效
  • 模板字段 value 值为空字符串或 null:微信校验不通过,建议统一用 ['value' => $val ?: '—'] 防空

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9584

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5761

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2055

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3588

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4274

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3351

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4757

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3722

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11762

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程