|
|
<?php
|
|
|
namespace LaneWeChat\Core; // 定义命名空间为 LaneWeChat\Core,表示该类属于 LaneWeChat 模块的核心部分
|
|
|
|
|
|
/**
|
|
|
* 高级群发功能类
|
|
|
*
|
|
|
* 该类提供了多种高级群发功能,包括上传图文消息、根据分组ID群发图文、文本、语音、图片和视频消息等。
|
|
|
*/
|
|
|
class AdvancedBroadcast {
|
|
|
|
|
|
/**
|
|
|
* 上传图文消息到微信服务器
|
|
|
*
|
|
|
* @param array $articles 图文消息数组,包含多篇文章的相关信息
|
|
|
* @return string|bool 返回上传成功后的media_id,或在失败时返回false
|
|
|
*/
|
|
|
public static function uploadNews($articles) {
|
|
|
// 构建请求URL,包含access_token,使用AccessToken类的getAccessToken方法获取
|
|
|
$queryUrl = 'https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token=' . AccessToken::getAccessToken();
|
|
|
$queryAction = 'POST'; // 请求方式为POST
|
|
|
// 遍历文章数组,对每个文章的字段进行URL编码,以确保特殊字符不会影响请求
|
|
|
foreach ($articles as &$article) {
|
|
|
$article['author'] = urlencode($article['author']);
|
|
|
$article['title'] = urlencode($article['title']);
|
|
|
$article['content'] = urlencode($article['content']);
|
|
|
$article['digest'] = urlencode($article['digest']);
|
|
|
}
|
|
|
$template = array(); // 创建模板数组
|
|
|
$template['articles'] = $articles; // 将编码后的文章数组赋值给模板的articles字段
|
|
|
$template = json_encode($template); // 将模板数组转换为JSON字符串
|
|
|
// 发起网络请求,调用Curl类的方法,传入URL、数据和请求方式
|
|
|
$result = Curl::callWebServer($queryUrl, $template, $queryAction);
|
|
|
// 返回media_id,如果结果中没有media_id则返回false
|
|
|
return empty($result['media_id']) ? false : $result['media_id'];
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 根据分组ID群发图文消息
|
|
|
*
|
|
|
* @param int $groupId 分组ID
|
|
|
* @param string $mediaId 图文消息的media_id
|
|
|
* @param bool $isToAll 是否群发所有用户,默认为false
|
|
|
* @return mixed 返回群发操作的结果
|
|
|
*/
|
|
|
public static function sentNewsByGroup($groupId, $mediaId, $isToAll = false) {
|
|
|
// 构建请求URL,包含access_token
|
|
|
$queryUrl = 'https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=' . AccessToken::getAccessToken();
|
|
|
$queryAction = 'POST'; // 请求方式为POST
|
|
|
$template = array(); // 创建模板数组
|
|
|
$template['filter']['group_id'] = $groupId; // 设置分组ID
|
|
|
$template['filter']['is_to_all'] = $isToAll; // 设置是否群发所有用户
|
|
|
$template['mpnews']['media_id'] = $mediaId; // 设置图文消息的media_id
|
|
|
$template['msgtype'] = 'mpnews'; // 设置消息类型为图文消息
|
|
|
$template = json_encode($template); // 将模板数组转换为JSON字符串
|
|
|
// 发起网络请求
|
|
|
return Curl::callWebServer($queryUrl, $template, $queryAction);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 根据分组ID群发文本消息
|
|
|
*
|
|
|
* @param int $groupId 分组ID
|
|
|
* @param string $content 文本内容
|
|
|
* @param bool $isToAll 是否群发所有用户,默认为false
|
|
|
* @return mixed 返回群发操作的结果
|
|
|
*/
|
|
|
public static function sentTextByGroup($groupId, $content, $isToAll = false) {
|
|
|
// 构建请求URL,包含access_token
|
|
|
$queryUrl = 'https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=' . AccessToken::getAccessToken();
|
|
|
$queryAction = 'POST'; // 请求方式为POST
|
|
|
$template = array(); // 创建模板数组
|
|
|
$template['filter']['group_id'] = $groupId; // 设置分组ID
|
|
|
$template['filter']['is_to_all'] = $isToAll; // 设置是否群发所有用户
|
|
|
$template['text']['content'] = $content; // 设置文本内容
|
|
|
$template['msgtype'] = 'text'; // 设置消息类型为文本消息
|
|
|
$template = json_encode($template); // 将模板数组转换为JSON字符串
|
|
|
// 发起网络请求
|
|
|
return Curl::callWebServer($queryUrl, $template, $queryAction);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 根据分组ID群发语音消息
|
|
|
*
|
|
|
* @param int $groupId 分组ID
|
|
|
* @param string $mediaId 语音消息的media_id
|
|
|
* @param bool $isToAll 是否群发所有用户,默认为false
|
|
|
* @return mixed 返回群发操作的结果
|
|
|
*/
|
|
|
public static function sentVoiceByGroup($groupId, $mediaId, $isToAll = false) {
|
|
|
// 构建请求URL,包含access_token
|
|
|
$queryUrl = 'https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=' . AccessToken::getAccessToken();
|
|
|
$queryAction = 'POST'; // 请求方式为POST
|
|
|
$template = array(); // 创建模板数组
|
|
|
$template['filter']['group_id'] = $groupId; // 设置分组ID
|
|
|
$template['filter']['is_to_all'] = $isToAll; // 设置是否群发所有用户
|
|
|
$template['voice']['media_id'] = $mediaId; // 设置语音消息的media_id
|
|
|
$template['msgtype'] = 'voice'; // 设置消息类型为语音消息
|
|
|
$template = json_encode($template); // 将模板数组转换为JSON字符串
|
|
|
// 发起网络请求
|
|
|
return Curl::callWebServer($queryUrl, $template, $queryAction);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 根据分组ID群发图片消息
|
|
|
*
|
|
|
* @param int $groupId 分组ID
|
|
|
* @param string $mediaId 图片消息的media_id
|
|
|
* @param bool $isToAll 是否群发所有用户,默认为false
|
|
|
* @return mixed 返回群发操作的结果
|
|
|
*/
|
|
|
public static function sentImageByGroup($groupId, $mediaId, $isToAll = false) {
|
|
|
// 构建请求URL,包含access_token
|
|
|
$queryUrl = 'https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=' . AccessToken::getAccessToken();
|
|
|
$queryAction = 'POST'; // 请求方式为POST
|
|
|
$template = array(); // 创建模板数组
|
|
|
$template['filter']['group_id'] = $groupId; // 设置分组ID
|
|
|
$template['filter']['is_to_all'] = $isToAll; // 设置是否群发所有用户
|
|
|
$template['image']['media_id'] = $mediaId; // 设置图片消息的media_id
|
|
|
$template['msgtype'] = 'image'; // 设置消息类型为图片消息
|
|
|
$template = json_encode($template); // 将模板数组转换为JSON字符串
|
|
|
// 发起网络请求
|
|
|
return Curl::callWebServer($queryUrl, $template, $queryAction);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 根据分组ID群发视频消息
|
|
|
*
|
|
|
* @param string $mediaId 视频消息的media_id
|
|
|
* @param string $title 视频标题
|
|
|
* @param string $description 视频描述
|
|
|
* @param int $groupId 分组ID
|
|
|
* @param bool $isToAll 是否群发所有用户,默认为false
|
|
|
* @return bool 返回群发操作是否成功
|
|
|
*/
|
|
|
public static function sentVideoByGroup($mediaId, $title, $description, $groupId, $isToAll = false) {
|
|
|
// 构建请求URL,包含access_token
|
|
|
$queryUrl = 'https://file.api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=' . AccessToken::getAccessToken();
|
|
|
$queryAction = 'POST'; // 请求方式为POST
|
|
|
$template = array(); // 创建模板数组
|
|
|
$template['media_id'] = $mediaId; // 设置视频消息的media_id
|
|
|
$template['title'] = $title; // 设置视频标题
|
|
|
$template['description'] = $description; // 设置视频描述
|
|
|
$template = json_encode($template); // 将模板数组转换为JSON字符串
|
|
|
// 发起网络请求
|
|
|
$result = Curl::callWebServer($queryUrl, $template, $queryAction);
|
|
|
// 检查返回结果是否符合预期
|
|
|
if (empty($result['type']) || $result['type'] != 'video' || empty($result['media_id'])) {
|
|
|
// 如果结果中没有type字段,或者type不是video,或者没有media_id,则返回false
|
|
|
return false;
|
|
|
}
|
|
|
// 如果视频上传成功,可以在这里添加发送视频消息的代码
|
|
|
}
|
|
|
} |