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

确定Endpoint

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

示例 解释
http://sun.cn-hangzhou.ots.aliyuncs.com HTTP协议,公网网络访问杭州区域的sun实例。
https://sun.cn-hangzhou.ots.aliyuncs.com HTTPS协议,公网网络访问杭州区域的sun实例。
注意 除了公网可以访问外,也支持私网地址。更多请参见服务地址

请按照如下步骤获取实例的Endpoint:

  1. 登录表格存储管理控制台。
  2. 单击实例名称进入实例详情页。
    实例访问地址即是该实例的Endpoint。

配置密钥

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

  • 主帐号的AccessKey ID和AccessKey Secret。创建步骤如下:
    1. 在阿里云官网注册阿里云帐号
    2. 登录AccessKey管理控制台创建AccessKey ID和AccessKey Secret。
  • 被授予访问表格存储权限的子帐号的AccessKey ID和AccessKey Secret。创建步骤如下:
    1. 使用主帐号前往访问控制RAM,创建一个新的子帐号或者使用已经存在的子帐号。
    2. 使用主帐号授予子帐号访问表格存储的权限。
    3. 子帐号被授权后,即可使用自己的AccessKey ID和AccessKey Secret访问。
  • 从STS获取的临时访问凭证。获取步骤如下:
    1. 应用的服务器通过访问RAM/STS服务,获取一个临时的AccessKey ID、AccessKey Secret和SecurityToken发送给使用方。
    2. 使用方使用上述临时密钥访问表格存储服务。

初始化对接

获取到AccessKey ID和AccessKey Secret后,您可以按照如下步骤进行初始化对接。

  1. 使用表格存储的Endpoint新建Client。
    使用示例
        $otsClient = new Aliyun\OTS\OTSClient(array(
            'EndPoint' => "<your endpoint>",
            'AccessKeyID' => "<your access id>",
            'AccessKeySecret' => "<your access key>",
            'InstanceName' => "<your instance name>"
        ));
                            
  2. 配置OTSClient。
    如果您需要修改OTSClient的一些默认配置,请在构造OTSClient时传入对应参数,例如代理、连接超时、最大连接数等参数。 具体设置的参数见下表。
    参数 描述 默认值
    ConnectionTimeout 与OTS建立连接的最大延时 2.0秒
    StsToken 临时访问的token null
    SocketTimeout 每次请求响应最大延时 2.0秒,传输量比较大的时候,建议设置大些。
    RetryPolicy 重试策略 DefaultRetryPolicy,设置为null可以关闭。
    ErrorLogHandler Error级别日志处理函数,用来打印表格存储服务端返回错误时的日志。 defaultOTSErrorLogHandler,设置为null可以关闭。
    DebugLogHandler Debug级别日志处理函数,用来打印正常的请求和响应信息。 defaultOTSDebugLogHandler,设置为null可以关闭。

HTTPS

安装OpenSSL PHP扩展即可。