本文主要为您介绍表格存储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同时进行条件过滤的用法。