全部產品
Search
文件中心

Tablestore:安裝TablestorePHP SDK

更新時間:Dec 20, 2024

安裝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的步驟如下:

  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 SDK的GitHub專案。具體路徑請參見aliyun-tablestore-php-sdk

您可以按照以下步驟運行樣本程式。

  1. 解壓下載的SDK包。

  2. 修改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中進行操作。
  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

    展示了UpdateRow中PUT的用法。

    UpdateRow2.php

    展示了UpdateRow中DELETE_ALL的用法。

    UpdateRow3.php

    展示了UpdateRow中DELETE的用法。

    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查詢時序資料的用法。