This extension provides the MongoDB integration for the Yii framework.
- MongoDB PHP Extension version 1.8.0 or higher.
- MongoDB server version 3.0 or higher.
- PHP 8.1 or higher.
The package could be installed with Composer:
composer require yiisoft/db-mongodbTo 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();If you need help or have a question, the Yii Forum is a good place for that. You may also check out other Yii Community Resources.
The Yii Database MongoDB driver is free software. It is released under the terms of the BSD License.
Please see LICENSE for more information.
Maintained by Yii Software.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent