このガイドは、 Amazon Relational Database Service のためのニフティクラウド SDK for PHP クライアントにフォーカスしています。 このガイドでは、 ニフティクラウド SDK for PHPをダウンロードしインストールが既に終わっていると想定しています。 はじめる場合のより詳細な情報は インストール を参照して下さい。
利用可能なすべてのメソッドおよび入出力の記述についてのより詳細な情報を得るためには ニフティクラウド API リファレンス または Amazon Relational Database Service クライアント API リファレンス を参照して下さい。
まず以下のような方法のいずれかで、クライアントオブジェクトを作成しなければなりません。
Aws\Rds\RdsClient::factory()
メソッドを利用することで、最も簡単に立ち上げ速やかに動かすことができます。その際にクレデンシャル (key
and secret
) を提供して下さい。
region
パラメータも必須で、以下の値のいずれかをセットしなければなりません。: us-east-1
, ap-northeast-1
, sa-east-1
, ap-southeast-1
, ap-southeast-2
, us-west-2
, us-gov-west-1
, us-west-1
, eu-west-1
use Aws\Rds\RdsClient;
$client = RdsClient::factory(array(
'key' => '<aws access key>',
'secret' => '<aws secret key>',
'region' => '<region name>'
));
先の例のようにしてアクセスキーをセットすることができます。また、もし、 AWS Identity and Access Management (IAM) roles for EC2 instances を利用しているか、環境変数 AWS_ACCESS_KEY_ID
と AWS_SECRET_ACCESS_KEY
からクレデンシャル情報を利用できるのであれば、これらの設定を省略することも可能です。
より確実に Amazon Relational Database Service に接続する方法はサービスロケータを通す方法です。 設定ファイルの中でクレデンシャルと設定値を指定することができます。 これらの設定はすべてのクライアントで共有されるので一度だけ設定を行えばよくなります。
use Aws\Common\Aws;
// Create a service builder using a configuration file
$aws = Aws::factory('/path/to/my_config.json');
// Get the client from the builder by namespace
$client = $aws->get('Rds');
このガイドは不完全です
このガイドは、完成しておりません。もし、 SDK や AWS PHP コミュニティのへのよい貢献方法を探しているならば、 手始めにドキュメントを書く手助けをすることはとてもよい方法です。 ガイドは ReStructuredText で記述され、 Sphinx を用いて生成されています。 気兼ねなくドキュメントにコンテンツを追加し、 https://github.com/aws/aws-sdk-php まで pull request を 送って下さい。 ドキュメントのソースは https://github.com/aws/aws-sdk-php/tree/master/docs で見ることが可能です。