首页

阿里云Storage 服务说明

功能简介

Web开发者经常需要处理用户上传的图片、附件、文档等各种资料,普遍的操作方式是将这些资料存储于服务器本地空间。但在ACE这样一个分布式的环境中,存储与本地不利于平台按处理访问能力决定的服务器自动扩张和回收,因此ACE提供了storage服务。开发者可以通过storage服务获得分布式的存储能力和空间。

使用说明

使用storage无需开发者在代码中添加任何库文件,无需申请自己的密钥,无需手动创建存储的“文件夹”名,只需要调用类似文件操作的接口。

参考示例

< ?php
$storage = new CEStorage();
if(file_exists("test.jpg")){
$file_url = $storage->upload("test.jpg", "title.jpg");
// $file_url will be XXX.aliapp.com/aliyun_ce_storage/title.jpg
}
$file_lists = $storage->getList();
if($stoage->fileExists("title.jpg")){
$content = $storage->read("title.jpg");
}
?>

API文档

string upload (string $srcFileName, string $destFileName)

上传文件,保存至存储服务器。
参数:
srcFileName
需上传的文件名
destFileName
保存文件名
返回值:
成功则返回文件访问地址,否则false。

string read (string $filename)

读取文件内容。
参数:
filename
读取的文件名
返回值:
成功返回文件内容,否则false。

string getUrl (string $filename)

获取访问文件的url。
参数:
filename
需获取的文件名
返回值:
成功则返回URL,否则false。

string delete (string $filename)

删除文件。
参数:
filename
需要删除的文件名
返回值:
成功返回true,否则false。

string fileExists (string $filename)

判断文件是否存在。
参数:
filename
需要判断的文件名
返回值:
存在返回true,否则false。

array getList ( [string $prefix = ''],[int $num=100], [string $marker = ''], [$delimiter=''])

获取文件列表
参数:
prefix
查询的匹配前缀
num
一次列出的文件个数
marker
列出文件的起始位置,如a.jpg。
delimiter
如果再把delimiter设置为 / 时,返回值就只罗列该文件夹下的文件,子文件夹下递归的文件和文件夹不被显示。
返回值:
成功返回文件列表数组,失败false。

string errmsg ()

获取错误信息。
返回值:
返回错误信息。

int errno ()

获取错误码。
返回值:
返回错误码。
Error Msg: errno: 0 成功 errno:-1 参数错误 errno:-400 无效参数 errno:-404 对象不存在 errno:-500 服务器内部错误