PHP | mysqli_query() Function

Hello folks! welcome back to a new edition of our tutorial on PHP. In this tutorial guide, we are going to be studying about the PHP mysqli_query() Function.

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

Syntax

Following below is the syntax to use this function -

mysqli_query($con,  query)

READ: PHP | mysqli_prepare() Function

Parameter Details

Sr.No	Parameter & Description
1	con(Mandatory) This is an object representing a connection to MySQL Server.
2	query(Mandatory) This is a string value representing the query to be executed.
3	mode(Optional) This is a integer value representing the result mode. You can pass MYSQLI_USE_RESULT or MYSQLI_STORE_RESULT as values to this parameter.

Return Value

For SELECT, SHOW, DESCRIBE and then the EXPLAIN queries, this built-in PHP function returns a mysqli_result() object holding the result of the query on success and, false on failure.

For other queries this PHP function returns true if the operation/query is successful or, false if not.

PHP Version

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

Example1

The following example demonstrates the usage of the PHP mysqli_query() function (in procedural style) -

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

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

   //Inserting a records into the my_team table
   mysqli_query($con, "insert into my_team values(1, 'Kennedy', 'Nkpara', 'PortHarcourt', 'Nigeria')");
   mysqli_query($con, "insert into my_team values(2, 'Jonathan', 'Trott', 'CapeTown', 'SouthAfrica')");
   mysqli_query($con, "insert into my_team values(3, 'Queen', 'Dauglas', 'Texas', 'UnitedStates')");
   mysqli_query($con, "insert into my_team values(4, 'Paul', 'Francis', 'Texas', 'UnitedStates')");

   print("Records Inserted ....."."\n");
  
   //Closing the connection
   mysqli_close($con);
?>

Output

When the above code is executed, it will produce the following result -

Table Created......
 Record Inserted......

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

mysql> select * from my_team;
+------+------------+------------+----------------+-------------+
| ID   | First_Name | Last_Name  | Place_Of_Birth | Country     |
+------+------------+------------+----------------+-------------+
|    1 | Kennedy    | Nkpara     | PortHarcourt   | Nigeria     |
|    2 | Jonathan   | Trott      | CapeTown       | SouthAfrica |
|    3 | Queen      | Dauglas    | Texas          | UnitedStates|
|    4 | Paul       | Francis    | Texas          | UnitedStates|
+------+------------+------------+----------------+-------------+
4 rows in set (0.00 sec)

Example2

In an object oriented style the syntax of this built-in PHP function is $con->query(); The following below is an example of this PHP function in an object oriented style $minus;

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

   //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('Kennedy', 'Nkpara', 'Nigeria')");
   $con->query("insert into players values('Jonathan', 'Trott', 'SouthAfrica')");

   print("Data Created........");
   //Closing the connection
   $res = $con -> close();
?>

Output

When the above code is executed, it will produce the following result -

Data Created........

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

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

Example3

Following example below prints the results of INSERT and SELECT queries -

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

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

   //Inserting a records into the my_team table
   $res = mysqli_query($con, "insert into my_team values(1, 'Kennedy', 'Nkpara', 'PortHarcourt', 'Nigeria')");
   print("Result of Insert Query: ".$res."\n");
   $res = mysqli_query($con, "insert into my_team values(2, 'Jonathan', 'Trott', 'CapeTown', 'SouthAfrica')");
   print("Result of Insert Query: ".$res);

   $res = mysqli_query($con, "SELECT * FROM my_team");
   print("Result of the SELECT query: ");
   print_r($res);

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

Output

When the above code is executed, it will produce the following result below -

Table Created ...
Result of Insert Query: 1
Result of Insert Query: 1Result of the SELECT query: mysqli_result Object
(
    [current_field] => 0
    [field_count] => 5
    [lengths] =>
    [num_rows] => 2
    [type] => 0
)

Example4

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('Prince', 28, 90),('Bethel', 27, 26),('Stephanie', 24, 50);

The following example below retrieves the resultset from the built-in mysqli_query() function -

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

   //Executing the multi query
   $query = "SELECT * FROM players";
 
   //Retrieving the records
   $res = mysqli_query($con, $query, MYSQLI_USE_RESULT);
   if ($res) {
      while ($row = mysqli_fetch_row($res)) {
         print("Name: ".$row[0]."\n");
         print("Age: ".$row[1]."\n");
      }
   }

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

Output

When the above code is executed, it will produce the following result below -

Name: Prince
Age: 28
Name: Bethel
Age: 27
Name: Stephanie
Age: 24

READ: PHP | mysqli_init() Function

Alright guys! This is where we are going to be rounding up for this tutorial post. In our next tutorial, we are going to be discussing about the mysqli_real_connect() Function in PHP.

Do feel free to ask your questions where necessary and we will attend to them as soon as possible. If this tutorial was helpful to you, you can use the share button to share this tutorial.

Do follow us on our various social media handles available and also subscribe to our newsletter to get our tutorial posts delivered directly to your emails.

Thanks for reading and bye for now.