[函数]MongoDB\Driver\Session::getTransactionState()函数—用法及示例

函数名称：MongoDB\Driver\Session::getTransactionState()

适用版本：MongoDB PHP扩展版本 1.7.0及以上

函数描述：该函数用于获取当前会话的事务状态。

用法示例：

1. 连接到MongoDB服务器并创建一个会话对象：

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

1. 检查当前会话的事务状态：

$state = $session->getTransactionState();

switch ($state) {
    case MongoDB\Driver\Session::TRANSACTION_NONE:
        echo "当前会话没有事务。";
        break;
    case MongoDB\Driver\Session::TRANSACTION_STARTING:
        echo "当前会话正在启动事务。";
        break;
    case MongoDB\Driver\Session::TRANSACTION_IN_PROGRESS:
        echo "当前会话正在进行事务。";
        break;
    case MongoDB\Driver\Session::TRANSACTION_COMMITTED:
        echo "当前会话的事务已提交。";
        break;
    case MongoDB\Driver\Session::TRANSACTION_ABORTED:
        echo "当前会话的事务已中止。";
        break;
    default:
        echo "无法确定当前会话的事务状态。";
}

注意事项：

• 该函数需要MongoDB PHP扩展版本1.7.0及以上。
• 在使用该函数之前，必须先创建一个有效的会话对象。
• 事务状态可以是以下常量之一：TRANSACTION_NONE（0）、TRANSACTION_STARTING（1）、TRANSACTION_IN_PROGRESS（2）、TRANSACTION_COMMITTED（3）、TRANSACTION_ABORTED（4）。
• 事务状态的含义分别是：没有事务、正在启动事务、正在进行事务、事务已提交、事务已中止。
• 如果无法确定当前会话的事务状态，可能是由于会话对象无效或连接到MongoDB服务器的版本不支持事务功能。