Changelog

The following changes have been made to classes/functions/methods of this extension.

VersionFunctionDescription
1.3.0MongoCollection::ensureIndexThe options parameter does no longer accept just a boolean to signify a unique index. Instead, this now has to be done with array('unique' => true).
 MongoCollection::insertThe options parameter does no longer accept just a boolean to signify a safe insert. Instead, this now has to be done with array('safe' => true).
 MongoCollection::removeThe options parameter does no longer accept just a boolean to signify "justOne". Instead, this now has to be done with array('justOne' => true).
 MongoCollection::updateThe options parameter does no longer accept just a boolean to signify an upsert. Instead, this now has to be done with array('upsert' => true).
1.2.10Mongo::getHostsSupport for non-replicasets was added. The returned array elements now also include the hostname and port.
1.2.7MongoCollection::batchInsertThe continueOnError flag has been added.
1.2.5MongoGridFS::storeUploadChanged second parameter to an array of metadata. Pre-1.2.5, the second parameter was an optional string overriding the filename.
1.2.0Mongo::closeBefore version 1.2.0 the driver would not use persistent connections by default, and all connections would be closed as soon as a MongoDB connection went out if scope. Since version 1.2.0 this is no longer the case and it is a bad idea to call close as you might end up overloading the server with connections under high load.
 Mongo::__constructRemoved the persist option, as all connections are now persistent. It can still be used, but it doesn't affect anything. "persist" If the connection should be persistent. If set, the connection will be persistent. The string representation of the value is used as an id for the connection, so two instances of Mongo that are initialized with array("persist" => "foobar") will share the same database connection, whereas an instance initialized with array("persist" => "barbaz") will use a different database connection. The "replicaSet" parameter now takes a string, not a boolean (although boolean is still accepted).
 Mongo::__constructAdded the username and password options.
 MongoCollection::ensureIndexAdded timeout option.
 MongoCollection::insertAdded timeout option.
 MongoCollection::removeAdded timeout option.
 MongoCollection::saveAdded timeout option.
 MongoCollection::updateAdded timeout option.
 MongoDB::commandAdded options parameter with a single option: timeout.
1.1.0MongoCursor::infoAdded a number of other fields, including id (the cursor id), at (the driver's counter of which document is current), numReturned (the number returned by the server in the current batch), and server (which server the query was sent to—useful in conjunction with MongoCursor::slaveOkay).
1.0.11MongoCollection::ensureIndexMongoException will be thrown if index name (either generated or set) is longer than 128 bytes.
 MongoCollection::ensureIndex"safe" will trigger master failover, if necessary.
 MongoCollection::insertDisconnects on "not master" errors if "safe" is set.
 MongoCollection::removeDisconnects on "not master" errors if "safe" is set.
 MongoCollection::saveDisconnects on "not master" errors if "safe" is set.
 MongoCollection::updateDisconnects on "not master" errors if "safe" is set.
1.0.10MongoCursor::infoAdded started_iterating field, a boolean indicating if cursor is pre- or post-query.
1.0.9Mongo::__constructAdded the replicaSet option.
 MongoCollection::batchInsertAdded ability to pass integers to "safe" options (only accepted booleans before) and added "fsync" option.
 MongoCollection::insertAdded ability to pass integers to "safe" options (only accepted booleans before) and added "fsync" option.
 MongoCollection::insertThe return type was changed to be an array containing error information if the "safe" option is used, otherwise it is a boolean as before.
 MongoCollection::removeThe return type was changed to be an array containing error information if the "safe" option is used, otherwise it is a boolean as before.
 MongoCollection::removeAdded ability to pass integers to "safe" options (only accepted booleans before) and added "fsync" option.
 MongoCollection::saveAdded ability to pass integers to "safe" options (only accepted booleans before) and added "fsync" option.
 MongoCollection::updateThe return type was changed to be an array containing error information if the "safe" option is used, otherwise it is a boolean as before.
 MongoCollection::updateAdded ability to pass integers to "safe" options (only accepted booleans before) and added "fsync" option.
1.0.7MongoCollection::countAdded limit and skip parameters.
1.0.5MongoCollection::batchInsertAdded "options" parameter.
 MongoCollection::insertChanged second parameter to an array of options. Pre-1.0.5, the second parameter was a boolean indicating the "safe" option.
 MongoCollection::removeChanged second parameter to an array of options. Pre-1.0.5, the second parameter was a boolean indicating the "justOne" option and there was no safe option.
 MongoCollection::saveAdded "options" parameter.
 MongoCollection::updateAdded "safe" option.
1.0.2Mongo::__constructChanged constructor to take an array of options. Pre-1.0.2, the constructor took the following parameters: server The server name. connect Optional boolean parameter specifying if the constructor should connect to the database before returning. Defaults to TRUE. persistent If the connection should be persistent. paired If the connection should be paired.
 MongoCollection::ensureIndexChanged "options" parameter from boolean to array. Pre-1.0.2, the second parameter was an optional boolean value specifying a unique index.
1.0.1MongoCollection::updateChanged "options" parameter from boolean to array. Pre-1.0.1, the second parameter was an optional boolean value specifying an upsert.