Easemob\Attachment类 参考

Public 成员函数
	uploadFile ($fileName, $restrictAccess=false)
	文件上传 更多...
	downloadFile ($fileName, $uuid, $shareSecret='')
	下载附件 更多...
	downloadThumb ($fileName, $uuid, $shareSecret='')
	下载缩略图 更多...

详细描述

Attachment 用来上传下载附件

成员函数说明

downloadFile()

Easemob\Attachment::downloadFile	(		$fileName,
			$uuid,
			$shareSecret = ''
	)

下载附件

这里需要注意的就是，如果上传文件时候选择了文件不共享，需要在请求头中带上上面返回的 share-secret 和当前登录用户的 token 才能够下载。

参数

string	$fileName	下载的文件名
string	$uuid	文件唯一 ID，文件上传成功后会返回
string	$shareSecret	share-secret，文件上传成功后会返回

返回

int|array 下载文件的大小或者错误

downloadThumb()

Easemob\Attachment::downloadThumb	(		$fileName,
			$uuid,
			$shareSecret = ''
	)

下载缩略图

在服务器端支持自动的创建图片的缩略图。可以先下载缩略图，当用户有需求的时候，再下载大图。 这里和下载大图唯一不同的就是 header 中多了一个“thumbnail: true”，当服务器看到过来的请求的 header 中包括这个的时候，就会返回缩略图，否则返回原始大图。

参数

string	$fileName	下载缩略图的文件名
string	$uuid	文件唯一 ID，文件上传成功后会返回
string	$shareSecret	share-secret，文件上传成功后会返回

返回

int|array 下载缩略图的大小或者错误

uploadFile()

Easemob\Attachment::uploadFile	(		$fileName,
			$restrictAccess = false
	)

文件上传

• 上传文件的大小不能超过 10 M，超过会上传失败。
• 在上传文件的时候可以选择是否限制访问权限，如果选择限制的话，会在上传请求完成后返回一个 secret，只有知道这个 secret，并且是 app 的注册用户，才能够下载文件。如果选择不限制的话，则只要是 app 的注册用户就能够下载。
• 如选择加 secret 限制的话，消息回调（包含发送前回调和发送后回调）、历史消息这些功能中涉及下载文件时，都需要在下载 url 中拼接 secret，才能正常下载文件；
• 拼接规则如下：url?share-secret=secret

参数

string	$fileName	上传的附件
boolean	$restrictAccess	控制文件是否可以被任何人获取，这个值为 true，返回结果中会添加一个 share-secret 值。再次访问文件需要用到这个值。默认值：false

返回

array 上传文件信息或者错误