Updated date:

How to Populate HTML Drop Down List From Mysql Table Using Php Function?

Timothy is an enthusiast programmer and loves developing websites. He is expert in HTML, CSS, JavaScript, PHP, C#, and ASP[dot]NET.

how-to-populate-html-dropdown-list-from-mysql-table-using-php-function

Populating HTML drop down list instead of filling it with static values has many advantages such as-

  1. List grows/ shrinks automatically and dynamically as the new values are added/ removed.
  2. List can be edited without affecting the code or user interface.
  3. Data in the list can be easily sorted.

therefore creating a dynamic list from database is the most used technique in web development.

The working of dynamic drop down list is illustrated in following figure-

how-to-populate-html-dropdown-list-from-mysql-table-using-php-function

The working of application is very simple. The php object retrieves the value from MySql table and fills the html drop down list.

For creating dynamic drop down list, first we need to have a database table that actually holds our data. In this example I have created a very simple table called City with only two fields i.e. city id and city name. The city id is the primary key. The code for table is following:

CREATE TABLE IF NOT EXISTS `city` (
  `city_id` int(11) NOT NULL AUTO_INCREMENT,
  `city_name` varchar(150) DEFAULT NULL,
  
  PRIMARY KEY (`city_id`)
) ENGINE=InnoDB  DEFAULT CHARSET=latin1 AUTO_INCREMENT=1;

After the table is created, you need to input some records. You may input your own data or use following data that I am using in this example for testing purpose:

INSERT INTO `city` (`city_name`) VALUES
('Jabalpur'),
( 'Bhopal'),
( 'Delhi'),
( 'Kolkata'),
( 'Mumbai'),
( 'Pune'),
( 'Indore'),
( 'Jhansi'),
('Chennai');

Please note that I am not using city id in insert statement because it is auto generated primary key which the MySql itself takes care.

After our data is ready, we need to write code to extract data. For this I have created a PHP class with a method to fetch data from table. The code is given below:

class MyClass {
		
	private $host = "localhost";
	private $user = "root";
	private $password = "";
	private $database = "test";

	private $con;
	
    function __construct() {
        $this->con =  $this->connectDB();
	}	

   function connectDB() {
		$con = mysqli_connect($this->host,$this->user,$this->password,$this->database);
		return $con;
	}

    function getData($query) {
        $result = mysqli_query($this->conn, $query);
        while($row=mysqli_fetch_assoc($result)) {
            $resultset[] = $row;
        }		
        if(!empty($resultset))
            return $resultset;
	}

}

In the PHP class from above code I have defined two functions. The connectDB() functions connects to the database and returns a connection object. The second function is the getData() function which accepts one parameter and returns a result set. The parameter to this function is the select statement. The getData() function actually returns the array of data. This function is therefore an example of function that returns multiple values.

Copy the above code in the file MyClass.php or any name that you wold like.


The next step is to create a list box and populate it. The following code illustrates it. Create a PHP file and copy and paste following code in it.

<?php
	include "MyClass.php";
?>

<!DOCTYPE html>
<html>
<head>
	<title>Test</title>
</head>
<body>
	<?php 

		$obj = new MyClass();
		$row = $obj->getData("select city_name from city"); 
	?>
 	<select>
		<?php foreach($row as $row){ ?>
    		<option><?php echo $row['city_name'] ?></option>
              
  	<?php  } ?>
  	</select>
</body>
</html>

As in above code, first include php file that contain php class. After including file, create the object of class and call the function by passing select statement as parameter to fetch the record. Catch the data returned by function getData into variable row and loop through row to retrieve each record and add it to drop down list.

The drop down list displays the names of city. However when you use this drop down list in an input form that store data to another sql table, you will never want to store the names of city in the table because then you will create a de-normalized table structure. So instead of storing names of city you would want to store city id of associated city.

Consider the following table structure:

how-to-populate-html-dropdown-list-from-mysql-table-using-php-function

In this case the primary key of your city table would become foreign key of another table and the details are extracted using the primary key and foreign key. To associate city id which each city names use the following code.

<?php
	include "MyClass.php";
?>

<!DOCTYPE html>
<html>
<head>
	<title>Test</title>
</head>
<body>
	<?php 

		$obj = new MyClass();
		$row = $obj->getData("select city_id, city_name from city"); 
	?>
 	<select>
		<?php foreach($row as $row){ ?>
    		<option value='<?php echo $row['city_id'] ?>'><?php echo $row['city_name'] ?></option>
              
  	<?php  } ?>
  	</select>
</body>
</html>

In the above code I have only changed the select statement to add city id field and added value attribute in drop down list and bind it to city id field. So whenever user select a city name, the corresponding city id will be selected and when you submit the form the data of the value attribute will be submitted.

Comments

jarzhinomarillier@gmail.com on June 03, 2020:

thanks so much i would like to do a multi-level dropdown populated by a data base. can you assist