mysql_list_fields

(PHP 4, PHP 5)

mysql_list_fields — Lista os campos de uma tabela MySQL

Warning

Esta função tornou-se defasada a partir do PHP 5.4.0 e ela e a extensão MySQL original foram removidas a partir do PHP 7.0.0. Em vez disso, use as extensões MySQLi ou PDO_MySQL, que são desenvolvidas ativamente. Veja também o guia MySQL: escolhendo uma API. Alternativas a esta função incluem:

  • Consulta SQL: SHOW COLUMNS FROM sometable

Descrição

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

Obtém informações sobre a tabela informada.

Esta função foi descontinuada. É preferrível usar mysql_query() para realizar uma consulta SQL SHOW COLUMNS FROM table [LIKE 'name'].

Parâmetros

database_name

O nome do banco de dados que está sendo consultado.

table_name

O nome da tabela que esta sendo consultada.

link_identifier

A conexão MySQL. Se o identificador da conexão não for especificado, a última conexão aberta por mysql_connect() será usada. Se não houver uma conexão anterior, haverá uma tentativa de criar uma como se mysql_connect() tivesse sido chamada sem argumentos. Se nenhuma conexão for encontrada ou estabelecida, um erro de nível E_WARNING será gerado.

Valor Retornado

Um ponteiro de recurso resource em caso de sucesso, ou false em caso de falha.

O ponteiro de resultado pode ser usado com mysql_field_flags(), mysql_field_len(), mysql_field_name() e mysql_field_type().

Exemplos

Example #1 Alternativa para a função descontinuada 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);
    }
}
?>

O exemplo acima produzirá algo semelhante a:

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

Notas

Note:

Para compatibilidade com versões anteriores, o seguinte apelido defasado pode ser usado: mysql_listfields()

Veja Também

  • mysql_field_flags() - Obtém as opções associadas ao campo especificado em um resultado
  • mysql_info() - Obtém informação sobre a consulta mais recente