MongoDb
最后更新于：2022-04-02 01:55:23
使用`Mongo`之前，需要装PHP的`mongo`扩展，访问 http://pecl.php.net/package/mongodb ，选择最新的版本即可，然后选择你的PHP版本对应的扩展。
然后使用`Composer`安装扩展包：
~~~
composer require topthink/think-mongo=2.0.*
~~~
接下来，需要修改数据库配置文件中的相关参数：
~~~
// 数据库类型
'type' => '\think\mongo\Connection',
// 设置查询类
'query' => '\think\mongo\Query',
// 服务器地址
'hostname' => '127.0.0.1',
// 集合名
'database' => 'demo',
// 用户名
'username' => '',
// 密码
'password' => '',
// 端口
'hostport' => '',
~~~
默认安装的`mongodb`是没有用户名和密码的，可以留空。如果你的服务器安装的mongodb提供了用户名和密码认证，请自行修改。`MongoDb`一样支持分布式设置，设置方法和`Mysql`的分布式设置一致。
## 关于主键
`MongoDb`会自动添加`_id`字段而且作为主键，该主键数据是一个`MongoDB\BSON\ObjectID`对象实例。
为了方便查询，系统做了封装，该主键的值可以直接当作字符串使用，因此下面的查询是有效的：
~~~
// 查询操作
$user = Db::table('user')
->where('_id','589461c0fc122812b4007411')
->find();
// 或者直接使用
$user = Db::table('user')
->find('589461c0fc122812b4007411');
~~~
为了保持和Mysql一致的主键命名习惯，系统提供了一个数据库配置参数`pk_convert_id`可以强制把`_id`转换为`id`进行操作。
~~~
// 强制把_id转换为id
'pk_convert_id' => true,
~~~
设置后，就可以把`id`当成`_id`来使用
~~~
// 查询操作
$user = Db::table('user')
->where('id','589461c0fc122812b4007411')
->find();
dump($user);
~~~
输出结果为：
~~~
array (size=3)
'name' => string 'thinkphp' (length=8)
'email' => string 'thinkphp@qq.com' (length=15)
'id' => string '589461c0fc122812b4007411' (length=24)
~~~
原来的`_id`已经变成`id`，而且是一个字符串类型。
## 方法变化和差异
除了常规的CURD方法之外，包括`value`、`column`、`setInc`、`setDec`、`setField`、`paginate`等方法仍然被支持，更新的时候也支持`data`、`inc`和`dec`方法，包括聚合查询方法也都支持。
由于数据库自身的原因，以下链式方法在`MongoDb`中不再支持（或者无效）：
|不再支持的方法|
|---|
|view|
|join|
|alias|
|group|
|having|
|union|
|lock|
|strict|
|sequence|
|force|
|bind|
|partition|
针对了`MongoDb`的特殊性增加了如下链式操作方法：
|方法|描述|
|---|---|
|skip|设置skip|
|awaitData|设置awaitData|
|batchSize|设置batchSize|
|exhaust|设置exhaust|
|modifiers|设置modifiers|
|noCursorTimeout|设置noCursorTimeout|
|oplogReplay|设置oplogReplay|
|partial|设置partial|
|maxTimeMS|设置maxTimeMS|
|slaveOk|设置slaveOk|
|tailable|设置tailable|
|writeConcern|设置writeConcern|
并且`fetchPdo`方法改为`fetchCursor`。
## Mongo原生查询
系统提供了几个基础查询方法，仅供熟悉`MongoDb`语法的用户使用。
>[info] ### query ($collection, $query)
**collection**：表示当前查询的集合
**query**：是一个`\MongoDB\Driver\Query`对象，详细用法可以参考[官方手册](http://php.net/manual/zh/mongodb-driver-query.construct.php)
代码示例如下
~~~
$filter = [
'author' => 'bjori',
'views' => [
'$gte' => 100,
],
];
$options = [
/* Only return the following fields in the matching documents */
'projection' => [
'title' => 1,
'article' => 1,
],
/* Return the documents in descending order of views */
'sort' => [
'views' => -1
],
);
$query = new MongoDB\Driver\Query($filter, $options);
Db::query('demo.user', $query);
~~~
>[info] ### execute ($collection, $bulk)
**collection**：表示当前查询的集合
**bulk**：是一个`\MongoDB\Driver\BulkWrite`对象，详细用法可以参考[官方手册](http://php.net/manual/zh/class.mongodb-driver-bulkwrite.php)
>[info] ### command ($command, $dbName)
**command**：是一个`\MongoDB\Driver\Command`对象，详细用法参考[官方手册](http://php.net/manual/zh/class.mongodb-driver-command.php)
**dbName**：当前操作的数据库名称，留空表示当前数据库
除此之外，系统还封装了一个`cmd`方法可以直接执行字符串格式的`mongo`命令，例如：
~~~
// 列出当前的集合
$collections = Db::cmd('listCollections');
~~~
更多的`mongo`命令参考`MongoDb`官方手册。
';