Upgrading Instructions for Yii Framework v2
===========================================

!!!IMPORTANT!!!

The following upgrading instructions are cumulative. That is,
if you want to upgrade from version A to version C and there is
version B between A and C, you need to following the instructions
for both A and B.

Upgrade from Yii 2.0.5
----------------------

* PHP [mongodb](http://php.net/manual/en/set.mongodb.php) extension is now used instead of [mongo](http://php.net/manual/en/book.mongo.php).
  Make sure you have 'mongodb' extension at your environment. Some features based on old driver may become unavailable.
  In particular: fields `Connection::mongoClient`, `Database::mongoDb` and `Collection::mongoCollection` are no longer exist.
  Old driver type classes such as `\MongoId`, `\MongoCode`, `\MongoDate` and so on, are no longer returned or
  recognized. Make sure you are using their analogs from `\MongoDB\BSON\*` namespace.

* MongoDB server versions < 3.0 are no longer supported. Make sure you are running MongoDB server >= 3.0

* The signature of the following `\yii\mongodb\Collection` methods has been changed: `aggregate()`, `distinct()`,
  `find()`, `findOne()`, `findAndModify()`. Make sure you invoke those methods correctly. In case you are
  extending `\yii\mongodb\Collection`, you should check, if overridden methods match parent declaration.

* Command and query composition methods at `\yii\mongodb\Collection`, such as `buildCondition()`, `ensureMongoId()`
  and so on, have been removed. Use `\yii\mongodb\QueryBuilder` methods instead.

* Method `Database::executeCommand()` has been removed. Use `Command` class for plain MongoDB command execution.
  You may create command with database scope using `Database::createCommand()` method.

* Method `Collection::fullTextSearch()` has been removed. Use `$text` query condition instead.

* Method `Collection::getName()` has been removed. Use `Collection::name` in order to get collection self name.

* For GridFS `yii\mongodb\file\Download` is returned instead of `\MongoGridFSFile` for the query result set.

* Cursor composed via `yii\mongodb\file\Collection::find()` now returns result in the same format as `yii\mongodb\file\Query::one()`.
  If you wish to perform file manipulations on returned row you should use `file` key instead of direct method invocations.

Upgrade from Yii 2.0.1
----------------------

* MongoDB PHP extension min version raised up to 1.5.0. You should upgrade your environment in case you are
  using older version.

Upgrade from Yii 2.0.0
----------------------

* MongoDB PHP extension min version raised up to 1.4.0. You should upgrade your environment in case you are
  using older version.