新增临时素材

参数：

• string $type

  • 功能：素材类型，参考微信文档
  • 默认值：无

• string $media

  • 功能：素材文件绝对路径
  • 默认值：无

返回值：false 或 array

使用示例：

$obj = new \wechat\Wechat();
$obj->official()->media()->upload('image', ROOT_PATH.'niuniu.jpg');

成功结果：

array(4) {
  ["type"] => string(5) "image"
  ["media_id"] => string(64) "t119zKeMhH9-ODflIhFhVt4Bs3Sn_i2j3w7BGe9QAjP2XqItAX5Z64u2zm3uwd2w"
  ["created_at"] => int(1638345833)
  ["item"] => array(0) {
  }
}

获取临时素材

参数：

• string $media_id

  • 功能：素材ID
  • 默认值：无

返回值：除了视频消息素材，其他素材统一返回访问URL

使用示例：

$obj = new \wechat\Wechat();
$obj->official()->media()->get('pJDRsEsCunwurQFyb8ya5BuJvVB6Jm-xJLGKZNbGiis853Yv_VLdVQW8Yp8T_7Z8');

通常的返回值：

https://api.weixin.qq.com/cgi-bin/media/get?access_token=51_JJ5S4LBzrPCdqREkMrXfGOLx4QTa-XYZ6UmdxLXBOKuBphSWvgFrBnlz7mrCZvrrd4_fXNtd0NOrIEMmVYHsHJBRbsZ6mzy1fczSNFJ013XHhMC-WkasesJ6adDWXhHBU5V-7sXEmw1QIlHdZIRiAIAENW&media_id=pJDRsEsCunwurQFyb8ya5BuJvVB6Jm-xJLGKZNbGiis853Yv_VLdVQW8Yp8T_7Z8

视频消息素材时的返回值：

array(1) {
  ["video_url"]=>
  string(12) "视频地址"
}

获取高清语音素材

参数：

• string $media_id

  • 功能：素材ID
  • 默认值：无

返回值：访问URL

使用示例：

$obj = new \wechat\Wechat();
$obj->official()->media()->voice_get('pJDRsEsCunwurQFyb8ya5BuJvVB6Jm-xJLGKZNbGiis853Yv_VLdVQW8Yp8T_7Z8');

通常的返回值：

https://api.weixin.qq.com/cgi-bin/media/get/jssdk?access_token=51_JJ5S4LBzrPCdqREkMrXfGOLx4QTa-XYZ6UmdxLXBOKuBphSWvgFrBnlz7mrCZvrrd4_fXNtd0NOrIEMmVYHsHJBRbsZ6mzy1fczSNFJ013XHhMC-WkasesJ6adDWXhHBU5V-7sXEmw1QIlHdZIRiAIAENW&media_id=pJDRsEsCunwurQFyb8ya5BuJvVB6Jm-xJLGKZNbGiis853Yv_VLdVQW8Yp8T_7Z8

新增永久素材

参数：

• string $type

  • 功能：素材类型，参考微信文档
  • 默认值：无

• string $media

  • 功能：素材文件绝对路径
  • 默认值：无

• array $body

  • 功能：素材文件描述【固定格式，参考示例】
  • 默认值：无

返回值：false 或 array

使用示例：

$obj = new \wechat\Wechat();
$obj->official()->media()->forever_upload('image', ROOT_PATH.'niuniu.jpg', ['title'=>'图片标题', 'introduction'=>'图片描述']);

成功结果：

array(3) {
  ["media_id"] => string(43) "88nyYvXWWPsJ47lBx9pAo62qrTdkDTCtOaD3nLybWwo"
  ["url"] => string(135) "http://mmbiz.qpic.cn/mmbiz_jpg/SriaaAka0YWeEcuwLaytR1z1WXHb2sqYmJ5skoevWhOBcASq0shHc4uJUCD4icA3dhUiaqpLQz4Y6feiao1bmfKO9Q/0?wx_fmt=jpeg"
  ["item"] => array(0) {
  }
}

获取永久素材

参数：

• string $media_id

  • 功能：素材ID
  • 默认值：无

返回值：除了图文，视频消息素材，其他素材统一返回访问URL

使用示例：

$obj = new \wechat\Wechat();
$obj->official()->media()->forever_get('pJDRsEsCunwurQFyb8ya5BuJvVB6Jm-xJLGKZNbGiis853Yv_VLdVQW8Yp8T_7Z8');

通常的返回值：

https://api.weixin.qq.com/cgi-bin/media/get?access_token=51_JJ5S4LBzrPCdqREkMrXfGOLx4QTa-XYZ6UmdxLXBOKuBphSWvgFrBnlz7mrCZvrrd4_fXNtd0NOrIEMmVYHsHJBRbsZ6mzy1fczSNFJ013XHhMC-WkasesJ6adDWXhHBU5V-7sXEmw1QIlHdZIRiAIAENW&media_id=pJDRsEsCunwurQFyb8ya5BuJvVB6Jm-xJLGKZNbGiis853Yv_VLdVQW8Yp8T_7Z8

其他类型的返回值结构，参考微信开发文档

删除永久素材

参数：

• string $media_id

  • 功能：素材ID
  • 默认值：无

返回值：bool

使用示例：

$obj = new \wechat\Wechat();
// false.失败 true.成功
$obj->official()->media()->forever_delete('88nyYvXWWPsJ47lBx9pAo62qrTdkDTCtOaD3nLybWwo');

上传小图片

参数：

• string $media

  • 功能：素材文件绝对路径
  • 默认值：无

返回值：false 或 文件预览地址

使用示例：

$obj = new \wechat\Wechat();
$obj->official()->media()->uploadimg(ROOT_PATH.'niuniu.jpg');

成功结果：

http://mmbiz.qpic.cn/mmbiz_jpg/SriaaAka0YWeEcuwLaytR1z1WXHb2sqYmJ5skoevWhOBcASq0shHc4uJUCD4icA3dhUiaqpLQz4Y6feiao1bmfKO9Q/0

新增永久图文素材

$obj = new \wechat\Wechat();
$obj->official()->media()->news_create('{
    "articles": [
      {
        "title": "标题",
        "thumb_media_id": "pJDRsEsCunwurQFyb8ya5BuJvVB6Jm-xJLGKZNbGiis853Yv_VLdVQW8Yp8T_7Z8",
        "author": "作者名称",
        "digest": "图文消息的摘要",
        "show_cover_pic": 0,
        "content": "图文内容",
        "content_source_url": "图文消息的原文地址",
        "need_open_comment": 1,
        "only_fans_can_comment": 1
      }
    ]
 }');

成功结果：

图文消息素材的media_id

修改永久图文素材

$obj = new \wechat\Wechat();
// false.失败 true.成功
$obj->official()->media()->news_update('{
    "media_id":"素材ID",
    "index":0,
    "articles": [
      {
        "title": "标题",
        "thumb_media_id": "pJDRsEsCunwurQFyb8ya5BuJvVB6Jm-xJLGKZNbGiis853Yv_VLdVQW8Yp8T_7Z8",
        "author": "作者名称",
        "digest": "图文消息的摘要",
        "show_cover_pic": 0,
        "content": "图文内容",
        "content_source_url": "图文消息的原文地址"
      }
    ]
}');

获取素材总数

$obj = new \wechat\Wechat();
$obj->official()->media()->count();

成功结果：

array(4) {
  ["voice_count"] => int(0)
  ["video_count"] => int(0)
  ["image_count"] => int(0)
  ["news_count"] => int(0)
}

获取素材列表

$obj = new \wechat\Wechat();
$obj->official()->media()->showlist([
	"type" => "image",
    "offset" => 0,
    "count" => 20
]);

成功结果：

返回值场景太多，参考微信开发文档，返回结构是array