PHPackages yiisoft/db-mongodb - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. yiisoft/db-mongodb AbandonedArchivedLibrary[Framework](/categories/framework) yiisoft/db-mongodb ================== Yii Framework MongoDB extension 121065[3 issues](https://github.com/yiisoft/db-mongodb/issues)PHPCI failing Since May 5Pushed 5mo ago15 watchersCompare [ Source](https://github.com/yiisoft/db-mongodb)[ Packagist](https://packagist.org/packages/yiisoft/db-mongodb)[ RSS](/packages/yiisoft-db-mongodb/feed)WikiDiscussions master Synced 3w ago READMEChangelogDependenciesVersions (2)Used By (0) Warning There is no official MongoDB support planned for Yii3 DB. [Use official PHP client instead](https://www.mongodb.com/docs/php-library/current/). [ ![Yii](https://camo.githubusercontent.com/8317c17418b39410a660f5149071d26c5023c0d5fb2b7ebb771324812f666d73/68747470733a2f2f796969736f66742e6769746875622e696f2f646f63732f696d616765732f7969695f6c6f676f2e737667) ](https://github.com/yiisoft) [ ![MongoDB](https://camo.githubusercontent.com/b03378e6893070fd365e1c95eb6553933577a14cbf0837c31b16bb6f25783efb/68747470733a2f2f7765626173736574732e6d6f6e676f64622e636f6d2f5f636f6d5f6173736574732f636d732f6d6f6e676f64622d6c6f676f2d7267622d6a36773237316731786e2e6a7067) ](https://www.mongodb.com/) Yii Database MongoDB driver =========================== [](#yii-database-mongodb-driver) [![Latest Stable Version](https://camo.githubusercontent.com/67689313797d84f53eae160acb97f2132385ab04a8a67a3865eb4f3b834fa6d3/68747470733a2f2f706f7365722e707567782e6f72672f796969736f66742f64622d6d6f6e676f64622f762f737461626c652e706e67)](https://packagist.org/packages/yiisoft/db-mongodb)[![Total Downloads](https://camo.githubusercontent.com/25d7c51741a6de020744f85f872a5006e71225b8be52f90df93822cf6102e830/68747470733a2f2f706f7365722e707567782e6f72672f796969736f66742f64622d6d6f6e676f64622f646f776e6c6f6164732e706e67)](https://packagist.org/packages/yiisoft/db-mongodb)[![Build status](https://github.com/yiisoft/db-mongodb/workflows/build/badge.svg)](https://github.com/yiisoft/db-mongodb/actions?query=workflow%3Abuild)[![Code Coverage](https://camo.githubusercontent.com/f26913d736d2eab122037e1470e630a1ce46c4a2ad802d1fca4b28c0f6b47a04/68747470733a2f2f636f6465636f762e696f2f67682f796969736f66742f64622d6d6f6e676f64622f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/yiisoft/db-mongodb)[![Mutation testing badge](https://camo.githubusercontent.com/68108d6bf022eb5eb64200b61ad9e9f4c938fbff084e2149a837e6dd08a06963/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f7374796c653d666c61742675726c3d687474707325334125324625324662616467652d6170692e737472796b65722d6d757461746f722e696f2532466769746875622e636f6d253246796969736f667425324664622d6d6f6e676f64622532466d6173746572)](https://dashboard.stryker-mutator.io/reports/github.com/yiisoft/db-mongodb/master)[![static analysis](https://github.com/yiisoft/db-mongodb/workflows/static%20analysis/badge.svg)](https://github.com/yiisoft/db-mongodb/actions?query=workflow%3A%22static+analysis%22)[![type-coverage](https://camo.githubusercontent.com/51141afc45be24cff93f61961fc89bb1890e075552136c062012b1e14d640be3/68747470733a2f2f73686570686572642e6465762f6769746875622f796969736f66742f64622d6d6f6e676f64622f636f7665726167652e737667)](https://shepherd.dev/github/yiisoft/db-mongodb)[![psalm-level](https://camo.githubusercontent.com/b67dfe674be6040029c0bcac16f07448edea76214899dc52be375b2a66ba28a6/68747470733a2f2f73686570686572642e6465762f6769746875622f796969736f66742f64622d6d6f6e676f64622f6c6576656c2e737667)](https://shepherd.dev/github/yiisoft/db-mongodb) This extension provides the [MongoDB](https://www.mongodb.com/) integration for the [Yii framework](https://www.yiiframework.com). Requirements ------------ [](#requirements) - [MongoDB PHP Extension](https://www.php.net/manual/en/set.mongodb.php) version 1.8.0 or higher. - MongoDB server version 3.0 or higher. - PHP 8.1 or higher. Installation ------------ [](#installation) The package could be installed with [Composer](https://getcomposer.org): ``` composer require yiisoft/db-mongodb ``` General usage ------------- [](#general-usage) To use this extension, simply add the following code in your application configuration: ``` return [ //.... 'components' => [ 'mongodb' => [ 'class' => Yiisoft\Db\MongoDb\Connection::class, 'dsn' => 'mongodb://@localhost:27017/mydatabase', 'options' => [ "username" => "Username", "password" => "Password" ] ], ], ]; ``` Once you have a MongoDB connection instance, you can execute a MongoDB commands and queries using `Yiisoft\Db\MongoDb\Command`: ``` // execute command: $result = Yii::$app->mongodb->createCommand(['listIndexes' => 'some_collection'])->execute(); // execute query (find): $cursor = Yii::$app->mongodb->createCommand(['projection' => ['name' => true]])->query('some_collection'); // execute batch (bulk) operations: Yii::$app->mongodb->createCommand() ->addInsert(['name' => 'new']) ->addUpdate(['name' => 'existing'], ['name' => 'updated']) ->addDelete(['name' => 'old']) ->executeBatch('customer'); ``` Using the connection instance you may access databases and collections. Most of the MongoDB commands are accessible via `\Yiisoft\Db\MongoDb\Collection` instance: ``` $collection = Yii::$app->mongodb->getCollection('customer'); $collection->insert(['name' => 'John Smith', 'status' => 1]); ``` To perform `find` queries, you should use `\Yiisoft\Db\MongoDb\Query`: ``` use Yiisoft\Db\MongoDb\Query; $query = new Query(); // compose the query $query->select(['name', 'status']) ->from('customer') ->limit(10); // execute the query $rows = $query->all(); ``` Documentation ------------- [](#documentation) - Guide: [English](docs/guide/en/README.md), [Français](docs/guide/fr/README.md), [Русский](docs/guide/ru/README.md), [日本語](docs/guide/ja/README.md) - [Internals](docs/internals.md) If you need help or have a question, the [Yii Forum](https://forum.yiiframework.com/c/yii-3-0/63) is a good place for that. You may also check out other [Yii Community Resources](https://www.yiiframework.com/community). License ------- [](#license) The Yii Database MongoDB driver is free software. It is released under the terms of the BSD License. Please see [`LICENSE`](./LICENSE.md) for more information. Maintained by [Yii Software](https://www.yiiframework.com/). Support the project ------------------- [](#support-the-project) [![Open Collective](https://camo.githubusercontent.com/a2b15f8e2268d4e3842e00d41ff7a57cce2ad8bd8d8769c5dc4fa05a546a4f62/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4f70656e253230436f6c6c6563746976652d73706f6e736f722d3765616466313f6c6f676f3d6f70656e253230636f6c6c656374697665266c6f676f436f6c6f723d376561646631266c6162656c436f6c6f723d353535353535)](https://opencollective.com/yiisoft) Follow updates -------------- [](#follow-updates) [![Official website](https://camo.githubusercontent.com/d6b0929173e28cc627430d2519ca1853466a70f37395877eaf4820cb3e1e1909/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f506f77657265645f62792d5969695f4672616d65776f726b2d677265656e2e7376673f7374796c653d666c6174)](https://www.yiiframework.com/)[![Twitter](https://camo.githubusercontent.com/d077c362ac639792171af8bc002ee827816733dfc0925f70b557e6d151022226/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f747769747465722d666f6c6c6f772d3144413146323f6c6f676f3d74776974746572266c6f676f436f6c6f723d314441314632266c6162656c436f6c6f723d3535353535353f7374796c653d666c6174)](https://twitter.com/yiiframework)[![Telegram](https://camo.githubusercontent.com/4e38dd12535575c39c65bea7119b95e663abb2d1f4e3d669a27bbda07ef603f0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f74656c656772616d2d6a6f696e2d3144413146323f7374796c653d666c6174266c6f676f3d74656c656772616d)](https://t.me/yii3en)[![Facebook](https://camo.githubusercontent.com/48204e301b34b29b0815854544f04c337fc0692096cab35e9a1f8c53a42c2307/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f66616365626f6f6b2d6a6f696e2d3144413146323f7374796c653d666c6174266c6f676f3d66616365626f6f6b266c6f676f436f6c6f723d666666666666)](https://www.facebook.com/groups/yiitalk)[![Slack](https://camo.githubusercontent.com/1a3645ba1c97e6684d0349bc478201e1621ba0d3efad516d81035364d442bad7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f736c61636b2d6a6f696e2d3144413146323f7374796c653d666c6174266c6f676f3d736c61636b)](https://yiiframework.com/go/slack) ### Health Score 33 — LowBetter than 72% of packages Maintenance45 Moderate activity, may be stable Popularity19 Limited adoption so far Community30 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/261a6249c6f605f3956a2fae40fbb813f6b2e1e6f2bf806180c851a965426e54?d=identicon)[cebe](/maintainers/cebe) ![](https://www.gravatar.com/avatar/fc29e4e7068a00fe9b9db37b8aadda1db6020adcacef810461e47b99c2b150e6?d=identicon)[samdark](/maintainers/samdark) ![](https://www.gravatar.com/avatar/ccb75e3312d6bd454ea445ea308139fd185a4ca906ca5df21cc66e6a35de25a3?d=identicon)[SilverFire](/maintainers/SilverFire) ![](https://www.gravatar.com/avatar/99106256c24a8cb23871b99fa90e48f37f1aa71608c185759b7d2a88683a5918?d=identicon)[hiqsol](/maintainers/hiqsol) --- Top Contributors [![qiangxue](https://avatars.githubusercontent.com/u/993322?v=4)](https://github.com/qiangxue "qiangxue (1913 commits)")[![cebe](https://avatars.githubusercontent.com/u/189796?v=4)](https://github.com/cebe "cebe (761 commits)")[![samdark](https://avatars.githubusercontent.com/u/47294?v=4)](https://github.com/samdark "samdark (690 commits)")[![klimov-paul](https://avatars.githubusercontent.com/u/1482054?v=4)](https://github.com/klimov-paul "klimov-paul (527 commits)")[![creocoder](https://avatars.githubusercontent.com/u/896494?v=4)](https://github.com/creocoder "creocoder (148 commits)")[![resurtm](https://avatars.githubusercontent.com/u/100198?v=4)](https://github.com/resurtm "resurtm (123 commits)")[![Ragazzo](https://avatars.githubusercontent.com/u/1748844?v=4)](https://github.com/Ragazzo "Ragazzo (76 commits)")[![lucianobaraglia](https://avatars.githubusercontent.com/u/374554?v=4)](https://github.com/lucianobaraglia "lucianobaraglia (44 commits)")[![suralc](https://avatars.githubusercontent.com/u/730039?v=4)](https://github.com/suralc "suralc (42 commits)")[![pmoust](https://avatars.githubusercontent.com/u/2493339?v=4)](https://github.com/pmoust "pmoust (36 commits)")[![schmunk42](https://avatars.githubusercontent.com/u/649031?v=4)](https://github.com/schmunk42 "schmunk42 (26 commits)")[![slavcodev](https://avatars.githubusercontent.com/u/757721?v=4)](https://github.com/slavcodev "slavcodev (20 commits)")[![LarryUllman](https://avatars.githubusercontent.com/u/1674823?v=4)](https://github.com/LarryUllman "LarryUllman (18 commits)")[![kartik-v](https://avatars.githubusercontent.com/u/3592619?v=4)](https://github.com/kartik-v "kartik-v (16 commits)")[![machour](https://avatars.githubusercontent.com/u/304450?v=4)](https://github.com/machour "machour (13 commits)")[![mohorev](https://avatars.githubusercontent.com/u/4974062?v=4)](https://github.com/mohorev "mohorev (13 commits)")[![tarasio](https://avatars.githubusercontent.com/u/1010578?v=4)](https://github.com/tarasio "tarasio (12 commits)")[![bwoester](https://avatars.githubusercontent.com/u/309565?v=4)](https://github.com/bwoester "bwoester (12 commits)")[![crtlib](https://avatars.githubusercontent.com/u/4428231?v=4)](https://github.com/crtlib "crtlib (12 commits)")[![s1lver](https://avatars.githubusercontent.com/u/4567634?v=4)](https://github.com/s1lver "s1lver (11 commits)") --- Tags hacktoberfestmongodboptionalforframeworkannounce ### Embed Badge ![Health badge](/badges/yiisoft-db-mongodb/health.svg) ``` [![Health](https://phpackages.com/badges/yiisoft-db-mongodb/health.svg)](https://phpackages.com/packages/yiisoft-db-mongodb) ``` ### Alternatives [laravel/dusk Laravel Dusk provides simple end-to-end testing and browser automation. 1.9k39.6M294](/packages/laravel-dusk)[nineinchnick/edatatables Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin 173.2k](/packages/nineinchnick-edatatables)[link-cloud/fast-hyperf LinkCloud Fast Hyperf 241.2k1](/packages/link-cloud-fast-hyperf) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)