PHP のOData SDK を使用したRedis のデータのクエリ

加藤龍彦
デジタルマーケティング

API Server とOData PHP SDK を使用して、エンティティをオブジェクトとしてモデリングすることでPHP でRedis エンティティを手軽に使用。

CData API Server は、ADO.NET Provider for Redis（またはその他の250+ ADO.NET Providers のデータ）と組み合わせることでWeb サービスとしてRedis のデータを公開します。下記の手順に従って、Redis のデータをオブジェクトとして使用します。

API Server の設定

以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなRedis OData サービスを作成していきましょう。

Redis への接続

PHP からRedis のデータを操作するには、まずRedis への接続を作成・設定します。

API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「Redis」を選択します。
事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
CData コネクタの追加方法はこちら >>
それでは、Redis への接続設定を行っていきましょう！
次の接続プロパティを設定し、Redis インスタンスに接続します。
- Server: Redis インスタンスが実行されているサーバーの名前またはアドレスに設定します。Port でポートを指定できます。
- Password: Redis AUTH コマンドを使用するパスワード保護されたRedis インスタンスへの認証に使用されるパスワードに設定します。
UseSSL を設定すると、接続時にSSL/TLS 暗号化をネゴシエートできます。
接続情報の入力が完了したら、「保存およびテスト」をクリックします。

次の接続プロパティを設定し、Redis インスタンスに接続します。

Server: Redis インスタンスが実行されているサーバーの名前またはアドレスに設定します。Port でポートを指定できます。
Password: Redis AUTH コマンドを使用するパスワード保護されたRedis インスタンスへの認証に使用されるパスワードに設定します。

UseSSL を設定すると、接続時にSSL/TLS 暗号化をネゴシエートできます。

API Server のユーザー設定

次に、API Server 経由でRedis にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。

「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。

Redis 用のAPI エンドポイントの作成

ユーザーを作成したら、Redis のデータ用のAPI エンドポイントを作成していきます。

まず、「API」ページに移動し、「テーブルを追加」をクリックします。
アクセスしたい接続を選択し、次へをクリックします。
接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。

OData のエンドポイントを取得

以上でRedis への接続を設定してユーザーを作成し、API Server でRedis データのAPI を追加しました。これで、OData 形式のRedis データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。

次の接続プロパティを設定し、Redis インスタンスに接続します。

Server: Redis インスタンスが実行されているサーバーの名前またはアドレスに設定します。Port でポートを指定できます。
Password: Redis AUTH コマンドを使用するパスワード保護されたRedis インスタンスへの認証に使用されるパスワードに設定します。

UseSSL を設定すると、接続時にSSL/TLS 暗号化をネゴシエートできます。

さらに、OData SDK for PHP との互換性のためにAPI Server を構成します。「Settings」をクリックし、OData セクションで「デフォルトバージョン」を2.0 に設定します。

API Server に接続するユーザーの認証トークンを取得

作成するOData サービスを決定したら、「Users」をクリックして任意のユーザーをクリックし、ユーザーの認証トークンを取得します。API Server は、認証トークンベースの認証を使用して、主要な認証スキームをサポートします。SSL を使用すれば、接続の認証だけでなく、暗号化も可能です。IP アドレスを使用してアクセスを制限することも可能です。デフォルトでは、ローカルマシンからの接続のみが許可されます。

わかりやすくするために、URL に認証トークンを設定してAPI Server への認証を行います。これはデフォルトでは有効になっていないため、API Server の構成ファイルであるsettings.cfg に以下の行を追加する必要があります。

[Application]
AllowAuthTokenInUrl = true

settings.cfg ファイルはデータディレクトリに配置されています。.NET 版では、www の下のapp_data フォルダがデータディレクトリになっています。Java 版でのデータディレクトリの位置は、OS によって変わります。

Windows：C:\ProgramData\CData\Redis\
Unix or Mac OS X：~/cdata/Redis/

Redis エンティティをPHP オブジェクトとして使用する

以下のステップに従ってOData PHP SDK を使用し、API Server によって公開されるWeb サービスに接続するプロキシクラスを作成します。

以下のようなコマンドにURL を渡します。
```
php C:\PHPLib\ODataphp\PHPDataSvcUtil.php /uri=https://your-server:8032/api.rsc/@your-authtoken/ /out=C:\PHPLib\ODataphp\RedisEntities.php
```
上記のコマンドは、OData エンドポイントからのレスポンスで返されたメタデータからクラスを定義し、指定したフォルダにクラス定義を出力します。

API Server とOData SDK for PHP は、フォーム認証とWindows 認証をサポートします。API Server は、認証トークンを使用してOData エンドポイントへのアクセスを許可されたユーザーを認証します。HTTP Basic 認証で認証トークを指定するか、OData URL に追加することができます。

許可されたユーザーは、API Server の「Users」セクションで設定できます。

PHP のオブジェクト指向インターフェースを使用して、Redis のデータへのアクセスを開始できます。以下のコードは、Customers テーブルのレコードを作成し、リアルタイムデータを取得して、新しく作成されたレコードを表示します。

require_once 'RedisEntities.php';
try{
  $svc = new CData();
  $customers = new Customers();
  $customers->Country = 'US';
  $svc->AddToCustomers($customers);
  $svc->SetSaveChangesOptions(SaveChangesOptions::None);
  $svc->SaveChanges();
  $response = $svc->customers()->Execute();
  foreach($response->Result as $customers)
    echo $customers->City."";
} catch (Exception $e) {    //catch errors from the API Server
  echo $e->getError(), "\n";
}

はじめる準備はできましたか？

詳細はこちら、または無料トライアルにお申し込みください：

CData API Server お問い合わせ