この拡張モジュールのクラス/関数/メソッドには次のような変更がありました。
It supports all new features for MongoDB 2.6, including:
With this release, some driver functionality which was previously documented as deprecated will now formally raise deprecation notices. This includes:
注意:
No previously deprecated features have been removed.
Changes in behaviour:
The 1.4 series introduced fundemental changes in how connections are created to the MongoDB servers. The driver now utilizes PHP native streams, so all normal PHP stream options apply. Furthermore, an experimental Stream Context Support was added.
The 1.4.x series also added support for MongoDB 2.4.x.
The most important improvements however deal with the handling of replica sets, especially nodes that timeout and nodes that are unreachable for various reasons. Besides the improvements to replica set handling, this release addresses issues with read preferences through mongos nodes. It also adds support for SSL enabled connections as well as journal and fsync connection string options.
1.3 系では大きな変更が加わりました。 接続処理 が新しく書き直され (同時にプーリングが削除され) たり、 優先読み込み に対応したり、デフォルトの WriteConcerns が確認付きになったりしました。新しく導入されたクラス MongoClient がこれらを扱います。 これは、非推奨になった Mongo クラスのかわりに使うものです。
また、複数の mongos インスタンス (Mongo Shard ルーター) に接続してロードバランシングができるようになりました。
その他の追加機能には、MongoLog のログ機能の改良 (接続処理のデバッグがしやすくなりました) や MongoCollection::aggregate() メソッドによる » Aggregation Framework のサポートなどがあります。
既存のメソッドの中で、初期のバージョンから改良が加えられたものをまとめます。
| Version | Function | Description |
|---|---|---|
| 1.5.0 | MongoBinData::__construct | デフォルトが 2 (MongoBinData::BYTE_ARRAY) から 0 (MongoBinData::GENERIC) に変わりました。 |
| MongoCollection::aggregate | オプションの引数 options が追加されました。 | |
| MongoCollection::batchInsert | "wTimeoutMS" オプションが追加されました。これは "wtimeout" を置き換えるものです。 "wtimeout" を使うと E_DEPRECATED が発生します。 "socketTimeoutMS" オプションが追加されました。これは "timeout" を置き換えるものです。 "timeout" を使うと E_DEPRECATED が発生します。 "safe" を使うと E_DEPRECATED が発生します。 | |
| MongoCollection::ensureIndex | Renamed the "wtimeout" option to "wTimeoutMS". Emits E_DEPRECATED when "wtimeout" is used. Renamed the "timeout" option to "socketTimeoutMS". Emits E_DEPRECATED when "timeout" is used. Emits E_DEPRECATED when "safe" is used. | |
| MongoCollection::findOne | オプションの引数 options が追加されました。 | |
| MongoCollection::group | "maxTimeMS" オプションが追加されました。 | |
| MongoCollection::insert | "wTimeoutMS" オプションが追加されました。これは "wtimeout" を置き換えるものです。 "wtimeout" を使うと E_DEPRECATED が発生します。 "socketTimeoutMS" オプションが追加されました。これは "timeout" を置き換えるものです。 "timeout" を使うと E_DEPRECATED が発生します。 "safe" を使うと E_DEPRECATED が発生します。 | |
| MongoCollection::remove | "wTimeoutMS" オプションが追加されました。これは "wtimeout" を置き換えるものです。 "wtimeout" を使うと E_DEPRECATED が発生します。 "socketTimeoutMS" オプションが追加されました。これは "timeout" を置き換えるものです。 "timeout" を使うと E_DEPRECATED が発生します。 "safe" を使うと E_DEPRECATED が発生します。 | |
| MongoCollection::save | オプション "timeout" の名前が "socketTimeoutMS" に変わりました。 | |
| MongoCollection::save | オプション "wtimeout" の名前が "wTimeoutMS" に変わりました。 | |
| MongoCollection::toIndexString | このメソッドは非推奨になりました。 | |
| MongoCollection::update | "wTimeoutMS" オプションが追加されました。これは "wtimeout" を置き換えるものです。 "wtimeout" を使うと E_DEPRECATED が発生します。 "socketTimeoutMS" オプションが追加されました。これは "timeout" を置き換えるものです。 "timeout" を使うと E_DEPRECATED が発生します。 "safe" を使うと E_DEPRECATED が発生します。 | |
| MongoCursor::slaveOkay | このメソッドは非推奨になりました。かわりに MongoCursor::setReadPreference と を使いましょう。 | |
| 1.4.5 | MongoCursor::batchSize | 1.4.5 より前のバージョンでは、このメソッドは、 カーソルの反復処理が始まっている場合に MongoCursorException をスローしていました。 |
| 1.4.0 | Mongo::__construct | "wTimeoutMS" オプションが追加されました。これは "wTimeout" の代替です。 |
| MongoCursor::hint | index 引数に、文字列でインデックス名を指定できるよういなりました。 これより前のバージョンでは、配列またはオブジェクトしか渡せませんでした。 | |
| MongoCursor::setFlag | フラグ 3 (OPLOG_REPLAY) をサポートするようになりました。 以前のバージョンでは、このフラグには対応していないという警告が出ていました。 | |
| MongoDB::createCollection | 1.4.0 より前のバージョンでは、個々のオプションがすべてメソッドの引数になっていました。 旧バージョンのシグネチャは、次のとおりです。 public MongoCollectionMongoDB::createCollection stringname boolcappedFALSE intsize0 intmax0 各オプションの意味は、先ほど options 引数のところで説明したとおりです。 | |
| MongoId::__construct | 無効な文字列を渡したときに例外をスローするようになりました。 | |
| 1.3.4 | Mongo::__construct | "connectTimeoutMS" および "socketTimeoutMS" オプションが追加されました。 |
| MongoCollection::batchInsert | "wtimeout" オプションが追加されました。 | |
| MongoCollection::ensureIndex | Added "wtimeout" option. | |
| MongoCollection::insert | "wtimeout" オプションが追加されました。 | |
| MongoCollection::remove | "wtimeout" オプションが追加されました。 | |
| MongoCollection::update | "wtimeout" オプションが追加されました。 | |
| 1.3.3 | MongoClient::getReadPreference | 返り値が変わり、 MongoClient::setReadPreference との整合性があるものになりました。 type の値は数字から文字列に変わり、 type_string は削除され、そして tagsets はコロン区切りの文字列ではなくキー/値のペアでタグを表すようになりました。 |
| MongoCollection::getReadPreference | 返り値が変わり、 MongoCollection::setReadPreference との整合性があるものになりました。 type の値は数字から文字列に変わり、 type_string は削除され、そして tagsets はコロン区切りの文字列ではなくキー/値のペアでタグを表すようになりました。 | |
| MongoDB::getReadPreference | 返り値が変わり、 MongoDB::setReadPreference との整合性があるものになりました。 type の値は数字から文字列に変わり、 type_string は削除され、そして tagsets はコロン区切りの文字列ではなくキー/値のペアでタグを表すようになりました。 | |
| 1.3.0 | Mongo::close | connection パラメータが追加されました。 それより前のバージョンでは、このメソッドで閉じられるのは書き込み接続だけでした。 |
| Mongo::__construct | "readPreference"、 "readPreferenceTags"、"w" および "wTimeout" オプションが追加されました。 | |
| MongoCollection::batchInsert | "w" オプションが追加されました。 | |
| MongoCollection::ensureIndex | Added "w" option. The options parameter no longer accepts a boolean to signify a unique index. Instead, this now has to be done with array('unique' => true). | |
| MongoCollection::insert | "w" オプションが追加されました。 options パラメータで、boolean だけを渡して確認付きの書き込みを指定することができなくなりました。 同じことをするには array('w' => 1) (MongoClient のデフォルト) としなければなりません。 | |
| MongoCollection::remove | "w" オプションが追加されました。 options パラメータで、boolean だけを渡して "justOne" を指定することができなくなりました。 同じことをするには array('justOne' => true) としなければなりません。 | |
| MongoCollection::update | "w" オプションが追加されました。 options パラメータで、boolean だけを渡して upsert を指定することができなくなりました。 同じことをするには array('upsert'' => true) としなければなりません。 | |
| MongoDB::listCollections | includeSystemCollections が追加されました。 | |
| MongoGridFSCursor::key | ドキュメントの _id を文字列で返すようになりました。 キーは一意であるはずだからです。 これより前のバージョンでは filename を返していました。 | |
| 1.2.11 | Mongo::getPoolSize | E_DEPRECATED を発行するようになりました。 |
| Mongo::getSlave | E_DEPRECATED を発行するようになりました。 | |
| Mongo::getSlaveOkay | E_DEPRECATED を発行するようになりました。 | |
| Mongo::poolDebug | E_DEPRECATED を発行するようになりました。 | |
| Mongo::setSlaveOkay | E_DEPRECATED を発行するようになりました。 | |
| Mongo::switchSlave | E_DEPRECATED を発行するようになりました。 | |
| MongoBinData::__construct | 二番目の引数を省略すると E_DEPRECATED を発行します。 type のデフォルト値は近い将来変わる見込みです。 | |
| MongoCollection::ensureIndex | Emits E_DEPRECATED when options is scalar. | |
| MongoCollection::getSlaveOkay | E_DEPRECATED を発行するようになりました。 | |
| MongoCollection::group | options が scalar のときに E_DEPRECATED を発行するようになりました。 | |
| MongoCollection::remove | options が scalar のときに E_DEPRECATED を発行するようになりました。 | |
| MongoCollection::setSlaveOkay | E_DEPRECATED を発行するようになりました。 | |
| MongoCollection::update | options が scalar のときに E_DEPRECATED を発行するようになりました。 | |
| MongoCursor::doQuery | E_DEPRECATED を発行するようになりました。 | |
| MongoDB::authenticate | E_DEPRECATED を発行するようになりました。 認証情報の詳細をコンストラクタに渡しましょう。 | |
| MongoDB::forceError | E_DEPRECATED を発行するようになりました。 | |
| MongoDB::getSlaveOkay | E_DEPRECATED を発行するようになりました。 | |
| MongoDB::prevError | E_DEPRECATED を発行するようになりました。 | |
| MongoDB::resetError | E_DEPRECATED を発行するようになりました。 | |
| MongoDB::setSlaveOkay | E_DEPRECATED を発行するようになりました。 | |
| MongoPool::getSize | E_DEPRECATED を発行するようになりました。 | |
| MongoPool::info | E_DEPRECATED を発行するようになりました。 | |
| MongoPool::setSize | E_DEPRECATED を発行するようになりました。 | |
| 1.2.10 | Mongo::getHosts | レプリカセットでない場合もサポートするようになりました。 返される配列の要素に、新たに hostname と port を含むようになりました。 |
| 1.2.7 | MongoCollection::batchInsert | "continueOnError" オプションが追加されました。 |
| 1.2.5 | MongoGridFS::storeUpload | 二番目のパラメータがメタデータの配列に変わりました。これより前のバージョンでは、 二番目のパラメータはオプションの文字列で、ファイル名を上書きするものでした。 |
| 1.2.0 | Mongo::close | 1.2.0 より前のバージョンでは、デフォルトでは持続的接続を使いませんでした。 そして、MongoDB の接続がスコープから抜ければすぐに閉じられていました。 バージョン 1.2.0 からはそうではなくなりました。 close を呼ばないと、高負荷な接続がサーバーを使い切ってしまう可能性があります。 |
| Mongo::__construct | "username" および "password" オプションが追加されました。 "persist" オプションが削除されました。すべての接続は持続的な接続となります。 今でも使うことはできますが、何の影響も及ぼしません。 "persist" 持続的な接続を行うかどうか。これを設定すると、接続が持続的なものとなります。 文字列の値を接続 ID として使うので、 array("persist" => "foobar") で初期化した Mongo のインスタンスがふたつあれば、 それは同じデータベース接続をあらわします。一方、 array("persist" => "barbaz") で初期化したインスタンスは別のデータベース接続を使います。 "replicaSet" オプションは、boolean ではなく文字列を受け取るようになりました。 | |
| MongoCollection::ensureIndex | Added "timeout" option. | |
| MongoCollection::insert | "timeout" オプションが追加されました。 | |
| MongoCollection::remove | "timeout" オプションが追加されました。 | |
| MongoCollection::save | "timeout" オプションが追加されました。 | |
| MongoCollection::update | "timeout" オプションが追加されました。 | |
| MongoDB::command | options パラメータと、そのオプション "timeout" が追加されました。 | |
| 1.1.0 | MongoCursor::info | 多くのフィールドが追加されました。id (カーソル ID)、 at (現在のドキュメントを表すドライバのカウンタ)、 numReturned (サーバーが現在のバッチで返した件数)、そして server (クエリの送信先のサーバー。 と組み合わせると便利) などです。 |
| 1.0.11 | MongoCollection::ensureIndex | The "safe" option will trigger a primary failover, if necessary. MongoException will be thrown if the index name (either generated or set) is longer than 128 bytes. |
| MongoCollection::insert | "safe" が設定されている場合は、"not master" エラーで接続を切断するようになりました。 | |
| MongoCollection::remove | "safe" が設定されている場合は、"not master" エラーで接続を切断するようになりました。 | |
| MongoCollection::save | "safe" が設定されている場合は、"not master" エラーで接続を切断するようになりました。 | |
| MongoCollection::update | "safe" が設定されている場合は、"not master" エラーで接続を切断するようになりました。 | |
| 1.0.10 | MongoCursor::info | started_iterating フィールドが追加されました。boolean で、 このカーソルがクエリ実行前か実行後かを返します。 |
| 1.0.9 | Mongo::__construct | "replicaSet" オプションが追加されました。 |
| MongoCollection::batchInsert | "safe" オプションに整数値がわたせるようになりました (以前は boolean のみでした)。 "fsync" オプションが追加されました。 | |
| MongoCollection::insert | "safe" オプションに整数値がわたせるようになりました (以前は boolean のみでした)。 "fsync" オプションが追加されました。 "safe" オプションを使っている場合の返り値の型が配列に変わりました。 配列にはエラー情報が含まれています。"safe" オプションを使わない場合は、今までどおり boolean のままです。 | |
| MongoCollection::remove | "safe" オプションに整数値がわたせるようになりました (以前は boolean のみでした)。 "fsync" オプションが追加されました。 "safe" オプションを使っている場合の返り値の型が配列に変わりました。 配列にはエラー情報が含まれています。"safe" オプションを使わない場合は、今までどおり boolean のままです。 | |
| MongoCollection::save | "safe" オプションに整数値がわたせるようになりました (以前は boolean のみでした)。 "fsync" オプションが追加されました。 | |
| MongoCollection::update | "safe" オプションに整数値がわたせるようになりました (以前は boolean のみでした)。 "fsync" オプションが追加されました。 "safe" オプションを使っている場合の返り値の型が配列に変わりました。 配列にはエラー情報が含まれています。"safe" オプションを使わない場合は、今までどおり boolean のままです。 | |
| 1.0.7 | MongoCollection::count | パラメータ limit および skip が追加されました。 |
| 1.0.5 | MongoCollection::batchInsert | options パラメータが追加されました。 |
| MongoCollection::ensureIndex | Added the "name" option to override index name creation. | |
| MongoCollection::insert | 二番目のパラメータがオプションの配列に変わりました。1.0.5 より前のバージョンでは、二番目のパラメータは "safe" オプションを表す boolean 値でした。 | |
| MongoCollection::remove | 二番目のパラメータがオプションの配列に変わりました。1.0.5 より前のバージョンでは、二番目のパラメータは "safe" オプションを表す boolean 値でした。 | |
| MongoCollection::save | options パラメータが追加されました。 | |
| MongoCollection::update | "safe" オプションが追加されました。 | |
| 1.0.2 | Mongo::__construct | コンストラクタがオプションの配列を受け取るようになりました。 以前のバージョンでは、コンストラクタは以下のパラメータを受け取っていました。 server サーバー名。 connect オプションの boolean パラメータで、 コンストラクタがデータベースに接続するかどうかを示します。 デフォルトは TRUE です。 persistent 持続的な接続を行うかどうか。 paired ペア接続を行うかどうか。 |
| MongoCollection::ensureIndex | Changed options parameter from boolean to array. Pre-1.0.2, the second parameter was an optional boolean value specifying a unique index. | |
| 1.0.1 | MongoCollection::insert | "safe" オプションが設定されていて追加に失敗した場合に MongoCursorException をスローするようになりました。 |
| MongoCollection::update | options パラメータが boolean から配列に変わりました。 1.0.1 より前のバージョンでは二番目のパラメータはオプションの boolean 値で、upsert を指定するものでした。 |