53 lines
2.7 KiB
Markdown
53 lines
2.7 KiB
Markdown
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.
|
|
|