MongoCollection::save

(PECL mongo >=0.9.0)

MongoCollection::save — 保存一个文档到集合

说明

public MongoCollection::save ( array|object $document [, array $options = array() ] ) : mixed

如果对象来自数据库，则更新现有的数据库对象，否则插入对象。

参数

document

要保存的 Array 或 Object。如果用的是 Object，它不能有 protected 或 private 的属性。

Note:
如果参数不具有 _id 的键或者属性，将会创建并赋值一个新的 MongoId 实例。关于此行为的更多信息，参见 MongoCollection::insert()。

options

此次保存的选项。

"fsync"
Boolean, defaults to FALSE. Forces the insert to be synced to disk before returning success. If TRUE, an acknowledged insert is implied and will override setting w to 0.
"j"
Boolean, defaults to FALSE. Forces the write operation to block until it is synced to the journal on disk. If TRUE, an acknowledged write is implied and this option will override setting "w" to 0.
Note: If this option is used and journaling is disabled, MongoDB 2.6+ will raise an error and the write will fail; older server versions will simply ignore the option.
"socketTimeoutMS"
This option specifies the time limit, in milliseconds, for socket communication. If the server does not respond within the timeout period, a MongoCursorTimeoutException will be thrown and there will be no way to determine if the server actually handled the write or not. A value of -1 may be specified to block indefinitely. The default value for MongoClient is 30000 (30 seconds).
"w"
See WriteConcerns. The default value for MongoClient is 1.
"wtimeout"
Deprecated alias for "wTimeoutMS".
"wTimeoutMS"
This option specifies the time limit, in milliseconds, for write concern acknowledgement. It is only applicable when "w" is greater than 1, as the timeout pertains to replication. If the write concern is not satisfied within the time limit, a MongoCursorException will be thrown. A value of 0 may be specified to block indefinitely. The default value for MongoClient is 10000 (ten seconds).
"safe"
Deprecated. Please use the WriteConcern w option.
"timeout"
Integer, defaults to MongoCursor::$timeout. If "safe" is set, this sets how long (in milliseconds) for the client to wait for a database response. If the database does not respond within the timeout period, a MongoCursorTimeoutException will be thrown.

返回值

如果设置了 w，返回包含此次保存状态的一个 array。否则，返回一个 boolean，表示数组是否为空（空数组不会被插入）。

错误／异常

如果插入的文档时空的，或者包含零长度的键，将抛出 MongoException。尝试插入包含 protected 和 private 属性的对象将导致零长度键的错误。

Throws MongoCursorException if the "w" option is set and the write fails.

Throws MongoCursorTimeoutException if the "w" option is set to a value greater than one and the operation takes longer than MongoCursor::$timeout milliseconds to complete. This does not kill the operation on the server, it is a client-side timeout. The operation in MongoCollection::$wtimeout is milliseconds.

更新日志

版本	说明
1.5.0	增加 "wTimeoutMS" 选项来代替 "wtimeout"。使用 "wtimeout" 时出现 `E_DEPRECATED` 错误。新增 "socketTimeoutMS" 选项来代替 "timeout"。使用 "timeout" 时出现 `E_DEPRECATED` 错误。使用 "safe" 时出现 `E_DEPRECATED` 错误。
1.2.0	增加 "timeout" 选项。
1.0.11	设置 "safe" 时，当出现 "not master" 错误时主动断开连接。
1.0.9	增加 "fsync" 选项。
1.0.5	增加 `options` 参数。

范例

Example #1 MongoCollection::save() 例子


<?php

$obj = array('x' => 1);

// 插入 $obj 到 db
$collection->save($obj);
var_dump($obj);

// 增加额外的字段
$obj['foo'] = 'bar';

// $obj 不能被再次插入，导致 duplicate _id 错误
$collection->insert($obj);

// 保存、更新附带新字段的 $obj
$collection->save($obj);

?>

以上例程的输出类似于：

array(2) {
  ["x"]=>
  int(1)
  ["_id"]=>
  object(MongoId)#4 (1) {
    ["$id"]=>
    string(24) "50b6afe544415ed606000000"
  }
}

add a note

User Contributed Notes 1 note

down

-5

cuisdy at gmail dot com ¶

6 years ago


Same as with method insert(), it is worth noting that creating a reference to $obj will have the same effect as $obj being a reference itself, i.e. no _id field will be added.



<?php



$a = &$obj;



$m = new MongoClient;

$collection = $m->test->phpmanual;



$obj = array('x' => 1);



// Suppose you create a reference for some reason

$a = &$obj;



$collection->save($obj);



var_dump($obj);

// prints: array(1) { ["x"]=> int(1) }

?>

add a note

官方地址：https://www.php.net/manual/en/mongocollection.save.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() 多字段排序 PHP json解析（json_decode）页面工具 mysql面试题 php中几种注释规范 PHP5 扩展SOAP 调用 webservice PHPMailer设置utf8 PHPMailer字符集CharSet PHP mkdir()写出来的权限与mode值不符合 php扩展开发 [原创]诡异的php-fpm超时问题 PHP获取指定函数定义在哪个文件中及行号

略微加速

PHP官方手册 - 互联网笔记

MongoCollection::save

说明

参数

返回值

错误／异常

更新日志

范例

User Contributed Notes 1 note