yiisoft/yii2-mongodb

MongoDB extension for the Yii framework

Package info

github.com/yiisoft/yii2-mongodb

Forum

Wiki

Type:yii2-extension

pkg:composer/yiisoft/yii2-mongodb

Fund package maintenance!

Open Collective

yiisoft

Tidelift

Statistics

Installs: 2 143 276

Dependents: 66

Suggesters: 12

Stars: 332

Open Issues: 44

3.0.4 2025-10-08 11:42 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

BSD-3-Clause 5cf7e03ed1c9a5a2dc833529c5584f0606f7ed3e

  • Paul Klimov <klimov.paul.woop@gmail.com>

mongodbmongoactive-recordyii2GridFS


README

👁 Image

MongoDB Extension for Yii 2


This extension provides the MongoDB integration for the Yii framework 2.0.

For license information check the LICENSE-file.

Documentation is at docs/guide/README.md.

👁 Latest Stable Version
👁 Total Downloads
👁 Build Status
👁 codecov

Requirements

This extension requires MongoDB PHP Extension version 1.20.1 or higher.

This extension requires MongoDB server version 4.0 or higher.

Installation

Important

  • The minimum required PHP version is PHP 7.4.
  • It works best with PHP 8.

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist yiisoft/yii2-mongodb

or add

"yiisoft/yii2-mongodb": "~3.0.0"

to the require section of your composer.json.

Configuration

To use this extension, simply add the following code in your application configuration:

return [
 //....
 'components' => [
 'mongodb' => [
 'class' => '\yii\mongodb\Connection',
 'dsn' => 'mongodb://localhost:27017/mydatabase',
 'options' => [
 "username" => "Username",
 "password" => "Password"
 ]
 ],
 ],
];

Known issues

  • yii\mongodb\Exception: no such command: 'group' with MongoDB server version 4.2 or higher.
    Starting in version 4.2, MongoDB removes the group command (deprecated since version 3.4) and its mongo shell helper db.collection.group().