php8.5
Home/ Manual/ mysql / functions/ mysql_list_fields

mysql_list_fields

PHP function Edit on GitHub ✎

(PHP 4, PHP 5)

List MySQL table fields

5-4-0 SQL Query: SHOW COLUMNS FROM sometable

Description

mysql_list_fields(string $database_name, string $table_name, resource $link_identifier = NULL): resource

Retrieves information about the given table name.

This function is deprecated. It is preferable to use mysql_query() to issue an SQL SHOW COLUMNS FROM table [LIKE 'name'] statement instead.

Parameters

database_name

The name of the database that's being queried.

table_name

The name of the table that's being queried.

Return Values

A result pointer resource on success, or false on failure.

The returned result can be used with mysql_field_flags(), mysql_field_len(), mysql_field_name()Listendand mysql_field_type().

Examples

Alternate to deprecated mysql_list_fields()

php
<?php
$result = mysql_query("SHOW COLUMNS FROM sometable");
if (!$result) {
    echo 'Could not run query: ' . mysql_error();
    exit;
}
if (mysql_num_rows($result) > 0) {
    while ($row = mysql_fetch_assoc($result)) {
        print_r($row);
    }
}
?>

The above example will output something similar to:

output
Array
(
    [Field] => id
    [Type] => int(7)
    [Null] =>
    [Key] => PRI
    [Default] =>
    [Extra] => auto_increment
)
Array
(
    [Field] => email
    [Type] => varchar(100)
    [Null] =>
    [Key] =>
    [Default] =>
    [Extra] =>
)

Notes

See Also

Source: reference/mysql/functions/mysql-list-fields.xml · from the official PHP manual (php/doc-en)