PHP - Manual: 使用 MongoCollection::findOne 方法

2024-12-23

使用 MongoCollection::findOne() 方法

要查看我们上一步插入到数据库的文档，可以简单的使用 MongoCollection::findOne() 方法从即合理获得一个简单的文档。这个方法在只想查询一个结果的时候很有用。


<?php
$connection = new MongoClient();
$collection = $connection->database->collectionName;

$document = $collection->findOne();
var_dump( $document );
?>

以上例程会输出：

array(6) {
  ["_id"]=>
  object(MongoId)#8 (1) {
    ["$id"]=>
    string(24) "4e2995576803fab768000000"
  }
  ["name"]=>
  string(7) "MongoDB"
  ["type"]=>
  string(8) "database"
  ["count"]=>
  int(1)
  ["info"]=>
  array(2) {
    ["x"]=>
    int(203)
    ["y"]=>
    int(102)
  }
  ["versions"]=>
  array(3) {
    [0]=>
    string(5) "0.9.7"
    [1]=>
    string(5) "0.9.8"
    [2]=>
    string(5) "0.9.9"
  }
}

注意：有一个 _id 字段被自动添加到你的文档中了。 _id 字段就是集合的“主键”。如果插入文档的时候你没有手动指定，驱动就会自动帮你添加一个。

如果你所插入的文档定义了 _id 字段，那么它在集合中必须是唯一的。这是一个例子：


<?php
$connection = new MongoClient();
$db = $connection->database;

$db->foo->insert(array("_id" => 1));
// this will throw an exception
$db->foo->insert(array("_id" => 1));

// this is fine, as it is a different collection
$db->bar->insert(array("_id" => 1));
?>

默认设置时，驱动会在服务器通过了写入请求后返回（译注：“通过”即如果不发生崩溃等情况，待插入的文档就一定会在随后被写入，这并不意味着数据已经写入磁盘）。你可以通过将第二个参数设为 array("w" => 0) 来改变默认行为。此时你的插入请求会立即返回，并且不会抛出 _id 重复的异常。

参见

MongoCollection::findOne() 方法的文档中有对查询的详细说明。

唯一ID的信息查看 MongoId

写入部分更详细的说明了写操作, Write Concerns 章节深入解释了一些写操作的选项。

add a note

User Contributed Notes

There are no user contributed notes for this page.

官方地址：https://www.php.net/manual/en/mongo.tutorial.findone.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络数据库 JAVA 面试 NoSQL C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 PHP 8.1 ADORecordSet对象 adodb手册 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet php中几种注释规范 mysql面试题 PHP json解析（json_decode）页面工具 [原创]诡异的php-fpm超时问题纯php实现DES以及TripleDES加密算法两千行PHP学习笔记 html转义/html编码/html解码 PHP5 扩展SOAP 调用 webservice

略微加速

PHP官方手册 - 互联网笔记

使用 MongoCollection::findOne() 方法

参见

User Contributed Notes