微信模板消息是服務號與用戶進行服務通知的重要通道。本文基於 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);
S() 函數,實際項目請替換為項目統一緩存組件。value 建議 urlencode,發送前 urldecode 還原,防止特殊字符導致 JSON 解析異常。errcode 非 0 時可記錄日志並告警,常見錯誤碼:40037 模板 ID 錯誤、43004 需要用戶關注、45009 接口調用超限。curl、openssl、json 擴展。該類封裝了微信模板消息發送的核心邏輯,開箱即用,便於在 ThinkPHP 或其他框架中快速集成。實際部署時請注意 Token 緩存的分布式一致性、異常重試機制及日志監控。