微信分享（WeChatShare）

自定义微信内分享卡片的标题、描述、小图标（缩略图）与链接，同时覆盖：

• 分享给朋友（微信会话）
• 分享到朋友圈（Timeline）

效果预览


左：未处理时的原始链接样式（长标题 + 裸链接 + 默认链接图标）

右：启用本插件后的自定义卡片（自定义标题 + 描述摘要 + 自定义缩略图）

目录结构

WeChatShare/
├── plugin.json                     插件元信息
├── WeChatSharePlugin.php           插件入口（配置项、前台注入）
├── routes.php                      前台签名接口路由
├── controller/Signature.php        签名接口（域名白名单校验）
├── service/WxSdk.php               access_token / jsapi_ticket / SHA1 签名
├── static/
│   ├── jweixin-1.6.0.js            微信 JS-SDK
│   └── wechat-share.js             前台注入脚本
├── icon.svg                        插件图标
└── preview.png                     效果截图

安装

1. 后台 → 应用中心 → 本地插件 → 找到「微信分享」→ 安装（或直接刷新插件列表）。
2. 安装后 static/ 会复制到 public/static/WeChatShare/。
3. 打开「微信分享」的配置页，填写公众号 AppID / AppSecret 并保存。
4. 在微信公众平台完成域名配置（必须，否则 wx.config 会报 invalid signature）：

  - 设置与开发 → 公众号设置 → 功能设置 → JS接口安全域名 → 填写站点域名（不带 http://、不带路径）。

  - 若使用测试号，则在测试号管理页配置「JS接口安全域名」。

  - 同时确认「IP白名单」已加入服务器出口 IP，否则取 access_token 会报 40164。

1. 手机微信打开任意前台页面，右上角「···」查看分享卡片。

配置项

实现原理

1. WeChatSharePlugin::renderAssets() 由布局的 {:pluginassets()} 输出 window.WECHATSHARE_CFG 与 wechat-share.js。
2. 脚本在微信内加载 JS-SDK，POST 当前页面 URL（已去掉 # 片段）到签名接口 wechat-share/signature。
3. 服务端 WxSdk 取 accesstoken（stabletoken 优先，失败回退 cgi-bin/token）→ 取 jsapi_ticket → 按

  jsapi_ticket=..&noncestr=..×tamp=..&url=.. 字典序拼接后 SHA1，返回 appId/timestamp/nonceStr/signature。

  accesstoken 与 jsapiticket 均写入 Cache（有效期减 300 秒），token 失效时自动刷新重试一次。

1. 前台 wx.config 成功后，在 wx.ready 内调用：

  - wx.updateAppMessageShareData({title, desc, link, imgUrl}) —— 分享给朋友

  - wx.updateTimelineShareData({title, link, imgUrl}) —— 分享到朋友圈

  低版本微信回退到 onMenuShareAppMessage / onMenuShareTimeline。

1. 监听 pjax:end / community:pjax / popstate，站内无刷新跳转后重新签名并覆盖新页面的标题与首图。

常见问题

签名报 invalid signature

• 公众号「JS接口安全域名」是否包含当前域名（含 www 区别）。
• 参与签名的 URL 必须与实际访问地址完全一致（含查询参数），且不能带 # 片段；脚本已自动处理。
• AppSecret 是否填错；修改后清一次缓存再试。

config:invalid url domain

• 当前域名不在「JS接口安全域名」内，或填的是带协议/路径的地址。

取 access_token 报 40164 / 61004

• 服务器出口 IP 未加入公众号「IP白名单」。

图片不显示

• 微信要求缩略图可公网访问；data: / blob: 地址会被忽略。
• 建议 300×300 以上，比例接近 1:1 或 4:3。

朋友圈没有描述

• 朋友圈卡片本身只支持标题 + 图片，描述仅「分享给朋友」生效，这是微信限制。

分享链接与当前页不一致

• 检查是否在配置里填了「分享链接」，填写后全站统一使用该地址。