OTSClient是表格存儲服務的客戶端,它為調用者提供了一系列的方法,可以用來操作表、讀寫單行數據、讀寫多行數據等。使用PHP SDK發起請求,您需要初始化一個OTSClient實例,并根據需要修改OTSClientConfig的默認配置項。
注意事項
如果要使用HTTPs協議訪問表格存儲資源,請安裝OpenSSL PHP擴展。
準備工作
初始化OTSClient前,您需要完成獲取實例Endpoint、安裝表格存儲PHP SDK和配置訪問憑證的準備工作。
獲取實例Endpoint
創建實例后,您需要獲取實例域名地址(Endpoint)用于后續通過Endpoint訪問實例。
Endpoint是阿里云表格存儲服務各個實例的域名地址,例如https://sun.cn-hangzhou.ots.aliyuncs.com
,表示使用HTTPS協議通過公網網絡訪問華東1(杭州)地域的sun實例。更多信息,請參見服務地址。
安裝表格存儲PHP SDK
具體操作,請參見安裝表格存儲PHP SDK。
配置訪問憑證
要接入阿里云的表格存儲服務,您需要擁有一個有效的訪問密鑰進行簽名認證。具體操作,請參見配置訪問憑證。
初始化OTSClient
使用表格存儲的SDK時,您必須首先構造一個OTSClient,通過調用該OTSClient的接口來訪問表格存儲服務。
示例
使用AK初始化
運行本代碼示例之前,請確保已設置環境變量OTS_AK_ENV
和OTS_SK_ENV
。更多信息,請參見配置訪問憑證。
$accessKeyId = getenv('OTS_AK_ENV');
$accessKeySecret = getenv('OTS_SK_ENV');
$otsClient = new Aliyun\OTS\OTSClient(array(
'EndPoint' => "<yourEndpoint>",
'AccessKeyID' => $accessKeyId,
'AccessKeySecret' => $accessKeySecret,
'InstanceName' => "<yourInstance>"
));
配置參數說明請參見下表。
參數 | 示例 | 說明 |
EndPoint | https://myinstance.cn-hangzhou.ots.aliyuncs.com | 實例的訪問地址。具體操作,請參見獲取實例Endpoint。 |
AccessKeyID | getenv('OTS_AK_ENV') | 通過環境變量獲取AccessKey,請確保已配置相應環境變量。 |
AccessKeySecret | getenv('OTS_SK_ENV') | |
InstanceName | myinstance | 實例名稱。更多信息,請參見實例。 |
ConnectionTimeout | 2.0 | 與OTS建立連接的最大延時。默認值為2.0秒。 |
SocketTimeout | 2.0 | 每次請求響應的最大延時。默認值為2.0秒。 當傳輸量比較大時,建議將此參數值設置的大些。 |
RetryPolicy | DefaultRetryPolicy | 重試策略。默認配置為DefaultRetryPolicy。 如果要關閉重試策略,將此參數設置為null即可。 |
DebugLogHandler | defaultOTSDebugLogHandler | Debug級別日志處理函數,用來打印正常的請求和響應信息。默認配置為defaultOTSDebugLogHandler。 如果要關閉Debug級別的日志打印,設置此參數為null即可。 |
ErrorLogHandler | defaultOTSErrorLogHandler | Error級別日志處理函數,用來打印表格存儲服務端返回錯誤時的日志。默認配置為defaultOTSErrorLogHandler。 如果要關閉Error級別的日志打印,設置此參數為null即可。 |
使用STS初始化
運行本代碼示例之前,請確保已設置環境變量OTS_AK_ENV
、OTS_SK_ENV
和 OTS_SESSION_TOKEN
。更多信息,請參見配置訪問憑證。
$accessKeyId = getenv('OTS_AK_ENV');
$accessKeySecret = getenv('OTS_SK_ENV');
$securityToken = getenv('OTS_SESSION_TOKEN');
$otsClient = new Aliyun\OTS\OTSClient(array(
'EndPoint' => "<yourEndpoint>",
'AccessKeyID' => $accessKeyId,
'AccessKeySecret' => $accessKeySecret,
'InstanceName' => "<yourInstance>",
'StsToken' => $securityToken
));
配置參數說明請參見下表。
參數 | 示例 | 說明 |
EndPoint | https://myinstance.cn-hangzhou.ots.aliyuncs.com | 實例的訪問地址。具體操作,請參見獲取實例Endpoint。 |
AccessKeyID | getenv('OTS_AK_ENV') | 通過環境變量獲取AccessKey和STS Token,請確保已配置相應環境變量。 |
AccessKeySecret | getenv('OTS_SK_ENV') | |
StsToken | getenv('OTS_SESSION_TOKEN') | |
InstanceName | myinstance | 實例名稱。更多信息,請參見實例。 |
ConnectionTimeout | 2.0 | 與OTS建立連接的最大延時。默認值為2.0秒。 |
SocketTimeout | 2.0 | 每次請求響應最大延時。默認值為2.0秒。 當傳輸量比較大時,建議將此參數值設置的大些。 |
RetryPolicy | DefaultRetryPolicy | 重試策略。默認配置為DefaultRetryPolicy。 如果要關閉重試策略,將此參數設置為null即可。 |
DebugLogHandler | defaultOTSDebugLogHandler | Debug級別日志處理函數,用來打印正常的請求和響應信息。默認配置為defaultOTSDebugLogHandler。 如果要關閉Debug級別的日志打印,設置此參數為null即可。 |
ErrorLogHandler | defaultOTSErrorLogHandler | Error級別日志處理函數,用來打印表格存儲服務端返回錯誤時的日志。默認配置為defaultOTSErrorLogHandler。 如果要關閉Error級別的日志打印,設置此參數為null即可。 |