mirror of
https://gitee.com/zoujingli/WeChatDeveloper.git
synced 2025-04-05 01:42:45 +08:00
196 lines
7.7 KiB
PHP
196 lines
7.7 KiB
PHP
<?php
|
||
|
||
// +----------------------------------------------------------------------
|
||
// | WeChatDeveloper
|
||
// +----------------------------------------------------------------------
|
||
// | 版权所有 2014~2024 ThinkAdmin [ thinkadmin.top ]
|
||
// +----------------------------------------------------------------------
|
||
// | 官方网站: https://thinkadmin.top
|
||
// +----------------------------------------------------------------------
|
||
// | 开源协议 ( https://mit-license.org )
|
||
// | 免责声明 ( https://thinkadmin.top/disclaimer )
|
||
// +----------------------------------------------------------------------
|
||
// | gitee 代码仓库：https://gitee.com/zoujingli/WeChatDeveloper
|
||
// | github 代码仓库：https://github.com/zoujingli/WeChatDeveloper
|
||
// +----------------------------------------------------------------------
|
||
|
||
namespace WeChat;
|
||
|
||
use WeChat\Contracts\BasicWeChat;
|
||
use WeChat\Contracts\Tools;
|
||
use WeChat\Exceptions\InvalidResponseException;
|
||
|
||
/**
|
||
* 微信素材管理
|
||
* Class Media
|
||
* @package WeChat
|
||
*/
|
||
class Media extends BasicWeChat
|
||
{
|
||
/**
|
||
* 新增临时素材
|
||
* @param string $filename 文件名称
|
||
* @param string $type 媒体文件类型(image|voice|video|thumb)
|
||
* @return array
|
||
* @throws \WeChat\Exceptions\InvalidResponseException
|
||
* @throws \WeChat\Exceptions\LocalCacheException
|
||
*/
|
||
public function add($filename, $type = 'image')
|
||
{
|
||
if (!in_array($type, ['image', 'voice', 'video', 'thumb'])) {
|
||
throw new InvalidResponseException('Invalid Media Type.', '0');
|
||
}
|
||
$url = "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type={$type}";
|
||
return $this->callPostApi($url, ['media' => Tools::createCurlFile($filename)], false);
|
||
}
|
||
|
||
/**
|
||
* 获取临时素材
|
||
* @param string $media_id
|
||
* @param string $outType 返回处理函数
|
||
* @return array|string
|
||
* @throws \WeChat\Exceptions\InvalidResponseException
|
||
* @throws \WeChat\Exceptions\LocalCacheException
|
||
*/
|
||
public function get($media_id, $outType = null)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id={$media_id}";
|
||
$this->registerApi($url, __FUNCTION__, func_get_args());
|
||
if ($outType == 'url') return $url;
|
||
$result = Tools::get($url);
|
||
if (is_array($json = json_decode($result, true))) {
|
||
if (!$this->isTry && isset($json['errcode']) && in_array($json['errcode'], ['40014', '40001', '41001', '42001'])) {
|
||
[$this->delAccessToken(), $this->isTry = true];
|
||
return call_user_func_array([$this, $this->currentMethod['method']], $this->currentMethod['arguments']);
|
||
}
|
||
return Tools::json2arr($result);
|
||
}
|
||
return is_null($outType) ? $result : $outType($result);
|
||
}
|
||
|
||
/**
|
||
* 新增图文素材
|
||
* @param array $data 文件名称
|
||
* @return array
|
||
* @throws \WeChat\Exceptions\InvalidResponseException
|
||
* @throws \WeChat\Exceptions\LocalCacheException
|
||
*/
|
||
public function addNews($data)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, $data);
|
||
}
|
||
|
||
/**
|
||
* 更新图文素材
|
||
* @param string $media_id 要修改的图文消息的id
|
||
* @param int $index 要更新的文章在图文消息中的位置（多图文消息时，此字段才有意义），第一篇为0
|
||
* @param array $news 文章内容
|
||
* @return array
|
||
* @throws \WeChat\Exceptions\InvalidResponseException
|
||
* @throws \WeChat\Exceptions\LocalCacheException
|
||
*/
|
||
public function updateNews($media_id, $index, $news)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/material/update_news?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, ['media_id' => $media_id, 'index' => $index, 'articles' => $news]);
|
||
}
|
||
|
||
/**
|
||
* 上传图文消息内的图片获取URL
|
||
* @param mixed $filename
|
||
* @return array
|
||
* @throws \WeChat\Exceptions\InvalidResponseException
|
||
* @throws \WeChat\Exceptions\LocalCacheException
|
||
*/
|
||
public function uploadImg($filename)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, ['media' => Tools::createCurlFile($filename)], false);
|
||
}
|
||
|
||
/**
|
||
* 新增其他类型永久素材
|
||
* @param mixed $filename 文件名称
|
||
* @param string $type 媒体文件类型(image|voice|video|thumb)
|
||
* @param array $description 包含素材的描述信息
|
||
* @return array
|
||
* @throws \WeChat\Exceptions\InvalidResponseException
|
||
* @throws \WeChat\Exceptions\LocalCacheException
|
||
*/
|
||
public function addMaterial($filename, $type = 'image', $description = [])
|
||
{
|
||
if (!in_array($type, ['image', 'voice', 'video', 'thumb'])) {
|
||
throw new InvalidResponseException('Invalid Media Type.', '0');
|
||
}
|
||
$url = "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type={$type}";
|
||
return $this->callPostApi($url, ['media' => Tools::createCurlFile($filename), 'description' => Tools::arr2json($description)], false);
|
||
}
|
||
|
||
/**
|
||
* 获取永久素材
|
||
* @param string $media_id
|
||
* @param null|string $outType 输出类型
|
||
* @return array|string
|
||
* @throws \WeChat\Exceptions\InvalidResponseException
|
||
* @throws \WeChat\Exceptions\LocalCacheException
|
||
*/
|
||
public function getMaterial($media_id, $outType = null)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/material/get_material?access_token=ACCESS_TOKEN";
|
||
$this->registerApi($url, __FUNCTION__, func_get_args());
|
||
if ($outType == 'url') return $url;
|
||
$result = Tools::post($url, ['media_id' => $media_id]);
|
||
if (is_array($json = json_decode($result, true))) {
|
||
if (!$this->isTry && isset($json['errcode']) && in_array($json['errcode'], ['40014', '40001', '41001', '42001'])) {
|
||
[$this->delAccessToken(), $this->isTry = true];
|
||
return call_user_func_array([$this, $this->currentMethod['method']], $this->currentMethod['arguments']);
|
||
}
|
||
return Tools::json2arr($result);
|
||
}
|
||
return is_null($outType) ? $result : $outType($result);
|
||
}
|
||
|
||
/**
|
||
* 删除永久素材
|
||
* @param string $mediaId
|
||
* @return array
|
||
* @throws \WeChat\Exceptions\InvalidResponseException
|
||
* @throws \WeChat\Exceptions\LocalCacheException
|
||
*/
|
||
public function delMaterial($mediaId)
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/material/del_material?access_token=ACCESS_TOKEN";
|
||
return $this->httpPostForJson($url, ['media_id' => $mediaId]);
|
||
}
|
||
|
||
/**
|
||
* 获取素材总数
|
||
* @return array
|
||
* @throws \WeChat\Exceptions\InvalidResponseException
|
||
* @throws \WeChat\Exceptions\LocalCacheException
|
||
*/
|
||
public function getMaterialCount()
|
||
{
|
||
$url = "https://api.weixin.qq.com/cgi-bin/material/get_materialcount?access_token=ACCESS_TOKEN";
|
||
return $this->callGetApi($url);
|
||
}
|
||
|
||
/**
|
||
* 获取素材列表
|
||
* @param string $type
|
||
* @param int $offset
|
||
* @param int $count
|
||
* @return array
|
||
* @throws \WeChat\Exceptions\InvalidResponseException
|
||
* @throws \WeChat\Exceptions\LocalCacheException
|
||
*/
|
||
public function batchGetMaterial($type = 'image', $offset = 0, $count = 20)
|
||
{
|
||
if (!in_array($type, ['image', 'voice', 'video', 'news'])) {
|
||
throw new InvalidResponseException('Invalid Media Type.', '0');
|
||
}
|
||
$url = "https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN";
|
||
return $this->callPostApi($url, ['type' => $type, 'offset' => $offset, 'count' => $count]);
|
||
}
|
||
} |