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

Tablestore Client是表格存储的客户端，它提供了一系列的方法，可以用来操作表格存储的表和数据。本文介绍如何在PHP中进行Tablestore Client的初始化。

重要

本文以阿里云账号的AccessKey为例为您介绍如何初始化Tablestore Client，如果您想使用RAM用户的访问密钥或STS临时访问凭证进行初始化，请参见使用RAM用户访问密钥访问表格存储和使用STS临时访问凭证访问表格存储。

准备工作

初始化Tablestore Client前，您需要获取实例的相关信息、安装Tablestore SDK并配置访问凭证。

获取实例信息

地域ID：实例所在的地域ID，例如华东1（杭州）的地域ID为cn-hangzhou，更多地域信息请参见地域。
实例名称和服务地址Endpoint：每个表格存储实例对应一个服务地址（Endpoint），应用程序进行表和数据操作时需要指定服务地址，获取方式如下。
1. 登录表格存储控制台。
2. 在页面上方，选择资源组和地域。
3. 在概览页面，单击实例别名或在操作列单击实例管理。
4. 在实例详情页签，查看实例的名称和服务地址。

安装Tablestore SDK

具体操作，请参见安装Tablestore SDK。

配置访问凭证

使用Tablestore SDK发起请求访问表格存储，您需要配置访问凭证，阿里云服务会通过访问凭证验证您的身份信息和访问权限。

本文以阿里云账号的AccessKey为例为您介绍如何配置访问凭证。AccessKey的获取方式，请参见如何获取AccessKey。

直接在代码中保存访问凭证容易导致信息泄露，建议您将访问凭证保存在系统环境变量中。

Windows

以管理员身份运行命令提示符，执行以下命令。

# 配置 AccessKey ID
setx TABLESTORE_ACCESS_KEY_ID your_access_key_id /m
# 配置 AccessKey Secret
setx TABLESTORE_ACCESS_KEY_SECRET your_access_key_secret /m

macOS/Linux/Unix

# 配置 AccessKey ID
export TABLESTORE_ACCESS_KEY_ID=your_access_key_id
# 配置 AccessKey Secret
export TABLESTORE_ACCESS_KEY_SECRET=your_access_key_secret

更多关于配置访问凭证的信息，请参见配置访问凭证。

初始化Client

您需要先初始化一个Client，然后调用该Client的方法来访问表格存储服务。表格存储PHP SDK提供了宽表模型客户端OTSClient。

重要

如果要使用HTTPS协议访问表格存储资源，请确保已安装OpenSSL PHP扩展。

宽表模型

以下示例代码用于初始化Tablestore Client，获取实例中的所有数据表名称并打印到控制台。

<?php
// 此处为相对路径，请根据实际情况进行调整。
require (__DIR__ . '/../../vendor/autoload.php');

use Aliyun\OTS\OTSClient as OTSClient;

// yourInstanceName 填写您的实例名称
$instanceName = "yourInstanceName";
// yourEndpoint 填写您的实例访问地址
$endpoint = "yourEndpoint";
// 获取系统变量里的 AccessKey ID 和 AccessKey Secret
$accessKeyId = getenv('TABLESTORE_ACCESS_KEY_ID');
$accessKeySecret = getenv('TABLESTORE_ACCESS_KEY_SECRET');

// 初始化 Tablestore Client
$otsClient = new OTSClient(array(
    'EndPoint' => $endpoint,
    'AccessKeyID' => $accessKeyId,
    'AccessKeySecret' => $accessKeySecret,
    'InstanceName' => $instanceName,
));

// 列出实例中的数据表列表并打印到控制台
$response = $otsClient->listTable (array ());
print json_encode ($response);