阿裡雲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    服務器內部錯誤