# mysql_list_fields

(PHP 4, PHP 5)

mysql_list_fields — Lista los campos de una tabla de MySQL

Advertencia

Esta función está obsoleta en PHP 5.4.0, por lo que ha sido eliminada, junto a la totalidad de la extensión original de MySQL, en PHP 7.0.0. En su lugar, utilice las extensiones MySQLi o PDO_MySQL activamente desarrolladas. Véase también la guía MySQL: elegir una API. Las alternativas a esta función son:

- Consulta SQL: `SHOW COLUMNS FROM alguna_tabla`

### Descripción

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

Devuelve información sobre el nombre de la tabla dado.

Esta función está obsoleta. Es preferible usar mysql_query() para ejecutar una consulta SQL `SHOW COLUMNS FROM tabla [LIKE 'nombre']` en su lugar.

### Parámetros

`database_name`

  El nombre de la base de la base de datos que está siendo consultada.

`table_name`

  El nombre de la tabla que está siendo consultada.

`link_identifier`

  La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se encuentra o establece ninguna conexión, se genera un error de nivel `E_WARNING`.

### Valores devueltos

Un resource del puntero del resultado en caso de éxito, o `false` en caso de error.

El resultado devuelto puede ser usado con mysql_field_flags(), mysql_field_len(), mysql_field_name() y mysql_field_type().

### Ejemplos

Ejemplo #1 Alternativa para la obsoleta mysql_list_fields()

`<?php
$resultado = mysql_query("SHOW COLUMNS FROM alguna_tabla");
if (!$resultado) {
echo 'No se pudo ejecutar la consulta: ' . mysql_error();
exit;
}
if (mysql_num_rows($resultado) > 0) {
while ($fila = mysql_fetch_assoc($resultado)) {
print_r($fila);
}
}
?>`

El resultado del ejemplo sería algo similar 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:

> Por razones de compatibilidad con versiones anteriores, los siguientes alias obsoletos podrían usarse: mysql_listfields()

### Ver también

- mysql_field_flags() - Obtiene las banderas asociadas al campo especificado de un resultado
- mysql_info() - Obtiene información sobre la consulta más reciente