(mongodb >=0.2.0)
MongoDB\Driver\Manager::executeCommand — Execute a MongoDB database command
$db
, MongoDB\Driver\Command $command
[, MongoDB\Driver\ReadPreference $readPreference
] )
Executes command
on a MongoDB server matching readPreference
.
db
The name of the database on which to execute the command.
command
The command document.
readPreference
Optionally, a MongoDB\Driver\ReadPreference to route the command to. If none given, defaults to the Read Preferences set by the MongoDB Connection URI.
Returns MongoDB\Driver\Cursor on success, throws exception (instanceof MongoDB\Driver\Exception) on failure.
Example #1 MongoDB\Driver\Manager::executeCommand() example
<?php
$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");
$command = new MongoDB\Driver\Command(array("ping" => 1));
try {
$cursor = $manager->executeCommand("admin", $command);
$response = $cursor->toArray()[0];
} catch(MongoDB\Driver\Exception $e) {
echo $e->getMessage(), "\n";
exit;
}
var_dump($response);
?>
以上例程的输出类似于:
array(1) { ["ok"]=> float(1) }
Note:
For write commands, MongoDB\Driver\WriteConcern is included in the
command
document itself.
Note:
If a secondary
readPreference
is used, it is the caller's responsibility to ensure that thecommand
can be executed on a secondary. No validation is done by the driver.