Mongo::__construct

パラメータ

server

サーバー名。

options

接続オプションの配列。現在使用できるオプションは次のとおりです。

• "authMechanism"

  以下の機構が選べます。

  認証機構	説明	利用可能
  MONGODB-CR	チャレンジレスポンス方式を使った認証。デフォルトです。	すべてのバージョンの MongoDB
  X509	X509 証明書による認証。	MongoDB 2.6。OpenSSL が有効な場合のみ。
  PLAIN	暗号化されていないユーザー名とパスワードによる認証。SSL 接続上でのみ使うこと。サードパーティの LDAP サーバー経由での MongoDB へのログインの際に利用する。	MongoDB Enterprise 2.4。CyrusSASL2 を使うようにドライバをコンパイルしておく必要がある。
  GSSAPI	ケルベロス認証	MongoDB Enterprise 2.4。CyrusSASL2 を使うようにドライバをコンパイルしておく必要がある。

• "authSource"

  ユーザーが定義されているデータベース名を設定します。

• "connect"

  コンストラクタで接続を行うか。デフォルトは TRUE。FALSE にすると、ドライバが 自動的に サーバーと接続するようになります。 クエリの実行に接続が必要かどうかは関係ありません。 それ以外に、手動で Mongo::connect() を実行する方法もあります。

  警告

  このオプションは、接続文字列で使うことはできません。

• "connectTimeoutMS"

  接続を開こうとしてタイムアウトになるまでの時間の長さ（ミリ秒単位）。 デフォルトは 60000 (60 秒) です。

  -1 を指定すると、接続タイムアウトを適用せず、PHP は default_socket_timeout を利用します。

• "db"

  ホスト名に含めるかわりに、認証対象のデータベースをここで指定することができます。 ホスト名で設定したデータベースを上書きします。

• "fsync"

  "fsync" を設定すると、データベース上のすべての書き込み操作は、 その書き込みがディスクに同期されるまでは成功とみなさないようになります。 書き込み処理の速度は大幅に低下しますが、書き込みがきちんと成功してディスクに書き出されたことを保証できます。

  MongoDB のジャーナリングを有効にしている (デフォルト) 場合、このオプションは "journal" と同じ意味になります。 ジャーナリングが無効になっている場合は、このオプションは、 書き込み操作がディスク上のデータベースファイルに同期されることを保証します。

  注意: ジャーナリングを有効にしている場合は、"fsync" ではなく "journal" を使うことを強く推奨します。 "fsync" と "journal" を同時に使わないようにしましょう。 同時に使うとエラーが発生します。

• "journal"

  "journal" を設定すると、データベース上のすべての書き込み操作が、 データベースがジャーナルへの変更をディスクにフラッシュするまでブロックされます。 書き込み処理の速度は多少低下しますが、書き込みがきちんと成功して、 万一システムに障害が発生したとしても復旧可能なことを保証できます。

  注意: ジャーナリングが無効になっている場合にこのオプションを使うと、 MongoDB 2.6+ ではエラーが発生して書き込みが失敗します。 それより前のバージョンでは、単純にこのオプションを無視します。

• "gssapiServiceName"

  » Kerberos サービスプリンシパル を設定します。authMechanism=GSSAPI の場合にのみ用いられるもので、デフォルトは "mongodb" です。

• "password"

  ホスト名に含めるかわりに、パスワードをここで指定することができます。 パスワードに "@" を含む場合などに特に便利です。 ホスト名で設定したパスワードを上書きします。

• "readPreference"

  優先読み込みの型を指定します。優先読み込みを使うと、 どのセカンダリからデータを読み込めるのかを制御できるようになります。

  指定できる値は primary、 primaryPreferred、 secondary、secondaryPreferred および nearest です。

  詳細な情報は、優先読み込みのドキュメントを参照ください。

• "readPreferenceTags"

  優先読み込みのタグを指定します。タグを readPreference と組み合わせて使うと、 どのセカンダリからデータを読み込めるのかをより細かく制御できるようになります。

  詳細な情報は、優先読み込みのドキュメントを参照ください。

• "replicaSet"

  接続先のレプリカセットの名前。指定した場合は、プライマリが自動的に決まります。 つまり、ドライバは、リストに上がっていないサーバーに接続することになるかもしれません。 詳細は、以下のレプリカセットの例を参照ください。

• "secondaryAcceptableLatencyMS"

  セカンダリから (優先読み込みを使って) 読み込むときに、 secondaryAcceptableLatencyMS 以上はなれているセカンダリからは読み込みません。 デフォルトは 15 です。

• "socketTimeoutMS"

  ソケットの操作 (読み書き) がタイムアウトになるまでの時間の長さ。 ミリ秒単位で、デフォルトは 30000 (30 秒) です。

  -1 を設定すると、ソケットの操作を永遠にブロックします。 このオプションは、操作単位以外でも設定できます。 クエリごとに設定するには MongoCursor::timeout()、 書き込みメソッドごとに設定するには "socketTimeoutMS" オプションを使います。

  注意: これはクライアント側のタイムアウトです。書き込み操作がタイムアウトに達してしまうと、 サーバーが実際に書き込みを受信したかどうかを知るすべがなくなります。そして、 書き込みの結果を返す代わりに MongoCursorTimeoutException をスローします。

• "ssl"

  boolean です。MongoDB への接続で SSL を有効にするかどうかを指定します。 証明書のような追加オプションは SSL コンテキストオプション で設定します。

• "username"

  ホスト名に含めるかわりに、ユーザー名をここで指定することができます。 ユーザー名に ":" を含む場合などに特に便利です。 ホスト名で設定したユーザー名を上書きします。

• "w"

  w オプションは、ドライバの Write Concern、 つまりドライバがレプリカセットへの書き込みをどれくらいブロックするかを制御します。

  正の整数は、レプリカセット内のいくつの ノードが書き込み指示を受け取ったらドライバが処理を続行するのかを指定します。 値を 3 にすると、 書き込みがレプリカセット内であと 2 台に適用されてからプライマリにも適用します。

  文字列を指定すると、どのタグセットを書き込み時に考慮するのかを指定したことになります。 "majority" は特別な値で、 参加しているノードの過半数に書き込み操作が適用された時点でプライマリにも適用します。

• "wTimeoutMS"

  このオプションは、 書き込み確認 を待つ制限時間をミリ秒単位で指定します。 これが書き込み操作に適用されるのは、 "w" が 1 より大きい場合のみです。 というのも、タイムアウトはレプリケーションに関する機能だからです。 この時間内に書き込み確認ができなかった場合は MongoCursorException をスローします。 0 を指定すると、永遠にブロックし続けます。 デフォルト値は 10000 (10 秒) です。

以下のオプションは廃止予定です。使ってはいけません。

• "slaveOkay"

  非推奨です。優先読み込み のオプションを使いましょう。

• "timeout"

  "connectTimeoutMS" へのエイリアス。非推奨です。

• "wTimeout"

  "wTimeoutMS" へのエイリアス。非推奨です。

driver_options

MongoDB ドライバーへのオプションの配列。SSL 用の接続コンテキストのオプションや、 ログ出力用のコールバックも含みます。

• "context"

  新しい接続をアタッチするストリームコンテキスト。このオプションで、SSL 証明書の設定などができます。 詳細は SSL コンテキストオプション を参照ください。 詳しい使いかたは SSL 接続のチュートリアルを参照ください。