368

I'd like to get all of a mysql table's col names into an array in php?

Is there a query for this?

0

23 Answers 23

620

The best way is to use the INFORMATION_SCHEMA metadata virtual database. Specifically the INFORMATION_SCHEMA.COLUMNS table...

SELECT `COLUMN_NAME` 
FROM `INFORMATION_SCHEMA`.`COLUMNS` 
WHERE `TABLE_SCHEMA`='yourdatabasename' 
    AND `TABLE_NAME`='yourtablename';

It's VERY powerful, and can give you TONS of information without need to parse text (Such as column type, whether the column is nullable, max column size, character set, etc)...

Oh, and it's standard SQL (Whereas SHOW ... is a MySQL specific extension)...

For more information about the difference between SHOW... and using the INFORMATION_SCHEMA tables, check out the MySQL Documentation on INFORMATION_SCHEMA in general...

11
  • 32
    It's only standard SQL if you don't use those stupid mysql-specific backticks to quote table names. I hate them, they make my code look wrong.
    – MarkR
    Commented Nov 12, 2010 at 16:33
  • 24
    @MarkR I actually didn't include them originally when I wrote the answer. But then it just looked like a wall of black writing. So I added the back-ticks to take advantage of the syntax highlighting. Yes, I could have SET @@SESSION.sql_mode = 'ANSI_QUOTES'; before hand as well, but I really don't like that. And I have no issue with the back-ticks for identifier delimitation. In fact, I like them better than double quotes (double quotes makes the query feel wrong to me)... To each their own...
    – ircmaxell
    Commented Nov 12, 2010 at 16:41
  • 3
    Quoting the table names isn't required at all in the above example.
    – MarkR
    Commented Nov 12, 2010 at 16:56
  • 23
    @MarkR I know it's not. That's why I said I actually didn't include them originally when I wrote the answer . I added them to take advantage of syntax highlighting...
    – ircmaxell
    Commented Nov 12, 2010 at 17:03
  • 4
    Be aware that with InnodDB tables select from information_schema can be very painfully slow. In some servers more than one minute
    – macjohn
    Commented Apr 30, 2013 at 10:37
272

You can use the following query for MYSQL:

SHOW `columns` FROM `your-table`;

Below is the example code which shows How to implement above syntax in php to list the names of columns:

$sql = "SHOW COLUMNS FROM your-table";
$result = mysqli_query($conn,$sql);
while($row = mysqli_fetch_array($result)){
    echo $row['Field']."<br>";
}

For Details about output of SHOW COLUMNS FROM TABLE visit: MySQL Refrence.

3
  • 11
    Or... DESC TableName; ;-)
    – double_j
    Commented Oct 15, 2014 at 21:22
  • Note that SHOW COLUMNS is crazy slow and could cause serious performance issues when used since DB engine may recalculate table statistics on every call.
    – stealz
    Commented Feb 4, 2022 at 9:16
  • @stealz Describe seems to be a shortcut to SHOW COLUMNS. Commented Oct 23, 2022 at 17:07
69

Seems there are 2 ways:

DESCRIBE `tablename`

or

SHOW COLUMNS FROM `tablename`

More on DESCRIBE here: http://dev.mysql.com/doc/refman/5.0/en/describe.html

3
  • 5
    Ahh, DESCRIBE is just a shortcut for SHOW COLUMNS FROM. Commented Nov 12, 2010 at 13:47
  • 10
    And DESC is even shorter-hand for DESCRIBE! Commented Sep 8, 2014 at 16:18
  • 1
    Yes @SurrealDreams but with DESCRIBE cannot be used with WHERE. For example : SHOW COLUMNS FROM acct__order WHERE ``Key`` = 'PRI'; to get the Primary key of a table is not working with DESCRIBE.
    – Meloman
    Commented Sep 2, 2020 at 11:45
27

I have done this in the past.

SELECT column_name
FROM information_schema.columns
WHERE table_name='insert table name here'; 
15

Edit: Today I learned the better way of doing this. Please see ircmaxell's answer.


Parse the output of SHOW COLUMNS FROM table;

Here's more about it here: http://dev.mysql.com/doc/refman/5.0/en/show-columns.html

7

The simplest solution out of all Answers:

DESC `table name`

or

DESCRIBE `table name`

or

SHOW COLUMNS FROM `table name`
7

Use mysql_fetch_field() to view all column data. See manual.

$query = 'select * from myfield';
$result = mysql_query($query);
$i = 0;
while ($i < mysql_num_fields($result))
{
   $fld = mysql_fetch_field($result, $i);
   $myarray[]=$fld->name;
   $i = $i + 1;
}

"Warning This extension is deprecated as of PHP 5.5.0, and will be removed in the future."

1
  • 4
    mysqli_num_fields() and mysqli_fetch_field_direct() are the updated methods
    – El Gucs
    Commented Apr 24, 2016 at 6:24
6

this generates a string of column names with a comma delimiter:

    SELECT CONCAT('(',GROUP_CONCAT(`COLUMN_NAME`),')') 
    FROM `INFORMATION_SCHEMA`.`COLUMNS` 
    WHERE `TABLE_SCHEMA`='database_name' 
    AND `TABLE_NAME`='table_name';
5

An old PHP function "mysql_list_fields()" is deprecated. So, today the best way to get names of fields is a query "SHOW COLUMNS FROM table_name [LIKE 'name']". So, here is a little example:

$fields = array();
$res=mysql_query("SHOW COLUMNS FROM mytable");
while ($x = mysql_fetch_assoc($res)){
  $fields[] = $x['Field'];
}
foreach ($fields as $f) { echo "<br>Field name: ".$f; }
5

when you want to check your all table structure with some filed then use this code. In this query i select column_name,column_type and table_name for more details . I use order by column_type so i can see it easily.

SELECT `COLUMN_NAME`,COLUMN_TYPE,TABLE_NAME 
FROM `INFORMATION_SCHEMA`.`COLUMNS` 
WHERE `TABLE_SCHEMA`='yourdatabasename' order by DATA_TYPE;

If you want to check only double type filed then you can do it easily

SELECT `COLUMN_NAME`,COLUMN_TYPE,TABLE_NAME,DATA_TYPE 
FROM `INFORMATION_SCHEMA`.`COLUMNS` 
WHERE `TABLE_SCHEMA`='yourdatabasename' AND DATA_TYPE like '%bigint%'  order by DATA_TYPE;

enter image description here

if you want to check which field allow null type etc then you can use this

SELECT `COLUMN_NAME`,COLUMN_TYPE,TABLE_NAME,IS_NULLABLE,DATA_TYPE 
FROM `INFORMATION_SCHEMA`.`COLUMNS` 
WHERE `TABLE_SCHEMA`='yourdatabasename' and DATA_TYPE like '%bigint%' and IS_NULLABLE ='NO' order by COLUMN_TYPE;

enter image description here

you want to check more then thik link also help you.

https://dev.mysql.com/doc/refman/5.7/en/columns-table.html

1
4
function get_col_names(){  
    $sql = "SHOW COLUMNS FROM tableName";  
    $result = mysql_query($sql);     
    while($record = mysql_fetch_array($result)){  
     $fields[] = $record['0'];  
    }
    foreach ($fields as $value){  
      echo 'column name is : '.$value.'-';  
}  
 }  

return get_col_names();
4

Not sure if this is what you were looking for, but this worked for me:

$query = query("DESC YourTable");  
$col_names = array_column($query, 'Field');

That returns a simple array of the column names / variable names in your table or array as strings, which is what I needed to dynamically build MySQL queries. My frustration was that I simply don't know how to index arrays in PHP very well, so I wasn't sure what to do with the results from DESC or SHOW. Hope my answer is helpful to beginners like myself!

To check result: print_r($col_names);

3

SHOW COLUMNS in mysql 5.1 (not 5.5) uses a temporary disk table.

So it can be considered slow for some cases. At least, it can bump up your created_tmp_disk_tables value. Imagine one temporary disk table per connection or per each page request.

SHOW COLUMNS is not really so slow, possibly because it uses file system cache. Phpmyadmin says ~0.5ms consistently. This is nothing compared to 500ms-1000ms of serving a wordpress page. But still, there are times it matters. There is a disk system involvement, you never know what happens when server is busy, cache is full, hdd is stalled etc.

Retrieving column names through SELECT * FROM ... LIMIT 1 was around ~0.1ms, and it can use query cache as well.

So here is my little optimized code to get column names from a table, without using show columns if possible:

function db_columns_ar($table)
{
//returns Array('col1name'=>'col1name','col2name'=>'col2name',...)
if(!$table) return Array();
if(!is_string($table)) return Array();

global $db_columns_ar_cache;
if(!empty($db_columns_ar_cache[$table]))
    return $db_columns_ar_cache[$table];


//IMPORTANT show columns creates a temp disk table
$cols=Array();
$row=db_row_ar($q1="SELECT * FROM `$table` LIMIT 1");
if($row)
    {
    foreach($row as $name=>$val)
        $cols[$name]=$name;
    }
else
    {
    $coldata=db_rows($q2="SHOW COLUMNS FROM `$table`");
    if($coldata)
        foreach($coldata as $row)
            $cols[$row->Field]=$row->Field;
    }
$db_columns_ar_cache[$table]=$cols;
//debugexit($q1,$q2,$row,$coldata,$cols);
return $cols;
}

Notes:

  • As long as your tables first row does not contain megabyte range of data, it should work fine.
  • The function names db_rows and db_row_ar should be replaced with your specific database setup.
2
  • Hi Johan, I get error: Call to undefined function db_row_ar(), when I run db_columns_ar('myTableName'); Commented Oct 30, 2013 at 15:07
  • Sorry for that, I will clarify it in text. That was an imaginary function name, standing for whatever your database class or setup uses for that type of thing.
    – Johan
    Commented Oct 31, 2013 at 18:14
3

IN WORDPRESS:

global $wpdb;   $table_name=$wpdb->prefix.'posts';
foreach ( $wpdb->get_col( "DESC " . $table_name, 0 ) as $column_name ) {
  var_dump( $column_name );
}
3

Try this one out I personally use it:

SHOW COLUMNS FROM $table where field REGEXP 'stock_id|drug_name' 
2
  • 1
    why are you selecting only column names "stock_id" and "drug_name"? Commented Jul 20, 2015 at 15:43
  • worked for me but without the "where..." stuff. With PDO: $this->dbHandle = new PDO(...); $query = 'SHOW COLUMNS FROM ' . $tableName; $stmt = $this->dbHandle->query($query); $results = $stmt->fetchAll(PDO::FETCH_ASSOC); foreach ($results as $result) { //do something with each $result }
    – Zaphoid
    Commented Mar 17, 2016 at 19:15
2

This question is old, but I got here looking for a way to find a given query its field names in a dynamic way (not necessarily only the fields of a table). And since people keep pointing this as the answer for that given task in other related questions, I'm sharing the way I found it can be done, using Gavin Simpson's tips:

//Function to generate a HTML table from a SQL query
function myTable($obConn,$sql)
{
    $rsResult = mysqli_query($obConn, $sql) or die(mysqli_error($obConn));
    if(mysqli_num_rows($rsResult)>0)
    {
        //We start with header. >>>Here we retrieve the field names<<<
        echo "<table width=\"100%\" border=\"0\" cellspacing=\"2\" cellpadding=\"0\"><tr align=\"center\" bgcolor=\"#CCCCCC\">";
        $i = 0;
        while ($i < mysqli_num_fields($rsResult)){
           $field = mysqli_fetch_field_direct($rsResult, $i);
           $fieldName=$field->name;
           echo "<td><strong>$fieldName</strong></td>";
           $i = $i + 1;
        }
        echo "</tr>"; 
        //>>>Field names retrieved<<<

        //We dump info
        $bolWhite=true;
        while ($row = mysqli_fetch_assoc($rsResult)) {
            echo $bolWhite ? "<tr bgcolor=\"#CCCCCC\">" : "<tr bgcolor=\"#FFF\">";
            $bolWhite=!$bolWhite;
            foreach($row as $data) {
                echo "<td>$data</td>";
            }
            echo "</tr>";
        }
        echo "</table>";
    }
}

This can be easily modded to insert the field names in an array.

Using a simple: $sql="SELECT * FROM myTable LIMIT 1" can give you the fields of any table, without needing to use SHOW COLUMNS or any extra php module, if needed (removing the data dump part).

Hopefully this helps someone else.

2

if you use php, use this gist.

it can get select fields full info with no result,and all custom fields such as:

SELECT a.name aname, b.name bname, b.* 
FROM table1 a LEFT JOIN table2 b
ON a.id = b.pid;

if above sql return no data,will also get the field names aname, bname, b's other field name

just two line:

$query_info = mysqli_query($link, $data_source);
$fetch_fields_result = $query_info->fetch_fields();
2

This query fetches a list of all columns in a database without having to specify a table name. It returns a list of only column names:

SELECT COLUMN_NAME
  FROM INFORMATION_SCHEMA.COLUMNS
  WHERE table_schema = 'db_name'

However, when I ran this query in phpmyadmin, it displayed a series of errors. Nonetheless, it worked. So use it with caution.

2

if you only need the field names and types (perhaps for easy copy-pasting into Excel):

SELECT COLUMN_NAME, DATA_TYPE
FROM INFORMATION_SCHEMA.COLUMNS
WHERE TABLE_SCHEMA='databasenamegoeshere'
AND DATA_TYPE='decimal' and TABLE_NAME = 'tablenamegoeshere'

remove

DATA_TYPE='decimal'

if you want all data types

1

i no expert, but this works for me..

$sql = "desc MyTable";
$result = @mysql_query($sql);
while($row = @mysql_fetch_array($result)){
    echo $row[0]."<br>"; // returns the first column of array. in this case Field

      // the below code will return a full array-> Field,Type,Null,Key,Default,Extra    
      // for ($c=0;$c<sizeof($row);$c++){echo @$row[$c]."<br>";}    

}
0

I have tried this query in SQL Server and this worked for me :

SELECT name FROM sys.columns WHERE OBJECT_ID = OBJECT_ID('table_name')
0

The call of DESCRIBE is working fine to get all columns of a table but if you need to filter on it, you need to use the SHOW COLUMNS FROM instead.

Example of PHP function to get all info of a table :

// get table columns (or return false if table not found)
function get_table_columns($db, $table) {
    
    global $pdo;

    if($cols = $pdo->query("DESCRIBE `$db`.`$table`")) {
        if($cols = $cols->fetchAll(PDO::FETCH_ASSOC)) {
            return $cols;
        }
    }
    
    return false;
}

In my case, I had to find the primary key of a table. So, I used :

SHOW COLUMNS FROM `table` WHERE `Key`='PRI';

Here is my PHP function :

// get table Primary Key
function get_table_pk($db, $table) {

    global $pdo;
            
    $q = "SHOW COLUMNS FROM `$db`.`$table` WHERE `Key` = 'PRI'";
    if($cols = $pdo->query($q)) {
        if($cols = $cols->fetchAll(PDO::FETCH_ASSOC)) {
            return $cols[0];
        }
    }
    
    return false;
}
0

Extending to ircmaxell answer, If you ever want to run a select/insert sentence using all the columns from a table (it may be the reason your are browsing this topic, like me) you can use the group_concat function like this:

SELECT group_concat(COLUMN_NAME) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA='databaseName' AND TABLE_NAME='tableName';

It will return "field1,field2,field3,fieldN" which is handy for this kind of operations.

Not the answer you're looking for? Browse other questions tagged or ask your own question.