git-test/core/templatemessage.lib.php

<?php
namespace LaneWeChat\Core;

/**
 * 模板消息接口
 * 此类提供了微信公众号模板消息的相关操作，包括设置行业、获取模板ID和发送模板消息。
 * 模板消息用于公众号向用户发送重要的服务通知，如信用卡刷卡通知、商品购买成功通知等。
 * 不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。
 */
class TemplateMessage {

    /**
     * 设置所属行业
     * 公众号模板消息需要设置所属行业，每月可更改1次所选行业。
     * @param int $industryId1 公众号模板消息所属行业编号，第一个行业编号
     * @param int $industryId2 公众号模板消息所属行业编号，第二个行业编号
     * @return mixed 返回调用结果，通常是一个数组或者JSON字符串
     */
    public static function setIndustry($industryId1, $industryId2) {
        // 构建请求URL，包含access_token
        $queryUrl = 'https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=' . AccessToken::getAccessToken();
        // 设置请求方法为POST
        $queryAction = 'POST';
        // 构建请求数据数组
        $template = array();
        $template['industry_id1'] = "$industryId1";
        $template['industry_id2'] = "$industryId2";
        // 将数组转换为JSON格式
        $template = json_encode($template);
        // 调用Curl类发送请求
        return Curl::callWebServer($queryUrl, $template, $queryAction);
    }

    /**
     * 获得模板ID
     * 从模板库中添加模板，获取模板ID。
     * @param string $templateIdShort 模板库中模板的编号，有“TM**”和“OPENTMTM**”等形式
     * @return mixed 返回调用结果，通常是一个数组或者JSON字符串
     */
    public static function getTemplateId($templateIdShort) {
        // 构建请求URL，包含access_token
        $queryUrl = 'https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=' . AccessToken::getAccessToken();
        // 设置请求方法为POST
        $queryAction = 'POST';
        // 构建请求数据数组
        $template = array();
        $template['template_id_short'] = "$templateIdShort";
        // 将数组转换为JSON格式
        $template = json_encode($template);
        // 调用Curl类发送请求
        return Curl::callWebServer($queryUrl, $template, $queryAction);
    }

    /**
     * 向用户推送模板消息
     * 发送模板消息给指定的用户。
     * @param array $data 模板数据，包含多个键值对，每个键对应模板中的一个参数
     * @param string $touser 接收方的OpenId
     * @param string $templateId 模板Id，在公众平台线上模板库中选用模板获得ID
     * @param string $url 点击模板消息会跳转到的链接
     * @param string $topcolor 顶部颜色，可以为空，默认是红色
     * @return mixed 返回调用结果，通常是一个数组或者JSON字符串
     */
    public static function sendTemplateMessage($data, $touser, $templateId, $url, $topcolor = '#FF0000') {
        // 构建请求URL，包含access_token
        $queryUrl = 'https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=' . AccessToken::getAccessToken();
        // 设置请求方法为POST
        $queryAction = 'POST';
        // 构建请求数据数组
        $template = array();
        $template['touser'] = $touser;
        $template['template_id'] = $templateId;
        $template['url'] = $url;
        $template['topcolor'] = $topcolor;
        $template['data'] = $data;
        // 将数组转换为JSON格式
        $template = json_encode($template);
        // 调用Curl类发送请求
        return Curl::callWebServer($queryUrl, $template, $queryAction);
    }
}
命名空间声明：namespace LaneWeChat\Core; 定义了类的命名空间，表明这个类属于LaneWeChat模块的核心部分。
类定义：class TemplateMessage 定义了一个用于处理微信公众号模板消息的类。
setIndustry方法：设置公众号模板消息所属的行业。需要提供两个行业编号，每月可更改一次。
getTemplateId方法：从模板库中添加模板，获取模板ID。需要提供模板库中的模板编号。
sendTemplateMessage方法：向指定用户发送模板消息。需要提供模板数据、接收方的OpenId、模板ID、跳转链接和顶部颜色。
命名空间声明：namespace LaneWeChat\Core; 定义了类的命名空间，表明这个类属于LaneWeChat模块的核心部分。
类定义：class TemplateMessage 定义了一个用于处理微信公众号模板消息的类。
setIndustry方法：设置公众号模板消息所属的行业。需要提供两个行业编号，每月可更改一次。
getTemplateId方法：从模板库中添加模板，获取模板ID。需要提供模板库中的模板编号。
sendTemplateMessage方法：向指定用户发送模板消息。需要提供模板数据、接收方的OpenId、模板ID、跳转链接和顶部颜色。
命名空间声明：namespace LaneWeChat\Core; 定义了类的命名空间，表明这个类属于LaneWeChat模块的核心部分。
类定义：class TemplateMessage 定义了一个用于处理微信公众号模板消息的类。
setIndustry方法：设置公众号模板消息所属的行业。需要提供两个行业编号，每月可更改一次。
getTemplateId方法：从模板库中添加模板，获取模板ID。需要提供模板库中的模板编号。
sendTemplateMessage方法：向指定用户发送模板消息。需要提供模板数据、接收方的OpenId、模板ID、跳转链接和顶部颜色。
命名空间声明：namespace LaneWeChat\Core; 定义了类的命名空间，表明这个类属于LaneWeChat模块的核心部分。
类定义：class TemplateMessage 定义了一个用于处理微信公众号模板消息的类。
setIndustry方法：设置公众号模板消息所属的行业。需要提供两个行业编号，每月可更改一次。
getTemplateId方法：从模板库中添加模板，获取模板ID。需要提供模板库中的模板编号。
sendTemplateMessage方法：向指定用户发送模板消息。需要提供模板数据、接收方的OpenId、模板ID、跳转链接和顶部颜色。
命名空间声明：namespace LaneWeChat\Core; 定义了类的命名空间，表明这个类属于LaneWeChat模块的核心部分。
类定义：class TemplateMessage 定义了一个用于处理微信公众号模板消息的类。
setIndustry方法：设置公众号模板消息所属的行业。需要提供两个行业编号，每月可更改一次。
getTemplateId方法：从模板库中添加模板，获取模板ID。需要提供模板库中的模板编号。
sendTemplateMessage方法：向指定用户发送模板消息。需要提供模板数据、接收方的OpenId、模板ID、跳转链接和顶部颜色。