Web開發(fā)者經(jīng)常需要處理用戶上傳的圖片、附件、文檔等各種資料,普遍的操作方式是將這些資料存儲于服務(wù)器本地空間。但在ACE這樣一個分布式的環(huán)境中,存儲與本地不利于平臺按處理訪問能力決定的服務(wù)器自動擴(kuò)張和回收,因此ACE提供了storage服務(wù)。開發(fā)者可以通過storage服務(wù)獲得分布式的存儲能力和空間。
使用說明
使用storage無需開發(fā)者在代碼中添加任何庫文件,無需申請自己的密鑰,無需手動創(chuàng)建存儲的“文件夾”名,只需要調(diào)用類似文件操作的接口。
參考示例
< ?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)
上傳文件,保存至存儲服務(wù)器。
參數(shù):
srcFileName
需上傳的文件名
destFileName
保存文件名
返回值:
成功則返回文件訪問地址,否則false。
string read (string $filename)
讀取文件內(nèi)容。
參數(shù):
filename
讀取的文件名
返回值:
成功返回文件內(nèi)容,否則false。
string getUrl (string $filename)
獲取訪問文件的url。
參數(shù):
filename
需獲取的文件名
返回值:
成功則返回URL,否則false。
string delete (string $filename)
刪除文件。
參數(shù):
filename
需要刪除的文件名
返回值:
成功返回true,否則false。
string fileExists (string $filename)
判斷文件是否存在。
參數(shù):
filename
需要判斷的文件名
返回值:
存在返回true,否則false。
array getList ( [string $prefix = ''],[int $num=100], [string $marker = ''], [$delimiter=''])
獲取文件列表
參數(shù):
prefix
查詢的匹配前綴
num
一次列出的文件個數(shù)
marker
列出文件的起始位置,如a.jpg。
delimiter
如果再把delimiter設(shè)置為 / 時,返回值就只羅列該文件夾下的文件,子文件夾下遞歸的文件和文件夾不被顯示。
返回值:
成功返回文件列表數(shù)組,失敗false。
string errmsg ()
獲取錯誤信息。
返回值:
返回錯誤信息。
int errno ()
獲取錯誤碼。
返回值:
返回錯誤碼。
Error Msg:
errno: 0
成功
errno:-1
參數(shù)錯誤
errno:-400 無效參數(shù)
errno:-404 對象不存在
errno:-500 服務(wù)器內(nèi)部錯誤