PHP mysqli_multi_query() Function

---

---

Definition and Usage

The mysqli_multi_query() function accepts a string value representing a query as one of the parameters and, executes/performs the given query on the database.

You can also pass multiple queries to this function by separating them with a semicolon.

You can retrieve the resultset from this function (in case of SELECT, SHOW, DESCRIBE and EXPLAIN queries) using the mysqli_use_result() and mysqli_more_results() or ysqli_store_result() and mysqli_next_result() functions.

Syntax

mysqli_multi_query($con, query)

Parameters

Return Values

The mysqli_multi_query() function returns false incase of the first function.

PHP Version

This function was first introduced in PHP Version 5 and works works in all the later versions.

Example

Following example demonstrates the usage of the mysqli_multi_query() function (in procedural style) −

<?php
   //Creating a connection
   $con = mysqli_connect("localhost", "root", "password", "mydb");
   $query = "CREATE TABLE Test(Name VARCHAR(255), AGE INT); insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)";
   mysqli_multi_query($con, $query);
   print("Data added......");
   //Closing the connection
   mysqli_close($con);
?>

This will produce following result −

Data added......

If you observe the contents of the table in the database you can see the inserted records as shown below −

mysql> select * from players;
+------------+-----------+-------------+
| First_Name | Last_Name | Country     |
+------------+-----------+-------------+
| Shikhar    | Dhawan    | India       |
| Jonathan   | Trott     | SouthAfrica |
+------------+-----------+-------------+
2 rows in set (0.00 sec)

Example

In object oriented style the syntax of this function is $con->multi_query(); Following is the example of this function in object oriented style $minus;

<?php
   $con = new mysqli("localhost", "root", "password", "mydb");
   $query = "CREATE TABLE Test(Name VARCHAR(255), AGE INT); insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)";
   //Inserting a records into the players table
   $con->multi_query($query);
   print("Data Created......");
   //Closing the connection
   $res = $con -> close();
?>

This will produce following result −

Data added......

Example

Following example creates a table and populates it by executing the queries one by one using the mysqli_multi_query() function −

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

   mysqli_multi_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))");
   print("Table Created ..."."\n");

   //Inserting a records into the my_team table
   mysqli_multi_query($con, "insert into my_team values(1, 'Shikhar', 'Dhawan', 'Delhi', 'India')");
   mysqli_multi_query($con, "insert into my_team values(2, 'Jonathan', 'Trott', 'CapeTown', 'SouthAfrica')");
   mysqli_multi_query($con, "insert into my_team values(3, 'Kumara', 'Sangakkara', 'Matale', 'Srilanka')");
   mysqli_multi_query($con, "insert into my_team values(4, 'Virat', 'Kohli', 'Delhi', 'India')");

   print("Records Inserted ..."."\n");

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

This will produce following result −

Table Created ...
Records Inserted ...

Example

Assume we have created a table players in the database and populated it, as shown below −

CREATE TABLE Players (Name VARCHAR(255), Age INT, Score INT);
insert into Players values('Dhavan', 33, 90),('Rohit', 28, 26),('Kohli', 25, 50);

Following example retrieves the resultset from a mysqli_multi_query function −

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

   //Executing the multi query
   $query = "SELECT * FROM players;CREATE TABLE Test (Name VARCHAR(255), Age INT);insert into Test values('Raju', 25),('Rahman', 30),('Ramani', 22);SELECT * FROM Test";

   $res = mysqli_multi_query($con, $query);

   if ($res) {
      do {
         if ($result = mysqli_use_result($con)) {
            while ($row = mysqli_fetch_row($result)) {
               print("Name: ".$row[0]."\n");
               print("Age: ".$row[1]."\n");
            }
            mysqli_free_result($result);
         }
         if (mysqli_more_results($con)) {
            print("\n");
         }
      } while (mysqli_next_result($con));
   }
   mysqli_close($con);
?>

This will produce following result −

Name: Dhavan
Age: 33
Name: Rohit
Age: 28
Name: Kohli
Age: 25

Name: Raju
Age: 25
Name: Rahman
Age: 30
Name: Ramani
Age: 22