PHP mysqli_stmt_fetch() Function

---

---

Definition and Usage

You can create a prepared statement, which has parameter markers ("?") in case of values using the mysqli_prepare() function. Once you prepare a statement, you need to bind values to the parameters of the created statement using the mysqli_stmt_bind_param() function.

In the same way you can bound the columns of the result set of a statement to desired variables using the mysqli_stmt_bind_result() function.

After you have bound the columns if you invoke the mysqli_stmt_fetch() function, it fetches the columns of the result into the specified variables.

Syntax

mysqli_stmt_fetch($stmt);

Parameters

Return Values

The PHP mysqli_stmt_fetch() function returns TRUE if the data is fetched, FALSE in case of an error and, NULL if there are no more rows in the result.

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_stmt_fetch() function (in procedural style) −

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

   mysqli_query($con, "CREATE TABLE myplayers(ID INT, First_Name VARCHAR(255), Last_Name VARCHAR(255), Place_Of_Birth VARCHAR(255), Country VARCHAR(255))");
   print("Table Created.....\n");
   mysqli_query($con, "INSERT INTO myplayers values(1, 'Sikhar', 'Dhawan', 'Delhi', 'India')");
   mysqli_query($con, "INSERT INTO myplayers values(2, 'Jonathan', 'Trott', 'CapeTown', 'SouthAfrica')");
   print("Record Inserted.....\n");

   //Retrieving the contents of the table
   $stmt = mysqli_prepare($con, "SELECT * FROM myplayers");

   //Executing the statement
   mysqli_stmt_execute($stmt);

   //Binding values in result to variables
   mysqli_stmt_bind_result($stmt, $id, $fname, $lname, $pob, $country);

   while (mysqli_stmt_fetch($stmt)) {
      print("Id: ".$id."\n");
      print("fname: ".$fname."\n");
      print("lname: ".$lname."\n");
      print("pob: ".$pob."\n");
      print("country: ".$country."\n");
      print("\n");

   }
   //Closing the statement
   mysqli_stmt_close($stmt);

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

This will produce following result −

Table Created.....
Record Inserted.....
Id: 1
fname: Sikhar
lname: Dhawan
pob: Delhi
country: India

Id: 2
fname: Jonathan
lname: Trott
pob: CapeTown
country: SouthAfrica

Example

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

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

   $con -> query("CREATE TABLE Test(Name VARCHAR(255), AGE INT)");
   $con -> query("insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)");
   print("Table Created.....\n");

   $stmt = $con -> prepare( "SELECT * FROM Test WHERE Name in(?, ?)");
   $stmt -> bind_param("ss", $name1, $name2);
   $name1 = 'Raju';
   $name2 = 'Rahman';
   print("Records Deleted.....\n");

   //Executing the statement
   $stmt->execute();

   //Binding variables to resultset
   $stmt->bind_result($name, $age);
   while ($stmt->fetch()) {
      print("Name: ".$name."\n");
      print("Age: ".$age."\n");
   }

   //Closing the statement
   $stmt->close();

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

This will produce following result −

Table Created.....
Records Deleted.....
Name: Raju
Age: 25
Name: Rahman
Age: 30

Example

Following example fetches the results of the DESCRIBE query using mysqli_stmt_bind_result() and mysqli_stmt_fetch() functions −

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

   mysqli_query($con, "CREATE TABLE myplayers(ID INT, First_Name VARCHAR(255), Last_Name VARCHAR(255), Place_Of_Birth VARCHAR(255), Country VARCHAR(255))");
   print("Table Created.....\n");

   //Description of the table
   $stmt = mysqli_prepare($con, "DESC myplayers");

   //Executing the statement
   mysqli_stmt_execute($stmt);

   //Binding values in result to variables
   mysqli_stmt_bind_result($stmt, $field, $type, $null, $key, $default, $extra);

   while (mysqli_stmt_fetch($stmt)) {
      print("Field: ".$field."\n");
      print("Type: ".$type."\n");
      print("Null: ".$null."\n");
      print("Key: ".$key."\n");
      print("Default: ".$default."\n");
      print("Extra: ".$extra."\n");
      print("\n");
   }

   //Closing the statement
   mysqli_stmt_close($stmt);

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

This will produce following result −

Table Created.....
Field: ID
Type: int(11)
Null: YES
Key:
Default:
Extra:

Field: First_Name
Type: varchar(255)
Null: YES
Key:
Default:
Extra:

Field: Last_Name
Type: varchar(255)
Null: YES
Key:
Default:
Extra:

Field: Place_Of_Birth
Type: varchar(255)
Null: YES
Key:
Default:
Extra:

Field: Country
Type: varchar(255)
Null: YES
Key:
Default:
Extra:

Example

Following example fetches the results of the SHOW TABLES query using mysqli_stmt_bind_result() and mysqli_stmt_fetch() functions −

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

   //Selecting the database
   mysqli_query($con, "CREATE DATABASE NewDatabase");
   mysqli_select_db($con, "NewDatabase");

   //Creating tables
   mysqli_query($con, "CREATE TABLE test1(Name VARCHAR(255), Age INT)");
   mysqli_query($con, "CREATE TABLE test2(Name VARCHAR(255), Age INT)");
   mysqli_query($con, "CREATE TABLE test3(Name VARCHAR(255), Age INT)");
   print("Tables Created.....\n");

   //Description of the table
   $stmt = mysqli_prepare($con, "SHOW TABLES");

   //Executing the statement
   mysqli_stmt_execute($stmt);

   //Binding values in result to variables
   mysqli_stmt_bind_result($stmt, $table_name);

   print("List of tables in the current database: \n");
   while (mysqli_stmt_fetch($stmt)) {
      print($table_name."\n");
   }

   //Closing the statement
   mysqli_stmt_close($stmt);

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

This will produce following result −

Tables Created.....
List of tables in the current database:
test1
test2
test3