在小程序中获取用户微信公众号的 OpenID 并发送模板消息的完整教程 | 使用 PHP + EasyWeChat 实现

在微信生态中，微信公众号和小程序的联动能够提供更好的用户体验和更丰富的功能。本文将详细讲解如何在小程序内获取用户的微信公众号 OpenID，并使用 PHP + EasyWeChat 实现发送模板消息的功能。

前提条件

在开始之前，需要确保以下条件已经满足：

1. 小程序和公众号已完成关联：确保你的公众号和小程序在微信公众平台上已完成关联。
2. 用户已关注公众号：用户需要先关注你的微信公众号，才能获取其在公众号中的 OpenID。
3. 配置网页授权域名：在微信公众号后台设置允许的小程序的网页授权域名。

实现步骤

整个流程分为三个主要部分：

1. 生成授权链接
2. 在小程序中获取 OpenID
3. 发送微信公众号模板消息

1. 生成授权链接

首先，我们需要生成一个微信公众号的网页授权链接。用户点击链接后，会跳转到一个微信授权页面，用户授权后，微信服务器会返回用户的 OpenID。

PHP 后端接口实现

使用 PHP 和 EasyWeChat 来生成授权链接。

<?php

use EasyWeChat\Factory;

$config = [
    'app_id' => 'your_app_id',  // 公众号的AppID
    'secret' => 'your_secret',  // 公众号的AppSecret
    'token' => 'your_token',    // 公众号的Token
    'aes_key' => 'your_aes_key' // 公众号的消息加解密密钥
];

$app = Factory::officialAccount($config);

// 生成授权链接
function generateAuthorizeUrl($redirectUrl) {
    global $app;
    $response = $app->oauth->scopes(['snsapi_base'])->redirect($redirectUrl);
    return $response->getTargetUrl();
}

// 示例：生成授权链接并返回给小程序
$redirectUrl = 'https://yourdomain.com/callback'; // 替换为你自己的回调URL
echo json_encode(['url' => generateAuthorizeUrl($redirectUrl)]);

在这个例子中，我们使用 EasyWeChat 的 OAuth 模块生成一个授权链接，并将该链接返回给前端的小程序。

2. 在小程序中获取 OpenID

接下来，我们需要在小程序中使用 web-view 组件访问生成的授权链接，并获取用户的 OpenID。

小程序端实现

1、创建授权页面

首先，在小程序中创建一个包含 web-view 组件的页面。例如 authorize.wxml：

<web-view src="{{authorizeUrl}}" bindmessage="handleMessage"></web-view>

2、设置授权链接

在相应的 JS 文件中（authorize.js），获取授权链接并设置 web-view 的 src 属性：

Page({
  data: {
    authorizeUrl: ''
  },
  onLoad() {
    wx.request({
      url: 'https://yourbackend.com/getAuthorizeUrl',  // 替换为你的后端接口地址
      method: 'GET',
      success: (res) => {
        if (res.data && res.data.url) {
          this.setData({ authorizeUrl: res.data.url });
        }
      }
    });
  },
  handleMessage(event) {
    const { openid } = event.detail.data[0];
    if (openid) {
      // 成功获取到OpenID，进行后续操作
      console.log('用户OpenID:', openid);
      wx.showToast({
        title: '授权成功',
        icon: 'success'
      });
    } else {
      wx.showToast({
        title: '授权失败',
        icon: 'none'
      });
    }
  }
});

3、回调接口处理

在后端处理授权回调请求，并将 OpenID 传回小程序。修改 PHP 代码，增加回调接口：

// OAuth回调处理
function handleCallback() {
    global $app;
    $user = $app->oauth->user(); // 获取授权用户信息
    $openid = $user->getId(); // 获取用户OpenID

    // 此处可以进行用户绑定操作
    // ...

    echo '<script>window.parent.postMessage({ openid: "' . $openid . '" }, "*");</script>';
}

if (isset($_GET['code'])) {
    handleCallback();
}

3. 发送微信公众号模板消息

用户授权成功并获取到 OpenID 后，可以使用这个 OpenID 给用户发送模板消息。

发送模板消息的 PHP 实现

使用 EasyWeChat 的模板消息模块来实现消息发送。

function sendTemplateMessage($openid, $templateId, $data, $url = '') {
    global $app;
    $result = $app->template_message->send([
        'touser' => $openid,
        'template_id' => $templateId,
        'url' => $url,
        'data' => $data
    ]);

    return $result;
}

// 示例：发送模板消息
$openid = 'user_openid';  // 替换为实际获取到的OpenID
$templateId = 'template_id';  // 替换为实际的模板ID
$data = [
    'first' => '您有一条新的通知',
    'keyword1' => '通知内容',
    'keyword2' => '更多信息',
    'remark' => '感谢您的使用'
];
$result = sendTemplateMessage($openid, $templateId, $data);

if ($result['errcode'] == 0) {
    echo '模板消息发送成功';
} else {
    echo '模板消息发送失败，错误代码：' . $result['errmsg'];
}

总结

通过以上步骤，我们实现了在小程序中获取用户的微信公众号 OpenID，并成功发送模板消息。这个流程确保了用户体验的流畅性，并可以根据业务需求进一步扩展。需要注意的是，微信的接口和政策可能会更新，开发过程中请关注微信官方的最新文档和政策变化。