#素材管理
## 临时素材
####介绍
对于临时素材,每个素材(media_id)会在开发者上传或粉丝发送到微信服务器3天后自动删除(所以用户发送给开发者的素材,若开发者需要,应尽快下载到本地),以节省服务器资源。
<a href="http://mp.weixin.qq.com/wiki/5/963fc70b80dc75483a271298a76a8d59.html" target="_blank">查看官方文档</a>
**大小限制**
* 图片(image): 1M,支持JPG格式
* 语音(voice):2M,播放长度不超过60s,支持AMR\MP3格式
* 视频(video):10MB,支持MP4格式
* 缩略图(thumb):64KB,支持JPG格式
>临时素材微信官网保存3天
```
$d = Weixin::instance('material')->upload('image','1.png');
p($d);
```
####新增临时素材
```
$media = Weixin::instance('material')->upload('image', '1.png',1);
```
####下载临时素材
```
//上传图片素材
$result = Weixin::instance('material')->upload('image', '1.png',1);
//下载素材到本地 参数: media_id 保存的文件名
Weixin::instance('material')->download($result['media_id'],'1_bak.png');
```
##永久素材
####介绍
* 新增的永久素材也可以在公众平台官网素材管理模块中看到
* 永久素材的数量是有上限的,请谨慎新增。图文消息素材和图片素材的上限为5000,其他类型为1000
####新增其他类型永久素材
```
$data = Weixin::instance('material')->upload('image', '1.png', 0);
p($data);
```
####获取永久素材
```
//$media_id 为素材media_id
$result = Weixin::instance('material')->getMaterial($media_id);
```
####删除永久素材
```
//$media_id 为素材media_id
$result = Weixin::instance('material')->delete($media_id);
```
####新增永久图文素材
```
//新增永久素材(用于测试上传图文素材)
$articles = array(
'articles' => array(
array(
'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'
)
)
);
//添加图文,返回为新增的图文消息素材的media_id。
$result = Weixin::instance('material')->addNews($articles);
echo $result['media_id'];
```
####修改永久图文素材
```
$article = array(
//要修改的图文消息的id
"media_id" => 'xxxxx',
//要更新的文章在图文消息中的位置(多图文消息时,此字段才有意义),第一篇为0
"index" => 0,
'articles' => array(
array(
'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 = Weixin::instance('material')->editNews($article);
```
####获取素材总数
图片和图文消息素材(包括单图文和多图文)的总数上限为5000,其他素材的总数上限为1000
```
$result = Weixin::instance('material')->total();
```
####获取素材列表
```
$param = array(
//素材的类型,图片(image)、视频(video)、语音 (voice)、图文(news)
"type" => 'image',
//从全部素材的该偏移位置开始返回,0表示从第一个素材 返回
"offset" => 0,
//返回素材的数量,取值在1到20之间
"count" => 10
);
$result = Weixin::instance('material')->lists($param);
```
- 基础
- 框架特性
- 开发规范
- 许可协议
- 安装
- 伪静态
- 作者
- 更新日志
- 架构
- 入口文件
- 目录结构
- 系统常量
- 自动加载
- 应用目录
- 配置
- 设置配置
- 检测配置
- 获取配置
- 配置文件
- 扩展配置
- c 函数
- 函数
- 工具函数
- 控制器
- 定义
- 空方法
- 基本访问
- 路由
- 基础路由
- 控制器路由
- 路由参数
- 参数检测
- 分组路由
- RESTful
- 数据库
- 配置
- 核心操作
- 查询构造器
- 表操作
- 事务处理
- 函数
- 查询日志
- 模型
- 定义模型
- 模型动作
- 构建数据
- 模型验证
- 自动完成
- 自动过滤
- 字段映射
- 表单令牌
- 字段保护
- 视图模型
- 关联模型
- 魔术方法
- 视图
- 模板配置
- 模板文件
- 分配数据
- 请求响应
- 系统标签
- 扩展标签
- 缓存模板
- 模板继承
- 中间件与钩子
- 中间件
- 钩子
- 缓存
- 基础
- Mysql缓存
- 文件缓存
- 调试
- Trace
- 日志
- 调试模式
- 服务
- 介绍
- 创建服务
- 系统服务
- 自动完成
- 压缩&解压
- 自动验证
- 上传
- 字符串
- 响应
- 请求数据
- RBAC
- QQ整合登录
- 分页
- 邮件
- 语言
- 图像
- 生成静态
- 目录操作
- 数据处理
- curl
- 加密
- Cookie
- 验证码
- 购物车
- 备份
- 数组
- 支付宝
- xml
- 工具
- 云接口
- 前端组件
- 基本配置
- 列表框日期选择
- CSS 样式
- URL操作
- 数据验证
- 城市选择
- JSON处理
- 幻灯片
- checkbox滑动样式
- 消息框
- md5
- 模态框
- 上传表单样式
- 选择字体
- 剪贴板
- 上传图片
- 上传文件
- 拾色器 spectrum
- 列表框 select2
- 百度地图
- 二维码生成
- 表单提交
- 时间管理 moment
- 加载动画
- 百度编辑器
- Cookie操作
- 图标库 font-awesome
- emotion表情
- domReady
- 日期 datetimepicker
- 日期区间列表 daterangepicker
- 日期区间 daterangepicker
- 时间 clockpicker
- 图表
- 光标控制 caret
- 表单验证 bootstrapValidator
- 微信
- 配置项
- 绑定开发者
- 获取access_token
- 网页授权获取用户基本信息
- 微信支付
- 微信红包
- 用户管理
- 二维码
- 回复消息
- 消息管理
- 素材管理
- 会员组管理
- 事件管理
- 消息群发
- 客服
- 自定义菜单
- 菜单管理
- 菜单事件
- 附录
- 升级环境
- HTTP 状态码
- GIT 命令