OTSClient是表格存储服务的客户端,它为调用者提供了一系列的方法,可以用来操作表、读写单行数据、读写多行数据等。使用PHP SDK发起请求,您需要初始化一个OTSClient实例,并根据需要修改OTSClientConfig的默认配置项。
注意事项
如果要使用HTTPs协议访问表格存储资源,请安装OpenSSL PHP扩展。
准备工作
初始化OTSClient前,您需要完成配置访问密钥、获取实例Endpoint和安装表格存储PHP SDK的准备工作。
配置访问密钥
获取实例Endpoint
安装表格存储PHP SDK
初始化对接
使用表格存储的SDK时,您必须首先构造一个OTSClient,通过调用该OTSClient的接口来访问表格存储服务。
阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。本示例以将AccessKey保存在环境变量中来实现身份验证为例介绍。
使用表格存储的Endpoint新建OTSClient。
$accessKeyId = getenv('OTS_AK_ENV'); $accessKeySecret = getenv('OTS_SK_ENV'); $otsClient = new Aliyun\OTS\OTSClient(array( 'EndPoint' => "<your endpoint>", 'AccessKeyID' => $accessKeyId, 'AccessKeySecret' => $accessKeySecret, 'InstanceName' => "<your instance name>" ));
配置参数说明请参见下表。
参数
示例
说明
EndPoint
https://myinstance.cn-hangzhou.ots.aliyuncs.com
实例的访问地址。具体操作,请参见获取实例Endpoint。
AccessKeyID
getenv('OTS_AK_ENV')
通过环境变量获取AccessKey。
请确保已配置相应环境变量。具体操作,请参见配置访问密钥。
AccessKeySecret
getenv('OTS_SK_ENV')
InstanceName
myinstance
实例名称。更多信息,请参见实例。
配置OTSClient。
如果您需要修改OTSClient的一些默认配置,请在构造OTSClient时传入对应参数,例如代理、连接超时、最大连接数等参数。 具体设置的参数见下表。
参数
描述
ConnectionTimeout
与OTS建立连接的最大延时。默认值为2.0秒。
StsToken
临时访问的token。
当使用从STS获取的临时访问凭证访问表格存储服务时,需要配置此参数。关于使用临时访问凭证的具体操作,请参见使用临时访问凭证。
SocketTimeout
每次请求响应最大延时。默认值为2.0秒。
当传输量比较大时,建议将此参数值设置的大些。
RetryPolicy
重试策略。默认配置为DefaultRetryPolicy。
如果要关闭重试策略,设置此参数为null即可。
ErrorLogHandler
Error级别日志处理函数,用来打印表格存储服务端返回错误时的日志。默认配置为defaultOTSErrorLogHandler。
如果要关闭Error级别的日志打印,设置此参数为null即可。
DebugLogHandler
Debug级别日志处理函数,用来打印正常的请求和响应信息。默认配置为defaultOTSDebugLogHandler。
如果要关闭Debug级别的日志打印,设置此参数为null即可。
常见问题
- 本页导读 (1)