(PHP 5, PHP 7, PHP 8)
mysqli::autocommit -- mysqli_autocommit — Turns on or off auto-committing database modifications
Object-oriented style
$enable
): boolProcedural style
Turns on or off auto-commit mode on queries for the database connection.
To determine the current state of autocommit use the SQL command
SELECT @@autocommit
.
mysql
Procedural style only: A mysqli object returned by mysqli_connect() or mysqli_init()
enable
Whether to turn on auto-commit or not.
Returns true
on success or false
on failure.
If mysqli error reporting is enabled (MYSQLI_REPORT_ERROR
) and the requested operation fails,
a warning is generated. If, in addition, the mode is set to MYSQLI_REPORT_STRICT
,
a mysqli_sql_exception is thrown instead.
Example #1 mysqli::autocommit() example
Object-oriented style
<?php/* Tell mysqli to throw an exception if an error occurs */mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);$mysqli = new mysqli("localhost", "my_user", "my_password", "world");/* The table engine has to support transactions */$mysqli->query("CREATE TABLE IF NOT EXISTS language ( Code text NOT NULL, Speakers int(11) NOT NULL ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;");/* Turn autocommit off */$mysqli->autocommit(false);$result = $mysqli->query("SELECT @@autocommit");$row = $result->fetch_row();printf("Autocommit is %s\n", $row[0]);try { /* Prepare insert statement */ $stmt = $mysqli->prepare('INSERT INTO language(Code, Speakers) VALUES (?,?)'); $stmt->bind_param('ss', $language_code, $native_speakers); /* Insert some values */ $language_code = 'DE'; $native_speakers = 50_123_456; $stmt->execute(); $language_code = 'FR'; $native_speakers = 40_546_321; $stmt->execute(); /* Commit the data in the database. This doesn't set autocommit=true */ $mysqli->commit(); print "Committed 2 rows in the database\n"; $result = $mysqli->query("SELECT @@autocommit"); $row = $result->fetch_row(); printf("Autocommit is %s\n", $row[0]); /* Try to insert more values */ $language_code = 'PL'; $native_speakers = 30_555_444; $stmt->execute(); $language_code = 'DK'; $native_speakers = 5_222_444; $stmt->execute(); /* Setting autocommit=true will trigger a commit */ $mysqli->autocommit(true); print "Committed 2 row in the database\n";} catch (mysqli_sql_exception $exception) { $mysqli->rollback(); throw $exception;}
Procedural style
<?php/* Tell mysqli to throw an exception if an error occurs */mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);$mysqli = mysqli_connect("localhost", "my_user", "my_password", "world");/* The table engine has to support transactions */mysqli_query($mysqli, "CREATE TABLE IF NOT EXISTS language ( Code text NOT NULL, Speakers int(11) NOT NULL ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;");/* Turn autocommit off */mysqli_autocommit($mysqli, false);$result = mysqli_query($mysqli, "SELECT @@autocommit");$row = mysqli_fetch_row($result);printf("Autocommit is %s\n", $row[0]);try { /* Prepare insert statement */ $stmt = mysqli_prepare($mysqli, 'INSERT INTO language(Code, Speakers) VALUES (?,?)'); mysqli_stmt_bind_param($stmt, 'ss', $language_code, $native_speakers); /* Insert some values */ $language_code = 'DE'; $native_speakers = 50_123_456; mysqli_stmt_execute($stmt); $language_code = 'FR'; $native_speakers = 40_546_321; mysqli_stmt_execute($stmt); /* Commit the data in the database. This doesn't set autocommit=true */ mysqli_commit($mysqli); print "Committed 2 rows in the database\n"; $result = mysqli_query($mysqli, "SELECT @@autocommit"); $row = mysqli_fetch_row($result); printf("Autocommit is %s\n", $row[0]); /* Try to insert more values */ $language_code = 'PL'; $native_speakers = 30_555_444; mysqli_stmt_execute($stmt); $language_code = 'DK'; $native_speakers = 5_222_444; mysqli_stmt_execute($stmt); /* Setting autocommit=true will trigger a commit */ mysqli_autocommit($mysqli, true); print "Committed 2 row in the database\n";} catch (mysqli_sql_exception $exception) { mysqli_rollback($mysqli); throw $exception;}
The above examples will output:
Autocommit is 0 Committed 2 rows in the database Autocommit is 0 Committed 2 row in the database Autocommit is 0 Committed 2 rows in the database Autocommit is 0 Committed 2 row in the database
Note:
This function does not work with non transactional table types (like MyISAM or ISAM).