array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.mysql-list-fields.php', 1 => 'mysql_list_fields', 2 => 'Возвращает список колонок таблицы', ), 'up' => array ( 0 => 'ref.mysql.php', 1 => 'MySQL', ), 'prev' => array ( 0 => 'function.mysql-list-dbs.php', 1 => 'mysql_list_dbs', ), 'next' => array ( 0 => 'function.mysql-list-processes.php', 1 => 'mysql_list_processes', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mysql/functions/mysql-list-fields.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

Описание

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()

Смотрите также