全部产品
阿里云办公

初始化

更新时间:2018-06-28 11:49:12

OTSClient 是表格存储服务的客户端,它为调用者提供了一系列的方法,可以用来操作表、读写单行数据、读写多行数据等。使用 PHP SDK 发起 TableStore 请求,您需要初始化一个 OTSClient 实例,并根据需要修改 OTSClientConfig 的默认配置项。

确定 Endpoint

Endpoint 是阿里云表格存储服务各个实例的域名地址,目前支持下列形式。

示例 解释
http://sun.cn-hangzhou.ots.aliyuncs.com HTTP 协议,公网网络访问杭州区域的 sun 实例。
https://sun.cn-hangzhou.ots.aliyuncs.com HTTPS 协议,公网网络访问杭州区域的 sun 实例。

说明:

  • 除了公网可以访问外,也支持私网地址。
  • 登录表格存储控制台,进入实例详情页,实例访问地址即是该实例的 Endpoint。

配置密钥

要接入阿里云的表格存储服务,您需要拥有一个有效的访问密钥进行签名认证。目前支持下面三种方式:

  • 主帐号的 AccessKeyId 和 AccessKeySecret。创建步骤如下:

    1. 在阿里云官网注册阿里云帐号

    2. 登录阿里云的管理控制台申请 AccessKey

  • 被授予访问表格存储权限的子帐号的 AccessKeyId 和 AccesskeySecret。创建步骤如下:

    1. 使用主帐号前往访问控制 RAM,创建一个新的子帐号或者使用已经存在的子帐号。

    2. 使用主帐号授予子帐号访问表格存储的权限。

    3. 子帐号被授权后,就可以使用自己的 AccessKeyId 和 AccessKeySecret 访问了。

  • 临时访问的 STS token。获取步骤如下:

    1. 应用的服务器通过访问 RAM/STS 服务,获取一个临时的 AccesskeyId、AccesskeySecret 和 token,发送给使用方。

    2. 使用方使用上述临时密钥访问表格存储服务。

初始化对接步骤

在获取到 AccessKeyId 和 AccessKeySecret 等密钥之后,您可以按照下面步骤进行初始化对接。

  1. 使用表格存储的 Endpoint 新建 Client。使用示例:

    1. $otsClient = new OTSClient(array(
    2. 'EndPoint' => "<your endpoint>",
    3. 'AccessKeyID' => "<your access id>",
    4. 'AccessKeySecret' => "<your access key>"
    5. 'InstanceName' => "<your instance name>"
    6. ));

    提示:

    • 除了支持 AccessKeyId 和 AccessKeySecret 外,还支持 STS token 访问。

    • 在创建 OTSClient 时,也支持通过 OTSClientConfig 参数设置一些参数,比如超时时间,最大连接数,最多重试次数等。

  2. 配置 OTSClient。

    如果您需要修改 OTSClient 的一些默认配置,请在构造 OTSClient 的时候传入对应参数,可配置代理、连接超时、最大连接数等参数。 具体设置的参数见下表:

参数 描述 默认值
ConnectionTimeout 与OTS建立连接的最大延时 2.0秒
StsToken 临时访问的token null
SocketTimeout 每次请求响应最大延时。 2.0秒,传输量比较大的时候,建议设置大些
RetryPolicy 重试策略 DefaultRetryPolicy,null可以关闭重试
ErrorLogHandler Error级别日志处理函数,用来打印OTS服务端返回错误时的日志。 defaultOTSErrorLogHandler,null可以关闭
DebugLogHandler Debug级别日志处理函数,用来打印正常的请求和响应信息。 defaultOTSDebugLogHandler,null可以关闭

HTTPS

安装OpenSSL PHP扩展即可。