PHP 用 Tablestore SDK のインストール - Tablestore - Alibaba Cloud ドキュメントセンター

PHP 用 Tablestore SDK をインストールすると、コードを記述する際に SDK の操作を呼び出すことができます。このトピックでは、PHP 用 Tablestore SDK をインストールする方法について説明します。

前提条件

64 ビット版の PHP 5.5 以降がインストールされていること。
php -v コマンドを実行して、現在の PHP バージョンを確認できます。
Tablestore は 64 ビット整数を使用します。ただし、32 ビット版の PHP では、STRING 型のみを使用して 64 ビットの INTEGER 値を表すことができます。そのため、Tablestore は 32 ビット版の PHP をサポートしていません。Windows では、PHP 7 より前の PHP バージョンは実際には 64 ビットではありません。Windows で PHP を実行する場合は、PHP を PHP 7 にアップグレードするか、環境を自分で変更する必要があります。最適なパフォーマンスを得るには、PHP 7 を使用することをお勧めします。
OpenSSL 拡張機能がインストールされていること。
HTTPS を使用する場合は、OpenSSL PHP 拡張機能をインストールする必要があります。
Eclipse for PHP などの PHP 開発ツールがインストールされていること。
(推奨) cURL 拡張機能がインストールされていること。
php -m コマンドを実行して、cURL 拡張機能がインストールされているかどうかを確認できます。
説明
- Ubuntu では、sudo apt-get install php-curl コマンドを実行して、apt-get を使用して PHP の cURL 拡張機能をインストールできます。
- CentOS では、sudo yum install php-curl コマンドを実行して、YUM を使用して PHP の cURL 拡張機能をインストールできます。

インストール方法

Composer を使用するか、ソースコードをダウンロードして、PHP 用 Tablestore SDK をインストールできます。

Composer を使用する

Composer を使用して PHP 用 Tablestore SDK をインストールするには、次の手順を実行します。

プロジェクトのルートディレクトリで composer require aliyun/aliyun-tablestore-sdk-php コマンドを実行するか、composer.json ファイルで PHP 用 Tablestore SDK への依存関係を宣言します。
説明
PHP 用 Tablestore SDK のバージョン履歴については、PHP 用 Tablestore 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 の依存関係を追加した後に autoload.php を再度インポートする必要はありません。
- Composer の使用時にネットワークエラーが発生した場合は、コマンドラインで次のコマンドを入力して、中国で利用可能な Packagist を使用できます。composer config -g repo.packagist composer https://developer.aliyun.com/composer

ソースコードをダウンロードする

次の方法を使用して、ソースコードパッケージをダウンロードできます。

GitHub から必要なバージョンのソースコードパッケージをダウンロードします。詳細については、GitHub を参照してください。
SDK パッケージからソースコードを取得します。ダウンロードパスについては、SDK ソースコードパッケージを参照してください。

サンプルプログラム

PHP 用 Tablestore SDK は、参照または使用できるさまざまなサンプルプログラムを提供しています。

次のいずれかの方法でサンプルプログラムを入手できます。

PHP 用 Tablestore SDK をダウンロードして解凍します。examples ディレクトリにあるサンプルプログラムを探します。
PHP 用 Tablestore SDK の GitHub プロジェクトにアクセスします。詳細については、aliyun-tablestore-php-sdk を参照してください。

サンプルプログラムを実行するには、次の手順を実行します。

ダウンロードした SDK パッケージを解凍します。

examples ディレクトリにある ExampleConfig.php ファイルを変更します。

EXAMPLE_END_POINT: アクセスする Tablestore インスタンスが存在するリージョンのエンドポイント。例: https://sun.cn-hangzhou.ots.aliyuncs.com。
EXAMPLE_ACCESS_KEY_ID: Alibaba Cloud から取得した AccessKey ID。
EXAMPLE_ACCESS_KEY_ID: Alibaba Cloud から取得した AccessKey シークレット。
EXAMPLE_INSTANCE_NAME: サンプルプログラムを実行するために使用するインスタンス。サンプルプログラムはこのインスタンスで操作されます。

examples ディレクトリにあるサンプルファイルを個別に実行します。

次の表は、一般的なサンプルプログラムについて説明しています。ビジネス要件に基づいてサンプルプログラムを使用してください。

モジュール	サンプルファイル	内容
初期化操作	NewClient.php	デフォルトクライアントを構成する方法を示します。
	NewClient2.php	カスタムクライアントを構成する方法を示します。
	NewClientLogClosed.php	クライアントのログを無効にする方法を示します。
	NewClientLogDefined.php	クライアントのカスタムログを構成する方法を示します。
データテーブルの操作	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	初期化操作
	SearchExistsQuery.php	検索インデックスの ExistsQuery の使用方法を示します。
	SearchGeoBoundingBoxQuery.php	カスタムクライアントを設定する方法を示します。
	SearchGeoDistanceQuery.php	クライアントのログを無効にする方法を示します。
	SearchGeoPolygonQuery.php	クライアントのカスタムログを設定する方法を示します。
	SearchMatchAllQuery.php	データテーブルの操作
	SearchMatchPhraseQuery.php	検索インデックスの MatchPhraseQuery の使用方法を示します。
	SearchMatchQuery.php	DeleteTable の使用方法を示します。
	SearchNestedQuery.php	DescribeTable の使用方法を示します。
	SearchPrefixQuery.php	ListTable の使用方法を示します。
	SearchRangeQuery.php	UpdateTable の使用方法を示します。
	SearchTermQuery.php	ComputeSplitPointsBySize の使用方法を示します。
	SearchTermsQuery.php	自動インクリメント主キー列の使用方法を示します。
	SearchWildcardQuery.php	基本的なデータ操作
	AggsAndGroupBys.php	検索インデックスの集計方法を示します。
SQLクエリ操作	SQLQuery.php	条件付き更新で PutRow を使用する方法を示します。
SQLクエリ操作	SQLQueryTimeseries.php	UpdateRow で PUT を使用する方法を示します。