README

Aliyun Tablestore SDK for PHP，用于通过 PHP 访问阿里云表格存储（Tablestore）服务。

版本兼容性

升级提示：如果你正在使用 PHP 8.2 或更高版本，建议升级到 SDK 6.x 以获得最佳兼容性和性能。如果你仍在使用 PHP 5.5 ~ 8.1，请继续使用 SDK 5.x 版本。

仅支持 64 位 PHP 系统。

环境要求

• PHP >= 8.2（64 位）
• 扩展：curl、openssl、json
• Composer

安装

通过 Composer 安装（推荐）

composer require aliyun/aliyun-tablestore-sdk-php

如果你需要安装旧版本以兼容低版本 PHP：

# 安装 5.x 版本（支持 PHP 5.5 ~ 8.1）
composer require aliyun/aliyun-tablestore-sdk-php:^5.0

手动安装

1. 下载 SDK 并解压到本地。

2. 安装依赖：

   composer install --no-dev

3. 在你的 PHP 代码中引入自动加载文件：

   require_once 'vendor/autoload.php';

快速开始

<?php
require_once 'vendor/autoload.php';

use Aliyun\OTS\OTSClient;

$client = new OTSClient([
    'EndPoint' => 'https://your-instance.cn-hangzhou.ots.aliyuncs.com',
    'AccessKeyID' => 'your-access-key-id',
    'AccessKeySecret' => 'your-access-key-secret',
    'InstanceName' => 'your-instance-name',
]);

// 列出所有表
$tables = $client->listTable([]);
print_r($tables);

PHP 配置建议

在 php.ini 中进行以下配置（执行 php --ini 可查看配置文件位置）：

; 设置时区
date.timezone = Asia/Shanghai

; 建议将内存限制设置为 512M 或更高（GetRange 等接口可能占用较多内存）
memory_limit = 512M

运行示例程序

1. 修改 examples/ExampleConfig.php，填写你的 Tablestore 配置信息。

2. 运行示例：

   php examples/PKAutoIncrment.php

更多示例请参考 examples/ 目录。

运行测试

1. 安装依赖：

   composer install

2. 设置环境变量：

   export SDK_TEST_ACCESS_KEY_ID=your-access-key-id
   export SDK_TEST_ACCESS_KEY_SECRET=your-access-key-secret
   export SDK_TEST_END_POINT=https://your-instance.cn-hangzhou.ots.aliyuncs.com
   export SDK_TEST_INSTANCE_NAME=your-instance-name

3. 执行测试：

   php vendor/bin/phpunit

文档

• Tablestore 产品文档
• API 参考文档（HTML 格式，请在浏览器中打开）

变更日志

详见 CHANGELOG.md。

贡献

我们非常欢迎社区贡献代码。如果你发现了 Bug 或有功能建议，请提交 Issue 或 Pull Request。

许可证

本项目基于 MIT 许可证 开源。

联系我们

• 阿里云 Tablestore 官方网站
• 阿里云 Tablestore 文档中心
• 阿里云工单系统

扫码加入 Tablestore 讨论群

欢迎通过钉钉加入交流群：

• 为互联网应用、大数据、社交应用等开发者提供的最新技术交流群 36165029092（表格存储技术交流群-3）。
• 为物联网和时序模型开发者提供的技术交流群有44327024（物联网存储 IoTstore 开发者交流群）。