codecamp

PHP8 MongoDB\Driver\Manager::executeCommand

(mongoDB >=1.0.0)

MongoDB\Driver\Manager::executeCommand — 执行数据库命令

说明

final public MongoDB\Driver\Manager::executeCommand(string $db, MongoDB\Driver\Command $command, array|MongoDB\Driver\ReadPreference|null $options = null): MongoDB\Driver\Cursor

根据选项选择服务器 并在该服务器上执行该命令。默认情况下,主服务器将 被选中。"readPreference"

此方法不对命令应用任何特殊逻辑。虽然这种方法 接受和选项,它们将被合并到 命令文档中,这些选项不会默认为相应的值 从 MongoDB 连接 URI 也不会考虑 MongoDB 服务器版本 帐户。因此,鼓励用户使用特定的读取和/或写入 命令方法(如果可能)。"readConcern""writeConcern"

参数 

db (字符串)

要在其上执行命令的数据库的名称。

command (MongoDB\驱动程序\命令)

要执行的命令。

options
选项
选择类型描述
read关注MongoDB\驱动程序\ReadConcern

要应用于操作的读取关注点。

此选项在 MongoDB 3.2+ 中可用,将导致 如果为较旧的服务器指定了执行时的异常 版本。

readPreferenceMongoDB\Driver\ReadPreference

用于为操作选择服务器的读取首选项。

会期MongoDB\驱动程序\会话

要与操作关联的会话。

写关注点MongoDB\驱动程序\WriteConcern

要应用于操作的写入关注点。

警告

如果您使用的是具有事务的 在进行中,不能指定 OR 选项。这将导致引发 MongoDB\Driver\Exception\InvalidArgumentException。相反,您应该在创建时设置这两个选项 使用 MongoDB\Driver\Session::startTransaction() 的事务。"session""readConcern""writeConcern"

返回值 

成功后返回 MongoDB\Driver\Cursor。

错误/异常 

  • 如果该选项与与 or 选项结合使用的关联事务一起使用,则引发 MongoDB\Driver\Exception\InvalidArgumentException。"session""readConcern""writeConcern"
  • 如果该选项与未确认的写入问题结合使用,则引发 MongoDB\Driver\Exception\InvalidArgumentException。"session"
  • 在参数分析错误时抛出 MongoDB\Driver\Exception\InvalidArgumentException。
  • 如果与服务器的连接失败(由于身份验证以外的原因),则抛出 MongoDB\Driver\Exception\ConnectionException。
  • 如果需要身份验证并失败,则抛出 MongoDB\Driver\Exception\AuthenticationException。
  • 在其他错误(例如,无效命令,向辅助命令发出写入命令)时抛出 MongoDB\Driver\Exception\RuntimeException。

更新日志 

版本说明
PECL mongodb 1.4.4MongoDB\Driver\Exception\InvalidArgumentException,如果在 与未确认的写入问题相结合。"session"
PECL mongodb 1.4.0第三个参数现在是一个数组。 为了向后兼容,此参数仍将接受 MongoDB\Driver\ReadPreference 对象。options

示例 

示例 #1 MongoDB\Driver\Manager::executeCommand() 带有返回单个结果文档的命令

<?php

$manager = new MongoDB\Driver\Manager('mongodb://localhost:27017');
$command = new MongoDB\Driver\Command(['ping' => 1]);

try {
    $cursor = $manager->executeCommand('admin', $command);
} catch(MongoDB\Driver\Exception $e) {
    echo $e->getMessage(), "\n";
    exit;
}

/* The ping command returns a single result document, so we need to access the
 * first result in the cursor. */
$response = $cursor->toArray()[0];

var_dump($response);

?>

以上示例会输出:

array(1) {
  ["ok"]=>
  float(1)
}

示例 #2 MongoDB\Driver\Manager::executeCommand() 带有返回游标的命令

<?php

$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");

$bulk = new MongoDB\Driver\BulkWrite;
$bulk->insert(['x' => 1, 'y' => 'foo']);
$bulk->insert(['x' => 2, 'y' => 'bar']);
$bulk->insert(['x' => 3, 'y' => 'bar']);
$manager->executeBulkWrite('db.collection', $bulk);

$command = new MongoDB\Driver\Command([
    'aggregate' => 'collection',
    'pipeline' => [
        ['$group' => ['_id' => '$y', 'sum' => ['$sum' => '$x']]],
    ],
    'cursor' => new stdClass,
]);
$cursor = $manager->executeCommand('db', $command);

/* The aggregate command can optionally return its results in a cursor instead
 * of a single result document. In this case, we can iterate on the cursor
 * directly to access those results. */
foreach ($cursor as $document) {
    var_dump($document);
}

?>

以上示例会输出:

object(stdClass)#6 (2) {
  ["_id"]=>
  string(3) "bar"
  ["sum"]=>
  int(10)
}
object(stdClass)#7 (2) {
  ["_id"]=>
  string(3) "foo"
  ["sum"]=>
  int(2)
}

示例 #3 限制命令的执行时间

可以通过在 MongoDB\Driver\Command 文档中指定 for 的值来限制命令的执行时间。请注意,这一次 limit 在服务器端强制执行,不会将网络延迟考虑在内 帐户。有关详细信息,请参阅 MongoDB 手册中的 » 终止正在运行的操作。"maxTimeMS"

<?php

$manager = new MongoDB\Driver\Manager('mongodb://localhost:27017');

$command = new MongoDB\Driver\Command([
    'count' => 'collection',
    'query' => ['x' => ['$gt' => 1]],
    'maxTimeMS' => 1000,
]);

$cursor = $manager->executeCommand('db', $command);

var_dump($cursor->toArray()[0]);

?>

如果命令在执行一秒钟后无法完成 服务器,则将抛出 MongoDB\Driver\Exception\ExecutionTimeoutException。

注释 

注意: 如果使用辅助 readReference,则它是 调用方负责确保可以在辅助设备上执行命令。无验证 由司机完成。
注意: 此方法不默认使用MongoDB连接中的读取首选项 URI中。需要该行为的应用程序应考虑使用 MongoDB\Driver\Manager::executeReadCommand()。

参见 

  • MongoDB\驱动程序\命令
  • MongoDB\驱动程序\游标
  • MongoDB\Driver\Manager::executeReadCommand() - 执行读取
  • MongoDB\Driver\Manager::executeReadWriteCommand() - 执行读取和写入的数据库命令
  • MongoDB\Driver\Manager::executeWriteCommand() - 执行一个数据库命令,该命令将
  • MongoDB\Driver\Server::executeCommand() - 在此服务器上执行数据库命令


PHP8 MongoDB\Driver\Manager::executeBulkWrite
PHP8 MongoDB\Driver\Query 类
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

PHP8 语言参考

PHP8 函数参考

PHP8 影响 PHP 行为的扩展

PHP8 Componere

PHP8 安装/配置

PHP8 外部函数接口

PHP8 选项和信息

PHP8 选项/信息 函数

PHP8 Windows Cache for PHP

PHP8 WinCache 函数

PHP8 Yac

PHP8 身份认证服务

PHP8 Radius 函数

PHP8 压缩与归档扩展

PHP8 Phar

PHP8 Zip

PHP8 ZipArchive 类

PHP8 加密扩展

PHP8 OpenSSL

PHP8 OpenSSL 函数

PHP8 Sodium 函数

PHP8 数据库扩展

PHP8 针对各数据库系统对应的扩展

PHP8 CUBRID 函数

PHP8 Firebird/InterBase

PHP8 Firebird/InterBase函数

PHP8 MongoDB介绍驱动程序体系结构和特殊功能

PHP8 MongoDB\Driver\Command 类

PHP8 MongoDB\Driver\Query 类

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }