物件儲存（Object-Oriented Storage，OOS）是AWS發明的雲端儲存服務, AWS稱之為S3(Simple Storage Service). 物件儲存為客戶提供的一種海量、彈性、高可用、高性價比的儲存服務，按需使用，像一個超級硬碟一樣。

     中國電信天翼雲提供物件儲存(OOS)服務，其API介面相容AWS S3介面。與眾不同的是，中國電信提供一種專線，稱為雲專線，將企業的區域網與雲直連。企業可通過專線訪問物件儲存，不需通過網際網路訪問，既安全又高速。這樣訪問物件儲存就跟訪問本地硬碟一樣快，最高可達到1000M bps, 非常適合於企業大資料量儲存、備份。

     使用物件儲存有兩種方式： 

第一種是通過門戶網頁，手工操作上下載檔案。天翼雲物件儲存的門戶網址是  http://oos.ctyun.cn/。到電信公司開個戶，即可使用。

第二種是通過呼叫API, 程式方式上下載檔案。天翼雲相容AWS S3介面,  可以採用AWS SDK實現API呼叫。 到電信公司開個戶，在門戶網頁登入後，可獲得Access Key 和 Secret, 用於開發。

我經常使用的是PHP,  本文小結一個如何使用AWS PHP SDK存取天翼雲的物件儲存(OSS)。

一、下載AWS PHP SDK

  AWS PHP SDK版本選擇：   經測試，目前天翼雲只能使用 AWS PHP SDK V2.x 版本。不能使用V3.x版本。

 我下載phar檔案(只有一個檔案方便用), 下載地址： 

二、AWS PHP SDK的使用

簡單說， 就是建立一個 S3Client物件， 然後呼叫 S3Client物件的幾個方法，比如： getObject() 下載物件檔案  putObject() 上載物件檔案。

關於S3Client物件的開發說明文件在：http://docs.aws.amazon.com/aws-sdk-php/v2/api/class-Aws.S3.S3Client.html

當訪問天翼雲，建立S3Client物件時，要宣告 endpoint 為天翼雲的伺服器地址即可。

例程：

<?php

require 'aws.phar'; ////包含AWS SDK檔案 aws.phar(只能使用V2版的SDK)
use Aws\S3\S3Client;   //宣告使用Aws名稱空間中的S3Client類

//天翼雲的API伺服器
$endpoint = 'http://oos.ctyunapi.cn'; 

//Access Key 在天翼雲門戶網站-帳戶管理-API金鑰管理中獲取
$accessKey = "ACCESS KEY ID"; 

//Access Secret 在天翼雲門戶網站-帳戶管理-API金鑰管理中獲取
$accessSecret = "SECRECT ID";

//建立S3 client 物件
$client = S3Client::factory([
	'endpoint' => $endpoint,  //宣告使用指定的endpoint
	'key'      => $accessKey,
	'secret'   => $accessSecret
]);

header('content-type:text/plain');

//列出所有buckets
$result = $client->listBuckets(array());
foreach ($result['Buckets'] as $bucket) {
	// Each Bucket value will contain a Name and CreationDate
	echo "{$bucket['Name']} - {$bucket['CreationDate']}\n";
}

echo "\n\n";

//列出指定bucket下所有的object
$bucket = 'cwz-public';
$result = $client->listObjects(array(
		'Bucket' => $bucket
));
foreach ($result['Contents'] as $object) {
	// Each Bucket value will contain a Name and CreationDate
	echo "{$object['Key']} - {$object['Size']}\n";
}

echo "\n\n";

//上傳一個object
$bucket = 'my-public';
$key = 'new.txt';
$body = file_get_contents('new.txt');
$client->upload($bucket, $key, $body);

//下載一個object
$result = $client->getObject(array(
		'Bucket' => $bucket,
		'Key'    => 'new.txt'
));
echo $result['Body']; //顯示檔案物件的內容

?>
 

三、小結

例程程式碼很簡單。要點是兩個：

1， 使用AWS SDK v2.x版本。

2,  建立S3 client 物件是，要指定 endpoint 為天翼雲API伺服器

$client = S3Client::factory([

    'endpoint'=> $endpoint,

    'key'     => $accessKey,

    'secret'  => $accessSecret

]);

    S3Client還有很多方法， 看文件慢慢玩吧！