MongoDB\Driver\Exception\CommandException::getResultDocument()函数—用法及示例

函数名称：MongoDB\Driver\Exception\CommandException::getResultDocument()

适用版本：MongoDB\Driver 1.0.0 及以上版本

用法：该函数用于获取命令异常的结果文档。

示例：

<?php

// 引入MongoDB\Driver\Exception命名空间
use MongoDB\Driver\Exception\CommandException;

try {
    // 运行一个可能抛出CommandException的命令
    // ...

} catch (CommandException $e) {
    // 获取命令异常的结果文档
    $resultDocument = $e->getResultDocument();

    if ($resultDocument) {
        // 输出结果文档的内容
        var_dump($resultDocument);
    } else {
        // 如果结果文档为空，则输出错误信息
        echo "Command failed: " . $e->getMessage();
    }
}

?>

在上面的示例中，我们首先引入了MongoDB\Driver\Exception\CommandException命名空间，然后在try-catch块中执行可能抛出CommandException的命令。如果命令执行失败，catch块会捕获到CommandException异常。

在catch块中，我们使用getResultDocument()函数获取异常的结果文档，并将其存储在$resultDocument变量中。然后，我们可以根据需要对结果文档进行处理，例如输出其内容或输出错误信息。

请注意，getResultDocument()函数只有在命令执行失败时才会返回非空结果文档，如果命令执行成功，则返回null。因此，在使用此函数之前，应该先检查结果文档是否为空，以避免不必要的处理。