MongoDB クライアントの作成

項目一覧

Overview

MongoDBデプロイに接続するには、次の項目を作成する必要があります。

これらのコンポーネントのいずれかまたは両方内でオプションを設定して、 MongoDBに接続中にPHPライブラリが動作する方法をカスタマイズすることもできます。

このガイドでは、接続文字列のコンポーネントについて説明し、 MongoDB\Clientオブジェクトを使用してMongoDBデプロイに接続する方法を示します。

標準の接続stringには次のコンポーネントが含まれます。

コンポーネント	説明
`mongodb://`	必須: これを標準接続形式の文字列として識別するプレフィックス。
`db_username:db_password`	任意。認証資格情報。これらを含めると、クライアントは`authSource`で指定されたデータベースに対してユーザーを認証します。 `authSource`接続オプションの詳細については、認証メカニズムを参照してください。
`host[:port]`	必須。 MongoDB が実行されているホストとオプションのポート番号。ポート番号を指定しない場合、ドライバーはデフォルトのポート`27017`を使用します。
`/defaultauthdb`	任意。接続stringに `db_username:db_password@` 認証情報が含まれている一方で、`authSource` オプションが含まれていない場合に使用する認証データベース。このコンポーネントを含めない場合、クライアントは`admin`データベースに対してユーザーを認証します。
`?<options>`	任意。接続固有のオプションを `<name>=<value>` ペアとして指定するクエリstringです。これらのオプションの詳細については、「接続オプションの指定」を参照してください。

接続文字列の詳細については、サーバーマニュアルの「接続文字列」を参照してください。

MongoDBへの接続を作成するには、 MongoDB\Clientクラスのインスタンスを構築するときに接続文字列を渡します。

次の例では、ライブラリはサンプル接続 URI を使用して、 localhostのポート27017上のMongoDBデプロイに接続します。

<?php
$client = new MongoDB\Client("mongodb://localhost:27017");

PHPライブラリでMongoDB\Clientオブジェクトを作成する方法の詳細については、次のAPIドキュメントを参照してください。

戻る

MongoDB に接続する

接続オプションの指定