前提条件
- 已获取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的步骤如下:
- 在项目的根目录运行
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目录中单独运行某个示例文件。