PHP SDK初始化OTSClient_表格存储(Tablestore)-阿里云帮助中心

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实例。更多信息，请参见服务地址。

如果未开通表格存储服务，请进行开通。具体操作，请参见开通表格存储服务。
创建实例。具体操作，请参见创建实例。
创建实例后获取实例的Endpoint。
1. 登录表格存储控制台。
2. 在概览页面，单击实例名称。
3. 在实例详情页签的实例访问地址区域即可查看该实例的服务地址（Endpoint）。

安装表格存储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')	通过环境变量获取AccessKey，请确保已配置相应环境变量。
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即可。

常见问题

使用表格存储SDK时出现Signature mismatch异常