Session::setSavepoint()

在当前会话中创建一个保存点，以便在事务中进行回滚操作

首字母：S

函数名称：Session::setSavepoint()

适用版本：PHP 7.4.0 及以上版本

函数描述：Session::setSavepoint() 方法用于在当前会话中创建一个保存点，以便在事务中进行回滚操作。

语法：bool Session::setSavepoint(string $name)

参数：

$name：保存点的名称，必须是一个唯一的字符串。

返回值：

成功时返回 true，失败时返回 false。

示例代码：

// 开启会话
session_start();
// 设置保存点
if (session_status() === PHP_SESSION_ACTIVE) {
 $savepointName = 'mySavepoint';
 if ($_SESSION['loggedIn']) {
 // 如果用户已登录，则创建一个保存点
 if (session_set_save_handler(new MySessionHandler()) {
 // 通过调用 Session::setSavepoint() 方法创建保存点
 if (Session::setSavepoint($savepointName)) {
 echo '保存点创建成功！';
 } else {
 echo '保存点创建失败！';
 }
 }
 }
}
// 回滚到保存点的示例代码：
if (session_status() === PHP_SESSION_ACTIVE) {
 $savepointName = 'mySavepoint';
 if ($_SESSION['loggedIn']) {
 // 如果用户已登录，则回滚到保存点
 if (session_set_save_handler(new MySessionHandler()) {
 // 通过调用 Session::rollbackTo() 方法回滚到保存点
 if (Session::rollbackTo($savepointName)) {
 echo '回滚成功！';
 } else {
 echo '回滚失败！';
 }
 }
 }
}

注意事项：

Session::setSavepoint() 方法只能在事务中使用，即在使用自定义 session 处理程序时才有效。
该方法需要在会话开启且活动状态下调用（即在调用 session_start() 后）。
保存点的名称必须是一个唯一的字符串，以便在回滚时使用。
通过调用 Session::rollbackTo() 方法可以回滚到保存点。
如果保存点不存在或回滚失败，将返回 false。
请确保在使用该方法之前已正确设置自定义 session 处理程序。

同首字母函数