Возвращает список колонок таблицы

# mysql_list_fields

(PHP 4, PHP 5)

mysql_list_fields — Возвращает список колонок таблицы

Внимание

Функция устарела с PHP 5.4.0, а в PHP 7.0.0 функцию удалили вместе с модулем MySQL. Вместо этой функции пользуются модулями 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`
  Имя опрашиваемой базы данных.
`table_name`
  Имя опрашиваемой таблицы.
`link_identifier`
  Соединение MySQL. Если идентификатор соединения не был указан, будет использовано последнее соединение, открытое mysql_connect(). Если такое соединение не было найдено, функция попытается создать таковое, как если бы mysql_connect() была вызвана без параметров. Если соединение не было найдено и не смогло быть создано, генерируется ошибка уровня `E_WARNING`.

### Возвращаемые значения

Дескриптор результата (resource) в случае успешного выполнения, или `false` в случае возникновения ошибки.

Возвращаемый результат может быть обработан с помощью следующих функций: 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 'Ошибка при выполнении запроса: ' . 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() - Возвращает флаги, связанные с указанным полем результата запроса
- mysql_info() - Возвращает информацию о последнем запросе

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