安装表格存储PHP SDK后,即可在编写代码时调用表格存储SDK的接口。本文介绍如何安装表格存储PHP SDK。
环境准备
已安装64位的PHP 5.5及之后版本。
通过
php -v
命令查看当前的PHP版本。由于表格存储里的整型是64位的,而32位PHP只能用string表示64位的整型,所以暂不支持32位PHP;由于Windows系统中PHP7之前的版本整型不是真正的64位,如果要使用Windows系统,请升级至PHP7或者自行改造,强烈建议使用PHP7以获得最佳性能。
已安装OpenSSL扩展。
当需要使用HTTPS时,请安装OpenSSL PHP扩展。
已安装PHP开发工具,例如Eclipse for PHP等。
建议已安装CURL扩展。
通过
php -m
命令查看CURL扩展是否已经安装好。说明在Ubuntu系统中,使用apt-get包管理器安装PHP的CURL扩展。具体命令为
sudo apt-get install php-curl
。在CentOS系统中,使用yum包管理器安装PHP的CURL扩展。具体命令为
sudo yum install php-curl
。
安装方式
您可以通过composer方式或者下载源码方式安装表格存储PHP SDK。
通过composer方式安装
composer方式安装SDK的步骤如下:
在项目的根目录运行
composer require aliyun/aliyun-tablestore-sdk-php
,或者在composer.json中声明对阿里云Tablestore SDK for PHP的依赖。"require": { "aliyun/aliyun-tablestore-sdk-php": "~5.0" }
通过
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
命令。
通过下载源码包安装
如果需要源码包,请通过如下方式下载。
示例程序
Tablestore PHP SDK提供丰富的示例程序,方便用户参考或直接使用。
您可以通过如下两种方式获取示例程序。
下载Tablestore PHP SDK开发包后,解压后examples为示例程序。
访问Tablestore PHP SDK的GitHub项目。具体路径请参见aliyun-tablestore-php-sdk。
您可以按照以下步骤运行示例程序。
解压下载的SDK包。
修改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中进行操作。
在examples目录中单独运行某个示例文件。
下表列举了常见的示例程序,请根据实际需要使用。
功能模块
示例文件
示例内容
初始化操作
展示了设置默认Client的用法。
展示了设置Client的自定义配置用法。
展示了Client关闭Log的用法。
展示了Client设置自定义Log的用法。
数据表操作
展示了CreateTable的用法。
展示了DeleteTable的用法。
展示了DescribeTable的用法。
展示了ListTable的用法。
展示了UpdateTable的用法。
展示了ComputeSplitPointsBySize的用法。
展示了自增列的完整用法。
基础数据操作
展示了PutRow的用法。
展示了PutRow条件更新的用法。
展示了UpdateRow中PUT的用法。
展示了UpdateRow中DELETE_ALL的用法。
展示了UpdateRow中DELETE的用法。
展示了UpdateRow条件更新的用法。
展示了GetRow的用法。
展示了GetRow中设置column_to_get的用法。
展示了GetRow进行条件过滤的用法。
展示了GetRow进行复杂条件过滤的用法。
展示了DeleteRow的用法。
展示了DeleteRow进行条件删除的用法。
展示了BatchGetRow获取单表多行的用法。
展示了BatchGetRow获取多表多行的用法。
展示了BatchGetRow获取单表多行同时制定获取特定列的用法。
展示了BatchGetRow如何处理返回结果的用法。
展示了BatchGetRow的同时进行条件过滤的用法。
展示了BatchWriteRow中多个PUT的用法。
展示了BatchWriteRow中多个UPDATE的用法。
展示了BatchWriteRow中多个DELETE的用法。
展示了BatchWriteRow中混合进行UPDATE、PUT、DELETE的用法。
展示了BatchWriteRow的同时进行条件更新的用法。
展示了GetRange的用法。
展示了GetRange指定获取列的用法。
展示了GetRange指定获取行数限制的用法。
展示了GetRange同时进行条件过滤的用法。
多元索引操作
展示了CreateSearchIndex的用法。
展示了DeleteSearchIndex的用法。
展示了DescribeSearchIndex的用法。
展示了ListSearchIndex的用法。
展示了UpdateSearchIndex的用法。
展示了多元索引多条件组合查询BoolQuery的用法。
展示了多元索引列存在性查询ExistsQuery的用法。
展示了多元索引地理长方形范围查询GeoBoundingBoxQuery的用法。
展示了多元索引地理距离查询SearchGeoDistanceQuery的用法。
展示了多元索引地理多边形范围查询GeoPolygonQuery的用法。
展示了多元索引全匹配查询MatchAllQuery的用法。
展示了多元索引短语匹配查询MatchPhraseQuery的用法。
展示了多元索引匹配查询MatchQuery的用法。
展示了多元索引嵌套类型查询NestedQuery的用法。
展示了多元索引前缀查询PrefixQuery的用法。
展示了多元索引范围查询RangeQuery的用法。
展示了多元索引精确查询TermQuery的用法。
展示了多元索引多词精确查询TermsQuery的用法。
展示了多元索引通配符查询WildcardQuery的用法。
展示了多元索引统计聚合的用法。
SQL查询操作
展示了使用SQL查询数据的用法。
展示了使用SQL查询时序数据的用法。