萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 實現發送微信模板消息完整類封裝

前言

微信模板消息是服務號與用戶進行服務通知的重要通道。本文基於 ThinkPHP 框架風格,封裝了一個 OrderPush 類,涵蓋 Access Token 緩存、HTTP 請求封裝、模板消息發送全流程,代碼結構清晰,可直接引入項目使用。

核心類代碼

<?php
namespace Org\Weixin;

class OrderPush {
    protected $appid;
    protected $secret;
    protected $accessToken;

    public function __construct($appid, $secret) {
        $this->appid = $appid;
        $this->secret = $secret;
        $this->accessToken = $this->getToken($appid, $secret);
    }

    // 發送 POST 請求
    protected function request_post($url, $param) {
        if (empty($url) || empty($param)) return false;
        $ch = curl_init();
        curl_setopt_array($ch, [
            CURLOPT_URL => $url,
            CURLOPT_HEADER => 0,
            CURLOPT_RETURNTRANSFER => 1,
            CURLOPT_POST => 1,
            CURLOPT_POSTFIELDS => $param,
        ]);
        $data = curl_exec($ch);
        curl_close($ch);
        return $data;
    }

    // 發送 GET 請求
    protected function request_get($url) {
        if (empty($url)) return false;
        $ch = curl_init();
        curl_setopt_array($ch, [
            CURLOPT_URL => $url,
            CURLOPT_RETURNTRANSFER => 1,
        ]);
        $data = curl_exec($ch);
        curl_close($ch);
        return $data;
    }

    // 獲取 Access Token(含緩存)
    protected function getToken($appid, $appsecret) {
        // 假設 S() 為 ThinkPHP 緩存函數,此處可替換為 Redis、文件等
        if (S($appid)) {
            return S($appid);
        }
        $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$appid&secret=$appsecret";
        $token = $this->request_get($url);
        $arr = json_decode($token, true);
        $access_token = $arr['access_token'] ?? '';
        S($appid, $access_token, 720); // 緩存 7200 秒(微信有效期 2 小時,提前刷新)
        return $access_token;
    }

    // 發送模板消息
    public function doSend($touser, $template_id, $url, $data, $topcolor = '#7B68EE') {
        $template = [
            'touser' => $touser,
            'template_id' => $template_id,
            'url' => $url,
            'topcolor' => $topcolor,
            'data' => $data
        ];
        $json_template = json_encode($template);
        $api_url = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=" . $this->accessToken;
        $res = $this->request_post($api_url, urldecode($json_template));
        $res = json_decode($res, true);
        return isset($res['errcode']) && $res['errcode'] == 0;
    }
}
?>

數據結構示例

$data = [
    'first' => ['value' => urlencode('您好,您已購買成功'), 'color' => '#743A3A'],
    'name' => ['value' => urlencode('商品信息:微時代電影票'), 'color' => '#EEEEEE'],
    'remark' => ['value' => urlencode('永久有效!密碼為:1231313'), 'color' => '#FFFFFF'],
];

使用方式

<?php
$push = new \Org\Weixin\OrderPush('your_appid', 'your_secret');
$ok = $push->doSend(
    'OPENID',
    'TEMPLATE_ID',
    'https://example.com/detail',
    $data
);
var_dump($ok);

關鍵點提示

  • Token 緩存:避免頻繁請求接口導致封禁,此處用 ThinkPHP S() 函數,實際項目請替換為項目統一緩存組件。
  • URL 編碼:模板數據中的 value 建議 urlencode,發送前 urldecode 還原,防止特殊字符導致 JSON 解析異常。
  • 錯誤處理:返回 errcode 非 0 時可記錄日志並告警,常見錯誤碼:40037 模板 ID 錯誤、43004 需要用戶關注、45009 接口調用超限。
  • 依賴擴展:服務器需安裝 curl、openssl、json 擴展。

總結

該類封裝了微信模板消息發送的核心邏輯,開箱即用,便於在 ThinkPHP 或其他框架中快速集成。實際部署時請注意 Token 緩存的分布式一致性、異常重試機制及日志監控。

copyright © 萬盛學電腦網 all rights reserved