PHP mysqli multi_query() Function
Example - Object Oriented style
Perform multiple queries against the database:
<?php
$mysqli = new mysqli("localhost","my_user","my_password","my_db");
if ($mysqli -> connect_errno) {
echo "Failed to connect to MySQL: " . $mysqli -> connect_error;
exit();
}
$sql = "SELECT Lastname FROM Persons ORDER BY LastName;";
$sql .= "SELECT Country FROM Customers";
// Execute multi query
if ($mysqli
-> multi_query($sql)) {
do {
// Store first result set
if ($result =
$mysqli -> store_result()) {
while ($row =
$result -> fetch_row()) {
printf("%s\n", $row[0]);
}
$result
-> free_result();
}
// if there are more result-sets, the print a
divider
if ($mysqli -> more_results()) {
printf("-------------\n");
}
//Prepare next result set
} while ($mysqli
-> next_result());
}
$mysqli -> close();
?>
Look at example of procedural style at the bottom.
Definition and Usage
The multi_query() / mysqli_multi_query() function performs one or more queries against the database. The queries are separated with a semicolon.
Syntax
Object oriented style:
$mysqli ->
multi_query(query)
Procedural style:
mysqli_multi_query(connection, query)
Parameter Values
| Parameter | Description |
|---|---|
| connection | Required. Specifies the MySQL connection to use |
| query | Required. Specifies one or more queries, separated with semicolon |
Technical Details
| Return Value: | FALSE if the first query fails |
|---|---|
| PHP Version: | 5+ |
Example - Procedural style
Perform multiple queries against the database:
<?php
$con = mysqli_connect("localhost","my_user","my_password","my_db");
if (mysqli_connect_errno()) {
echo "Failed to connect to MySQL: " . mysqli_connect_error();
exit();
}
$sql = "SELECT Lastname FROM Persons ORDER BY LastName;";
$sql .= "SELECT Country FROM Customers";
// Execute multi query
if (mysqli_multi_query($con, $sql)) {
do {
// Store first result set
if ($result = mysqli_store_result($con)) {
while ($row = mysqli_fetch_row($result)) {
printf("%s\n", $row[0]);
}
mysqli_free_result($result);
}
// if there are more result-sets, the print a
divider
if (mysqli_more_results($con)) {
printf("-------------\n");
}
//Prepare next result set
} while (mysqli_next_result($con));
}
mysqli_close($con);
?>
❮ PHP MySQLi Reference
