本文主要为您介绍表格存储PHP SDK包安装。

环境准备

  • 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目录中单独运行某个示例文件。

示例程序包含如下内容。

示例文件 示例内容
NewClient.php 展示了设置默认Client的用法。
NewClient2.php 展示了设置Client的自定义配置用法。
NewClientLogClosed.php 展示了Client关闭Log的用法。
NewClientLogDefined.php 展示了Client设置自定义Log的用法。
CreateTable.php 展示了CreateTable的用法。
DeleteTable.php 展示了DeleteTable的用法。
DescribeTable.php 展示了DescribeTable的用法。
ListTable.php 展示了ListTable的用法。
UpdateTable.php 展示了UpdateTable的用法。
ComputeSplitPointsBySize.php 展示了ComputeSplitPointsBySize的用法。
PutRow.php 展示了PutRow的用法。
PutRowWithColumnFilter.php 展示了PutRow条件更新的用法。
UpdateRow1.php 展示了UpdateRow中PUT的用法。
UpdateRow2.php 展示了UpdateRow中DELETE_ALL的用法。
UpdateRow3.php 展示了UpdateRow中DELETE的用法。
UpdateRowWithColumnFilter.php 展示了UpdateRow条件更新的用法。
GetRow.php 展示了GetRow的用法。
GetRow2.php 展示了GetRow中设置column_to_get的用法。
GetRowWithSingleColumnFilter.php 展示了GetRow进行条件过滤的用法。
GetRowWithMultipleColumnFilter.php 展示了GetRow进行复杂条件过滤的用法。
DeleteRow.php 展示了DeleteRow的用法。
DeleteRowWithColumnFilter.php 展示了DeleteRow进行条件删除的用法。
PKAutoIncrment.php 展示了自增列的完整用法。
BatchGetRow1.php 展示了BatchGetRow获取单表多行的用法。
BatchGetRow2.php 展示了BatchGetRow获取多表多行的用法。
BatchGetRow3.php 展示了BatchGetRow获取单表多行同时制定获取特定列的用法。
BatchGetRow4.php 展示了BatchGetRow如何处理返回结果的用法。
BatchGetRowWithColumnFilter.php 展示了BatchGetRow的同时进行条件过滤的用法。
BatchWriteRow1.php 展示了BatchWriteRow中多个PUT的用法。
BatchWriteRow2.php 展示了BatchWriteRow中多个UPDATE的用法。
BatchWriteRow3.php 展示了BatchWriteRow中多个DELETE的用法。
BatchWriteRow4.php 展示了BatchWriteRow中混合进行UPDATE、PUT、DELETE的用法。
BatchWriteRowWithColumnFilter.php 展示了BatchWriteRow的同时进行条件更新的用法。
GetRange1.php 展示了GetRange的用法。
GetRange2.php 展示了GetRange指定获取列的用法。
GetRange3.php 展示了GetRange指定获取行数限制的用法。
GetRangeWithColumnFilter.php 展示了GetRange同时进行条件过滤的用法。