## 圖文素材
圖文素材屬于永久類型的素材,上傳后可以在微信管理后臺查看到。
[TOC]
#### 新增圖片素材
```
/上傳永久素材
$instance = WeChat::instance('material');
$material = $instance->addMaterial('image', 'tests/images/user.jpg');
```
#### 新增圖文素材
```
$articles = [
'articles' => [
[
'title' => '后盾人',
//圖文消息的封面圖片素材id(必須是永久消息的mediaID)
'thumb_media_id' => $material['media_id'],
//作者
'author' => '后盾網',
//圖文消息的摘要,僅有單圖文消息才有摘要,多圖文此處為空
'digest' => '摘要信息...',
//1 顯示封面 0 不顯示
'show_cover_pic' => 1,
//圖文內容,必須少于2萬字符
'content' => '圖文內容...',
//圖文消息的原文地址,即點擊“閱讀原文”后的URL
'content_source_url' => 'http://houdunwang.com',
],
],
];
//添加圖文,返回為新增的圖文消息素材的media_id。
$instance = WeChat::instance('material');
$result = $instance->addNews($articles);
//上傳成功的圖文消息media_id,可用于群發消息使用
echo $result['media_id'];
```
#### 修改圖文素材
```
$article = [
//要修改的圖文消息的id
"media_id" => 'xxxxx',
//要更新的文章在圖文消息中的位置(多圖文消息時,此字段才有意義),第一篇為0
"index" => 0,
'articles' =>[
'title' => '后盾網',
//圖文消息的封面圖片素材id(必須是永久mediaID)
'thumb_media_id' => $data['media_id'],
//作者
'author' => '后盾網',
//圖文消息的摘要,僅有單圖文消息才有摘要,多圖文此處為空
'digest' => '摘要信息...',
//1 顯示封面 0 不顯示
'show_cover_pic' => 1,
//圖文內容,必須少于2萬字符
'content' => '圖文內容...',
//圖文消息的原文地址,即點擊“閱讀原文”后的URL
'content_source_url' => 'http://houdunwang.com'
]
];
$result = (new WeChat())->instance('material')->editNews($article);
```
**返回值**
```
[
"errcode": 9001034,//錯誤號 成功時為0
"errmsg": '錯誤提示信息'
]
```
#### 上傳圖文消息內的圖片獲取URL
本接口所上傳的圖片不占用公眾號的素材庫中圖片數量的5000個的限制。圖片僅支持jpg/png格式,大小必須在1MB以下。
```
$instance = WeChat::instance('material');
$material = $instance->addNewsImage('tests/images/user.jpg');
echo $material['url'];
```