安裝表格存儲PHP SDK
安裝表格存儲PHP SDK后,即可在編寫代碼時(shí)調(diào)用表格存儲SDK的接口。本文介紹如何安裝表格存儲PHP SDK。
環(huán)境準(zhǔn)備
已安裝64位的PHP 5.5及之后版本。
通過
php -v
命令查看當(dāng)前的PHP版本。由于表格存儲里的整型是64位的,而32位PHP只能用string表示64位的整型,所以暫不支持32位PHP;由于Windows系統(tǒng)中PHP7之前的版本整型不是真正的64位,如果要使用Windows系統(tǒng),請升級至PHP7或者自行改造,強(qiáng)烈建議使用PHP7以獲得最佳性能。
已安裝OpenSSL擴(kuò)展。
當(dāng)需要使用HTTPS時(shí),請安裝OpenSSL PHP擴(kuò)展。
已安裝PHP開發(fā)工具,例如Eclipse for PHP等。
建議已安裝CURL擴(kuò)展。
通過
php -m
命令查看CURL擴(kuò)展是否已經(jīng)安裝好。說明在Ubuntu系統(tǒng)中,使用apt-get包管理器安裝PHP的CURL擴(kuò)展。具體命令為
sudo apt-get install php-curl
。在CentOS系統(tǒng)中,使用yum包管理器安裝PHP的CURL擴(kuò)展。具體命令為
sudo yum install php-curl
。
安裝方式
您可以通過composer方式或者下載源碼方式安裝表格存儲PHP SDK。
通過composer方式安裝
composer方式安裝SDK的步驟如下:
在項(xiàng)目的根目錄運(yùn)行
composer require aliyun/aliyun-tablestore-sdk-php
,或者在composer.json中聲明對阿里云Tablestore SDK for PHP的依賴。說明關(guān)于PHP SDK的歷史版本信息,請參見PHP SDK歷史迭代版本。
{ "require": { "aliyun/aliyun-tablestore-sdk-php": "^5.1" } }
通過
composer install
命令安裝依賴。安裝完成后,目錄結(jié)構(gòu)如下:. ├── app.php ├── composer.json ├── composer.lock └── vendor
其中app.php是用戶的應(yīng)用程序,
vendor/
目錄下包含了所依賴的庫。您需要在app.php中引入依賴。require_once __DIR__ . '/vendor/autoload.php';
說明如果您的項(xiàng)目中已經(jīng)引用過autoload.php,則加入了SDK的依賴之后,不需要再次引入。
如果使用composer出現(xiàn)網(wǎng)絡(luò)錯(cuò)誤,可以使用composer中國區(qū)的鏡像。方法是在命令行中執(zhí)行
composer config -g repo.packagist composer https://developer.aliyun.com/composer
命令。
通過下載源碼包安裝
如果需要源碼包,請通過如下方式下載。
示例程序
Tablestore PHP SDK提供豐富的示例程序,方便用戶參考或直接使用。
您可以通過如下兩種方式獲取示例程序。
下載Tablestore PHP SDK開發(fā)包后,解壓后examples為示例程序。
訪問Tablestore PHP SDK的GitHub項(xiàng)目。具體路徑請參見aliyun-tablestore-php-sdk。
您可以按照以下步驟運(yùn)行示例程序。
解壓下載的SDK包。
修改examples目錄中的ExampleConfig.php文件。
EXAMPLE_END_POINT:是訪問表格存儲服務(wù)中Instance的服務(wù)地址,例如https://sun.cn-hangzhou.ots.aliyuncs.com。 EXAMPLE_ACCESS_KEY_ID:是從阿里云獲取的AccessKeyId。 EXAMPLE_ACCESS_KEY_SECRET:是從阿里云獲取的AccessKeySecret。 EXAMPLE_INSTANCE_NAME:是運(yùn)行示例程序使用的Instance,示例程序會在該Instance中進(jìn)行操作。
在examples目錄中單獨(dú)運(yùn)行某個(gè)示例文件。
下表列舉了常見的示例程序,請根據(jù)實(shí)際需要使用。
功能模塊
示例文件
示例內(nèi)容
初始化操作
展示了設(shè)置默認(rèn)Client的用法。
展示了設(shè)置Client的自定義配置用法。
展示了Client關(guān)閉Log的用法。
展示了Client設(shè)置自定義Log的用法。
數(shù)據(jù)表操作
展示了CreateTable的用法。
展示了DeleteTable的用法。
展示了DescribeTable的用法。
展示了ListTable的用法。
展示了UpdateTable的用法。
展示了ComputeSplitPointsBySize的用法。
展示了自增列的完整用法。
基礎(chǔ)數(shù)據(jù)操作
展示了PutRow的用法。
展示了PutRow條件更新的用法。
展示了UpdateRow中PUT的用法。
展示了UpdateRow中DELETE_ALL的用法。
展示了UpdateRow中DELETE的用法。
展示了UpdateRow條件更新的用法。
展示了GetRow的用法。
展示了GetRow中設(shè)置column_to_get的用法。
展示了GetRow進(jìn)行條件過濾的用法。
展示了GetRow進(jìn)行復(fù)雜條件過濾的用法。
展示了DeleteRow的用法。
展示了DeleteRow進(jìn)行條件刪除的用法。
展示了BatchGetRow獲取單表多行的用法。
展示了BatchGetRow獲取多表多行的用法。
展示了BatchGetRow獲取單表多行同時(shí)制定獲取特定列的用法。
展示了BatchGetRow如何處理返回結(jié)果的用法。
展示了BatchGetRow的同時(shí)進(jìn)行條件過濾的用法。
展示了BatchWriteRow中多個(gè)PUT的用法。
展示了BatchWriteRow中多個(gè)UPDATE的用法。
展示了BatchWriteRow中多個(gè)DELETE的用法。
展示了BatchWriteRow中混合進(jìn)行UPDATE、PUT、DELETE的用法。
展示了BatchWriteRow的同時(shí)進(jìn)行條件更新的用法。
展示了GetRange的用法。
展示了GetRange指定獲取列的用法。
展示了GetRange指定獲取行數(shù)限制的用法。
展示了GetRange同時(shí)進(jìn)行條件過濾的用法。
多元索引操作
展示了CreateSearchIndex的用法。
展示了DeleteSearchIndex的用法。
展示了DescribeSearchIndex的用法。
展示了ListSearchIndex的用法。
展示了UpdateSearchIndex的用法。
展示了多元索引多條件組合查詢BoolQuery的用法。
展示了多元索引列存在性查詢ExistsQuery的用法。
展示了多元索引地理長方形范圍查詢GeoBoundingBoxQuery的用法。
展示了多元索引地理距離查詢SearchGeoDistanceQuery的用法。
展示了多元索引地理多邊形范圍查詢GeoPolygonQuery的用法。
展示了多元索引全匹配查詢MatchAllQuery的用法。
展示了多元索引短語匹配查詢MatchPhraseQuery的用法。
展示了多元索引匹配查詢MatchQuery的用法。
展示了多元索引嵌套類型查詢NestedQuery的用法。
展示了多元索引前綴查詢PrefixQuery的用法。
展示了多元索引范圍查詢RangeQuery的用法。
展示了多元索引精確查詢TermQuery的用法。
展示了多元索引多詞精確查詢TermsQuery的用法。
展示了多元索引通配符查詢WildcardQuery的用法。
展示了多元索引統(tǒng)計(jì)聚合的用法。
SQL查詢操作
展示了使用SQL查詢數(shù)據(jù)的用法。
展示了使用SQL查詢時(shí)序數(shù)據(jù)的用法。