DocResult::fetchOne()函数—用法及示例

函数: DocResult::fetchOne() 适用版本: PHP 7.1 及以上 用法: fetchOne(): mixed

该函数是一个静态方法，用于从文档结果集中获取单个文档（即一条记录）。它返回单个文档作为一个关联数组或一个对象，或者在没有文档可用时返回null。

示例:

// 假设我们有一个名为 $result 的文档结果集对象

// 从结果集中获取单个文档作为关联数组
$documentAsArray = DocResult::fetchOne($result);

// 从结果集中获取单个文档作为对象
$documentAsObject = DocResult::fetchOne($result, DocResult::FETCH_OBJECT);

// 在没有文档可用时返回默认值
$documentOrDefault = DocResult::fetchOne($result) ?: ['id' => 0, 'name' => 'Unknown'];

// 使用返回的文档数据
echo $documentAsArray['name']; // 输出文档的名称
echo $documentAsObject->description; // 输出文档的描述

// 处理未找到文档的情况
if ($documentAsArray === null) {
    echo "未找到该文档";
}

请注意，fetchOne() 函数返回的文档可以是一个关联数组，也可以是一个对象，具体取决于第二个参数（可选）传递的值。默认情况下，它返回关联数组。如果想返回对象，可以将第二个参数设置为 DocResult::FETCH_OBJECT。在上面的示例中，我们展示了如何使用这两种返回类型。