PHP 用 Tablestore クライアントの初期化 - Tablestore - Alibaba Cloud ドキュメントセンター

Tablestore クライアントは、Tablestore のテーブルとデータに対する操作を実行するためのさまざまなメソッドを提供します。このトピックでは、Tablestore SDK for PHP を使用して Tablestore クライアントを初期化する方法について説明します。

重要

このトピックでは、Alibaba Cloud アカウントの AccessKey ペアを例として使用します。他の認証情報を使用してクライアントを初期化する方法については、「RAM ユーザーの AccessKey ペアを使用して Tablestore にアクセスする」および「STS からの一時的なアクセス認証情報を使用して Tablestore にアクセスする」をご参照ください。

準備

Tablestore クライアントを初期化する前に、インスタンス情報を取得し、Tablestore SDK をインストールし、アクセス認証情報を設定します。

アクセスするインスタンスに関する情報の取得

リージョン ID: インスタンスのリージョン ID。たとえば、中国 (杭州) のリージョン ID は cn-hangzhou です。
インスタンス名とエンドポイント: 各 Tablestore インスタンスには一意のエンドポイントがあります。アプリケーションは、テーブルとデータに対する操作を実行するためにエンドポイントを指定する必要があります。エンドポイントを取得するには、次の手順を実行します。
1. Tablestore コンソールにログインします。
2. 上部のナビゲーションバーで、リソースグループとリージョンを選択します。
3. [概要] ページで、インスタンスのエイリアスをクリックするか、[アクション] 列の [インスタンスの管理] をクリックします。
4. [インスタンス詳細] タブで、インスタンス名とエンドポイントを表示します。
  重要
  デフォルトでは、新しいインスタンスではインターネットアクセスが無効になっています。インターネット経由でインスタンス内のリソースにアクセスするには、インスタンスのインターネットアクセスを有効にする必要があります。

Tablestore SDK のインストール

詳細については、「Tablestore SDK for PHP のインストール」をご参照ください。

アクセス認証情報の設定

Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ペアを作成し、その AccessKey ペアを環境変数として設定します。

説明

設定が完了したら、IDE、コマンドラインインターフェイス、デスクトップアプリケーション、バックグラウンドサービスなどの開発環境を再起動またはリフレッシュして、最新のシステム環境変数を読み込みます。詳細については、「アクセス認証情報の設定」をご参照ください。

Linux

コマンドラインインターフェイスで次のコマンドを実行して、環境変数の設定を ~/.bashrc ファイルに追加します。

echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc

次のコマンドを実行して、変更を有効にします。
```
source ~/.bashrc
```
次のコマンドを実行して、環境変数が有効になっているかどうかを確認します。
```
echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET
```

macOS

ターミナルで次のコマンドを実行して、デフォルトの Shell タイプを確認します。
```
echo $SHELL
```
デフォルトの Shell タイプに基づいて操作を実行します。
Zsh
1. 次のコマンドを実行して、環境変数の設定を ~/.zshrc ファイルに追加します。
```
echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc
```
2. 次のコマンドを実行して、変更を有効にします。
```
source ~/.zshrc
```
3. 次のコマンドを実行して、環境変数が有効になっているかどうかを確認します。
```
echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET
```
Bash
1. 次のコマンドを実行して、環境変数の設定を ~/.bash_profile ファイルに追加します。
```
echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bash_profile
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bash_profile
```
2. 次のコマンドを実行して、変更を有効にします。
```
source ~/.bash_profile
```
3. 次のコマンドを実行して、環境変数が有効になっているかどうかを確認します。
```
echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET
```

Windows

CMD

CMD で次のコマンドを実行して、環境変数を設定します。

setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"

CMD を再起動した後、次のコマンドを実行して、環境変数が有効になっているかどうかを確認します。
```
echo %TABLESTORE_ACCESS_KEY_ID%
echo %TABLESTORE_ACCESS_KEY_SECRET%
```

PowerShell

PowerShell で次のコマンドを実行します。

[Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", "YOUR_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

次のコマンドを実行して、環境変数が有効になっているかどうかを確認します。

[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

クライアントの初期化

Tablestore にアクセスするには、クライアントを初期化し、クライアントが提供するメソッドを呼び出す必要があります。Tablestore SDK for Python は、Wide Column モデル用のクライアントを提供します。

重要

HTTPS 経由で Tablestore リソースにアクセスするには、OpenSSL PHP 拡張機能をインストールする必要があります。

Wide Column モデル

次のサンプルコードは、Tablestore クライアントを初期化し、インスタンス内のデータテーブルのリストをクエリし、そのリストを Tablestore コンソールに表示する方法の例を示しています。

<?php
// パスは相対パスです。必要に応じてパスを変更してください。
require (__DIR__ . '/../../vendor/autoload.php');

use Aliyun\OTS\OTSClient as OTSClient;

// yourInstanceName をインスタンスの名前に置き換えます。
$instanceName = "yourInstanceName";
// yourEndpoint をインスタンスのエンドポイントに置き換えます。
$endpoint = "yourEndpoint";
// システム変数から AccessKey ID と AccessKey シークレットを取得します。
$accessKeyId = getenv('TABLESTORE_ACCESS_KEY_ID');
$accessKeySecret = getenv('TABLESTORE_ACCESS_KEY_SECRET');

// Tablestore クライアントを初期化します。
$client = new OTSClient(array(
    'EndPoint' => $endpoint,
    'AccessKeyID' => $accessKeyId,
    'AccessKeySecret' => $accessKeySecret,
    'InstanceName' => $instanceName,
));

// インスタンス内のデータテーブルをリストし、そのリストをコンソールに出力します。
$response = $client->listTable (array ());
print json_encode ($response);

Tablestore:Tablestore クライアントの初期化

準備