Lista os campos de uma tabela MySQL

# mysql_list_fields

(PHP 4, PHP 5)

mysql_list_fields — Lista os campos de uma tabela MySQL

Aviso

Esta função foi descontinuada 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

function 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

Exemplo #1 Alternativa para a função descontinuada mysql_list_fields()

    <?php
    $result = mysql_query("SHOW COLUMNS FROM sometable");
    if (!$result) {
        echo 'Não foi possível executar a consulta: ' . 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

> Nota: Para compatibilidade com versões anteriores, o seguinte apelido descontinuado 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

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