PHP mysqli_rollback() 函式



定義和用法

MySQL 資料庫有一個名為自動提交的功能,如果啟用它,對資料庫所做的更改會自動儲存;如果停用它,則需要使用 mysqli_commit() 函式顯式儲存更改。

mysqli_rollback() 函式將當前事務回滾到最後一個儲存點(或指定的儲存點)。

語法

mysqli_rollback($con, [$flags, $name]);

引數

序號 引數和描述
1

con(必填)

這是一個表示與 MySQL 伺服器連線的物件。

2

flags(可選)

一個常量,可以是以下之一:

  • MYSQLI_TRANS_COR_AND_CHAIN

  • MYSQLI_TRANS_COR_AND_NO_CHAIN

  • MYSQLI_TRANS_COR_RELEASE

  • MYSQLI_TRANS_COR_NO_RELEASE

3

name(可選)

這是一個名稱值,如果給出,則執行為 ROLLBACK/*name*/

返回值

PHP mysqli_rollback() 函式返回一個布林值,如果操作成功則為 true,否則為 false

PHP 版本

此函式首次出現在 PHP 5 版本中,並在所有後續版本中均有效。

示例

以下示例演示了 mysqli_rollback() 函式的用法(過程式風格):-

<?php
   //Creating a connection
   $con = mysqli_connect("localhost", "root", "password", "mydb");

   //Setting auto commit to false
   mysqli_autocommit($con, False);
   mysqli_query($con, "CREATE TABLE IF NOT EXISTS my_team(ID INT, First_Name VARCHAR(255), Last_Name VARCHAR(255), Place_Of_Birth VARCHAR(255), Country VARCHAR(255))");
   //Inserting a records into the my_team table
   mysqli_query($con, "insert into my_team values(1, 'Shikhar', 'Dhawan', 'Delhi', 'India')");
   mysqli_query($con, "insert into my_team values(2, 'Jonathan', 'Trott', 'CapeTown', 'SouthAfrica')");
   mysqli_query($con, "insert into my_team values(3, 'Kumara', 'Sangakkara', 'Matale', 'Srilanka')");
   mysqli_query($con, "insert into my_team values(4, 'Virat', 'Kohli', 'Delhi', 'India')");

   $res = mysqli_query($con, "SELECT * FROM my_team");
   print("No.of rows (at the time of commit): ".mysqli_affected_rows($con)."\n");

   //Saving the changes
   mysqli_commit($con);

   //Truncating the table
   mysqli_query($con, "DELETE FROM my_team where id in(3,4)"); 
   $res = mysqli_query($con, "SELECT * FROM my_team");
   print("No.of rows (before roll back): ".mysqli_affected_rows($con)."\n");

   //Roll back
   mysqli_rollback($con);

   //Contents of the table
   $res = mysqli_query($con, "SELECT * FROM my_team");
   print("No.of rows (after roll back): ".mysqli_affected_rows($con));

   //Closing the connection
   mysqli_close($con);
?>

這將產生以下結果:-

No.of rows (at the time of commit): 4
No.of rows (before roll back): 2
No.of rows (after roll back): 4

示例

此方法在面向物件風格中的語法為 $con->rollback()。以下是此函式在面向物件模式下的示例:

//Creating a connection
$con = new mysqli("localhost", "root", "password", "mydb");

//Setting auto commit to false
$con->autocommit(FALSE);

//Inserting a records into the players table
$con->query("CREATE TABLE IF NOT EXISTS players(First_Name VARCHAR(255), Last_Name VARCHAR(255), Country VARCHAR(255))");
$con->query("insert into players values('Shikhar', 'Dhawan', 'India')");
$con->query("insert into players values('Jonathan', 'Trott', 'SouthAfrica')");

//Saving the results
$con->commit();

$con->query( "insert into players values('Kumara', 'Sangakkara', 'Srilanka')");
$con->query( "insert into players values('Virat', 'Kohli', 'India')");

//Roll back
$con->rollback();

$res = $con->query("SELECT * FROM players");
print_r($res);


//Closing the connection
$res = $con -> close();
?>

這將產生以下結果:-

mysqli_result Object
(
    [current_field] => 0
    [field_count] => 3
    [lengths] =>
    [num_rows] => 2
    [type] => 0
)

示例

<?php
   $connection = mysqli_connect("localhost", "root", "password", "mydb");
   
   if (mysqli_connect_errno($connection)){
      echo "Failed to connect to MySQL: " . mysqli_connect_error();
   }
   mysqli_autocommit($connection,FALSE); 
   
   mysqli_query($connection, "create table test(Name VARCHAR(255), Age INT)");   
   mysqli_query($connection, "INSERT INTO test VALUES ('Sharukh', 25)");

   mysqli_commit($connection);
   
   mysqli_query($connection, "INSERT INTO test VALUES ('Kalyan', 30)");
   
   mysqli_rollback($connection);
   mysqli_close($connection);
?>

執行上述程式後,如果驗證 test 表的內容,您可以看到插入的記錄如下:-

mysql> select * from test;
+---------+------+
| Name    | Age  |
+---------+------+
| Sharukh |   25 |
+---------+------+
1 row in set (0.00 sec)
php_function_reference.htm
廣告