讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

php如何对接小程序订阅消息_php发送订阅消息流程【教程】

轻婷酱_2978

轻婷酱_2978

发布时间:2026-01-29 12:51:33

|

1081人浏览过

|

来源于php中文网

原创

必须缓存 Access Token 并校验过期时间,使用正确订阅消息接口和严格匹配的模板字段,前端需用户主动授权并后端记录状态,同时规范 cURL SSL 和请求头配置。

php如何对接小程序订阅消息_php发送订阅消息流程【教程】

获取 Access Token 不能每次发消息都调一次

微信的 access_token 有效期只有 2 小时,且调用频次受限(每日上限 2000 次),频繁请求会触发限流或返回 {"errcode":40001,"errmsg":"invalid credential"}。所以不能在 sendSubscriptionMessage() 里每次都去拉取。

  • 必须缓存到本地(如 Redis、文件、数据库),并记录过期时间(expires_in 字段)
  • 建议封装成单例或静态方法,在使用前先检查是否已存在且未过期
  • 若用 file_get_contents() 而非 cURL,请确保服务器开启了 allow_url_fopen;否则直接失败,错误不明显

发送接口 URL 和参数名已更新,别套用模板消息代码

小程序订阅消息的正式接口是:https://api.weixin.qq.com/cgi-bin/message/subscribe/send,不是旧模板消息的 /template/send,也不是文档里曾短暂出现过的 /bizsend(该路径已下线,调用会返回 404 或 errcode:48002)。

  • touser、template_id、data 是必填项;page 和 miniprogram_state 是可选但强烈建议填(尤其测试阶段设为 developer)
  • data 里的每个 keyword 必须严格匹配模板中定义的字段名(如 keyword1、thing6),大小写和下划线都不能错,否则整条消息被拒,返回 errcode:41028
  • 不要手动拼接 JSON 字符串,用 json_encode($data, JSON_UNESCAPED_UNICODE) 避免中文乱码导致签名失败

用户没授权就发,100% 失败,且无明确提示

和模板消息不同,订阅消息强制要求用户主动点击授权。后端无法绕过,也**不会**因为“之前授权过”就自动生效——除非你用的是「长期订阅」(目前仅政务、医疗等白名单类目开放,普通小程序只有一次性订阅)。

微信公众号发布器
微信公众号发布器

当用户需要发布微信公众号文章、查看热点、配置公众号参数、生成文章内容或运营公众号时,自动激活此技能。触发词:发公众号、微信推文、草稿箱、AppID、AppSecret、公众号运营、热点文章、wx-publish。

下载
  • 前端必须调用 wx.requestSubscribeMessage({ tmplIds: ['TEMPLATE_ID'] }),且监听 success 回调才可认为授权成功
  • 回调里的 res 是对象,比如 { "TEMPLATE_ID": "accept" },只有值为 accept 才能发;reject 或超时都算失败
  • 后端不要假设 openid 存在就能发,务必在数据库记录该用户对某模板的授权状态(字段如 subscribed_at),否则重试会持续失败

cURL 请求头和 SSL 配置不规范,真机环境常静默失败

很多本地调试成功的代码,部署到 Linux 服务器后发不出消息,常见原因是 SSL 验证失败或 header 缺失。

立即学习“PHP免费学习笔记(深入)”;

  • 必须显式设置 Content-Type: application/json,微信接口对 header 敏感,漏掉就返回 40003(invalid openid)这类误导性错误
  • 生产环境禁用 CURLOPT_SSL_VERIFYPEER => false,应配置好 CA 证书路径(如 curl_setopt($ch, CURLOPT_CAINFO, '/etc/ssl/certs/ca-bundle.crt'))
  • 记得检查服务器时间是否准确——微信校验请求时间戳,误差超过 5 分钟会直接拒绝
微信订阅消息真正难的不是调通接口,而是把「用户授权时机」「token 生命周期管理」「模板字段映射校验」这三个点串成闭环。漏掉任意一环,都会表现为“明明写了代码却收不到”,而且错误信息藏得深、复现不稳定。

热门AI工具

更多
讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2295

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3742

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1236

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4339

2025.09.10

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

3883

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

935

2023.10.30

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

15206

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

1765

2023.09.14

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn