OTSClient是Tablestore服務的用戶端,它為調用者提供了一系列的方法,可以用來動作表、讀寫單行資料、讀寫多行資料等。使用PHP SDK發起請求,您需要初始化一個OTSClient執行個體,並根據需要修改OTSClientConfig的預設配置項。
確定Endpoint
Endpoint是阿里雲Tablestore服務各個執行個體的網域名稱地址,目前支援下列形式。
樣本 | 解釋 |
---|---|
http://sun.cn-hangzhou.ots.aliyuncs.com | HTTP協議,公網網路訪問杭州地區的sun執行個體。 |
https://sun.cn-hangzhou.ots.aliyuncs.com | HTTPS協議,公網網路訪問杭州地區的sun執行個體。 |
重要 除了公網可以訪問外,也支援私網地址。更多資訊,請參見服務地址。
請按照如下步驟擷取執行個體的Endpoint:
- 登入Tablestore管理主控台。
- 在概覽頁面,單擊執行個體名稱。
- 在執行個體詳情頁簽的執行個體訪問地址地區即可查看該執行個體的服務地址(Endpoint)。
配置密鑰
要接入阿里雲的Tablestore服務,您需要擁有一個有效存取金鑰進行簽名認證。目前支援下面三種方式:
- 阿里雲帳號的AccessKey ID和AccessKey Secret。建立步驟如下:
- 在阿里雲官網註冊阿里雲帳號。
- 建立AccessKey ID和AccessKey Secret。具體操作,請參見擷取AccessKey。
- 被授予訪問Tablestore許可權的RAM使用者的AccessKey ID和AccessKey Secret。建立步驟如下:
- 使用阿里雲帳號前往存取控制RAM,建立一個新的RAM使用者或者使用已經存在的RAM使用者。
- 使用阿里雲帳號授予RAM使用者訪問Tablestore的許可權。
- RAM使用者被授權後,即可使用自己的AccessKey ID和AccessKey Secret訪問。
- 從STS擷取的臨時訪問憑證。擷取步驟如下:
- 應用的伺服器通過訪問RAM/STS服務,擷取一個臨時的AccessKey ID、AccessKey Secret和SecurityToken發送給使用方。
- 使用方使用上述臨時密鑰訪問Tablestore服務。
初始化對接
擷取到AccessKey ID和AccessKey Secret後,您可以按照如下步驟進行初始化對接。
- 使用Tablestore的Endpoint建立Client。使用樣本
$otsClient = new Aliyun\OTS\OTSClient(array( 'EndPoint' => "<your endpoint>", 'AccessKeyID' => "<your access id>", 'AccessKeySecret' => "<your access key>", 'InstanceName' => "<your instance name>" ));
- 配置OTSClient。 如果您需要修改OTSClient的一些預設配置,請在構造OTSClient時傳入對應參數,例如代理、連線逾時、最大串連數等參數。 具體設定的參數見下表。
參數 描述 預設值 ConnectionTimeout 與OTS建立串連的最大延時。 2.0秒 StsToken 臨時訪問的token。 null SocketTimeout 每次請求響應最大延時。 2.0秒,傳輸量比較大的時候,建議設定大些。 RetryPolicy 重試策略。 DefaultRetryPolicy,設定為null可以關閉。 ErrorLogHandler Error層級Tlog函數,用來列印Tablestore服務端返回錯誤時的日誌。 defaultOTSErrorLogHandler,設定為null可以關閉。 DebugLogHandler Debug層級Tlog函數,用來列印正常的請求和響應資訊。 defaultOTSDebugLogHandler,設定為null可以關閉。
HTTPS
安裝OpenSSL PHP擴充即可。