安裝TablestorePHP SDK後,即可在編寫代碼時調用TablestoreSDK的介面。本文介紹如何安裝TablestorePHP SDK。
環境準備
已安裝64位的PHP 5.5及之後版本。
通過
php -v
命令查看當前的PHP版本。由於Table Store裡的整型是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方式或者下載源碼方式安裝Table StorePHP SDK。
通過composer方式安裝
composer方式安裝SDK的步驟如下:
在專案的根目錄運行
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" } }
通過
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:是訪問Table Store服務中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查詢時序資料的用法。