安装表格存储PHP SDK

安装表格存储PHP SDK后,即可在编写代码时调用表格存储SDK的接口。本文介绍如何安装表格存储PHP SDK。

环境准备

  • 已安装64位的PHP 5.5及之后版本。

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

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

  • 已安装OpenSSL扩展。

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

  • 已安装PHP开发工具,例如Eclipse for PHP等。

  • 建议已安装CURL扩展。

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

    说明
    • Ubuntu系统中,使用apt-get包管理器安装PHPCURL扩展。具体命令为sudo apt-get install php-curl

    • CentOS系统中,使用yum包管理器安装PHPCURL扩展。具体命令为sudo yum install php-curl

安装方式

您可以通过composer方式或者下载源码方式安装表格存储PHP SDK。

通过composer方式安装

composer方式安装SDK的步骤如下:

  1. 在项目的根目录运行composer require aliyun/aliyun-tablestore-sdk-php,或者在composer.json中声明对阿里云Tablestore SDK for PHP的依赖。

    说明

    关于PHP SDK的历史版本信息,请参见PHP SDK历史迭代版本

    {
        "require": {
            "aliyun/aliyun-tablestore-sdk-php": "^5.1"
        }
    }
  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 SDKGitHub项目。具体路径请参见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的用法。

    PKAutoIncrment.php

    展示了自增列的完整用法。

    基础数据操作

    PutRow.php

    展示了PutRow的用法。

    PutRowWithColumnFilter.php

    展示了PutRow条件更新的用法。

    UpdateRow1.php

    展示了UpdateRowPUT的用法。

    UpdateRow2.php

    展示了UpdateRowDELETE_ALL的用法。

    UpdateRow3.php

    展示了UpdateRowDELETE的用法。

    UpdateRowWithColumnFilter.php

    展示了UpdateRow条件更新的用法。

    GetRow.php

    展示了GetRow的用法。

    GetRow2.php

    展示了GetRow中设置column_to_get的用法。

    GetRowWithSingleColumnFilter.php

    展示了GetRow进行条件过滤的用法。

    GetRowWithMultipleColumnFilter.php

    展示了GetRow进行复杂条件过滤的用法。

    DeleteRow.php

    展示了DeleteRow的用法。

    DeleteRowWithColumnFilter.php

    展示了DeleteRow进行条件删除的用法。

    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同时进行条件过滤的用法。

    多元索引操作

    CreateSearchIndex.php

    展示了CreateSearchIndex的用法。

    DeleteSearchIndex.php

    展示了DeleteSearchIndex的用法。

    DescribeSearchIndex.php

    展示了DescribeSearchIndex的用法。

    ListSearchIndex.php

    展示了ListSearchIndex的用法。

    UpdateSearchIndex.php

    展示了UpdateSearchIndex的用法。

    SearchBoolQuery.php

    展示了多元索引多条件组合查询BoolQuery的用法。

    SearchExistsQuery.php

    展示了多元索引列存在性查询ExistsQuery的用法。

    SearchGeoBoundingBoxQuery.php

    展示了多元索引地理长方形范围查询GeoBoundingBoxQuery的用法。

    SearchGeoDistanceQuery.php

    展示了多元索引地理距离查询SearchGeoDistanceQuery的用法。

    SearchGeoPolygonQuery.php

    展示了多元索引地理多边形范围查询GeoPolygonQuery的用法。

    SearchMatchAllQuery.php

    展示了多元索引全匹配查询MatchAllQuery的用法。

    SearchMatchPhraseQuery.php

    展示了多元索引短语匹配查询MatchPhraseQuery的用法。

    SearchMatchQuery.php

    展示了多元索引匹配查询MatchQuery的用法。

    SearchNestedQuery.php

    展示了多元索引嵌套类型查询NestedQuery的用法。

    SearchPrefixQuery.php

    展示了多元索引前缀查询PrefixQuery的用法。

    SearchRangeQuery.php

    展示了多元索引范围查询RangeQuery的用法。

    SearchTermQuery.php

    展示了多元索引精确查询TermQuery的用法。

    SearchTermsQuery.php

    展示了多元索引多词精确查询TermsQuery的用法。

    SearchWildcardQuery.php

    展示了多元索引通配符查询WildcardQuery的用法。

    AggsAndGroupBys.php

    展示了多元索引统计聚合的用法。

    SQL查询操作

    SQLQuery.php

    展示了使用SQL查询数据的用法。

    SQLQueryTimeseries.php

    展示了使用SQL查询时序数据的用法。