企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
使用`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`官方手册。