阿里云TableStore与Thinkphp结合使用安装

前提条件

• 已获取AccessKey（包括AccessKey ID和AccessKey Secret）。具体操作，请参见获取AccessKey。
• 已开通表格存储服务。具体操作，请参见开通表格存储服务。

注意事项

4.0.0以上版本SDK支持数据多版本和生命周期，但是该版本SDK不兼容2.x.x系列的SDK。

• 数据版本和生命周期
• 主键列自增

SDK下载

• 下载SDK安装包，具体下载路径请参见aliyun-tablestore-php-sdk-5.1.2.tar.gz。
• 从Github下载源码，具体下载路径请参见GitHub。

关于PHP SDK历史迭代版本的更多信息，请参见PHP SDK历史迭代版本。

兼容性

• 对于4.x.x系列的SDK兼容。
• 对于2.x.x系列的SDK不兼容。

版本

当前最新版本：5.1.2

环境准备

• 64位PHP 5.5+（必须）

  通过php -v命令查看当前的PHP版本。

  由于表格存储里的整型是64位的，而32位PHP只能用string表示64位的整型，所以暂不支持32位PHP；由于Windows系统中PHP7之前的版本整型不是真正的64位，如果要使用Windows系统，请升级至PHP7或者自行改造，强烈建议使用PHP7以获得最佳性能。

• cURL扩展（建议）

  通过php -m命令查看cURL扩展是否已经安装好。

  说明

  • 在Ubuntu系统中，使用apt-get包管理器安装PHP的cURL扩展sudo apt-get install php-curl。
  • 在CentOS系统中，使用yum包管理器安装PHP的cURL扩展sudo yum install php-curl。
• OpenSSL扩展（建议）

  当需要使用HTTPS时，请安装OpenSSL PHP扩展。

安装方式

• composer方式composer方式安装SDK的步骤如下：
  1. 在项目的根目录运行composer require aliyun/aliyun-tablestore-sdk-php，或者在composer.json中声明对阿里云tablestore SDK for PHP的依赖。

     "require": {
         "aliyun/aliyun-tablestore-sdk-php": "~5.0"
     }

  2. 通过composer install安装依赖。安装完成后，目录结构如下：

      .
      ├── app.php
      ├── composer.json
      ├── composer.lock
      └── vendor
                                     

     其中app.php是用户的应用程序，vendor/目录下包含了所依赖的库。您需要在app.php中引入依赖。

     require_once __DIR__ . '/vendor/autoload.php';
                                     

     说明

     • 如果您的项目中已经引用过autoload.php，则加入了SDK的依赖之后，不需要再次引入。
     • 如果使用composer出现网络错误，可以使用composer中国区的镜像。方法是在命令行执行composer config -g repo.packagist composer https://developer.aliyun.com/composer。
• 源码包如果需要源码包，请通过如下方式下载。
  • 通过GitHub选择相应版本并下载源码压缩文件。具体路径请参见GitHub。
  • 通过SDK包获取源码，具体路径请参见SDK源码包。

示例程序

Tablestore PHP SDK提供丰富的示例程序，方便用户参考或直接使用。

您可以通过如下两种方式获取示例程序。

• 下载Tablestore PHP SDK开发包后，解压后examples为示例程序。
• 访问Tablestore PHP SDK的GitHub项目。具体路径请参见aliyun-tablestore-php-sdk。

您可以通过如下步骤运行示例程序。

1. 解压下载的SDK包。
2. 修改examples目录中的ExampleConfig.php文件。

   EXAMPLE_END_POINT：是访问表格存储服务中Instance的服务地址，例如https://sun.cn-hangzhou.ots.aliyuncs.com。
   EXAMPLE_ACCESS_KEY_ID：是从阿里云获取的AccessKeyId。
   EXAMPLE_ACCESS_KEY_SECRET：是从阿里云获取的AccessKeySecret。
   EXAMPLE_INSTANCE_NAME：是运行示例程序使用的Instance，示例程序会在该Instance中进行操作。

3. 在examples目录中单独运行某个示例文件。