列出 MySQL 表字段

# mysql_list_fields

(PHP 4, PHP 5)

mysql_list_fields — 列出 MySQL 表字段

警告

本函数自 PHP 5.4.0 起已废弃，并且它和整个MySQL 扩展自 PHP 7.0.0 开始被移除。 可以选择出于活跃开发中的MySQLi或PDO_MySQL扩展来作为替代。 参见MySQL：选择 API 指南来获取更多信息。 用以替代本函数的有：

- SQL 查询：`SHOW COLUMNS FROM sometable`

### 说明

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

检索指定表名的信息。

此函数已弃用。最好使用 mysql_query() 发出 SQL `SHOW COLUMNS FROM table [LIKE 'name']` 语句代替。

### 参数

`database_name`
  The name of the database that's being queried.
`table_name`
  The name of the table that's being queried.
`link_identifier`
  MySQL 连接。如不指定连接标识，则使用由 mysql_connect() 最近打开的连接。如果没有找到该连接，会尝试不带参数调用 mysql_connect() 来创建。如没有找到连接或无法建立连接，则会生成 `E_WARNING` 级别的错误。

### 返回值

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

结果指针，可以用于 mysql_field_flags()、mysql_field_len()、mysql_field_name() 和 mysql_field_type()。

### 示例

示例 #1 替代弃用 mysql_list_fields()

    <?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);
        }
    }
    ?>

以上示例的输出类似于：

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

### 注释

> 注意: 为了向下兼容，可以使用下列已废弃的别名： mysql_listfields()

### 参见

- mysql_field_flags() - 从结果中取得和指定字段关联的 flags
- mysql_info() - 获取最近查询的有关信息

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open