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

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 3 notes

down

mbevan at marginsoftware dot com ¶

21 years ago

If you're willing to use a lot of functions to get a little information about fields in a table, this function is for you.  If you just want to get all the information you can find, you can use this:

<?php

// Taken from: http://ca.php.net/manual/en/function.mysql-field-flags.php
// Original by: amir at scrounch dot com
// Returns the name of the fields in the primary key for a table.
// Also keeps the fields in KEY order.  Handy.
function getPrimaryKeyOf($table) { 
  $keys = Array();

  $query = sprintf("SHOW KEYS FROM `%s`", $table);
  $result = mysql_query($query) or die(mysql_error());

  while ($row = mysql_fetch_assoc($result)) {
    if ( $row['Key_name'] == 'PRIMARY' )
      $keys[$row['Seq_in_index'] - 1] = $row['Column_name'];
  }

  return $keys;
}

// Returns a bunch of information about a table...
// The name of the auto-increment field, if any, fields in the
// primary key (using the function above), and all information
// about all fields.
function getTableInformationOf($table) {
  $information = array(
      "auto"    => "",
      "primary" => array(),
      "fields"  => array()
    );

  $information['primary'] = $this->getPrimaryKeyOf($table);

  $result = mysql_query("DESC `$table`");
  while ( $field = mysql_fetch_assoc($result) ) {
    $information['fields'][] = $field;
    if ( $field['Extra'] == "auto_increment" )
      $information['auto'] = $field['Field'];
  }

  return $information;
}

?>

down

rhyous at yahoo dot com ¶

19 years ago

To make an array containing the names of a column from a table, you use the following simple script: (Note: using table1 with three columns)



<?php

$qColumnNames = mysql_query("SHOW COLUMNS FROM table1",$db) or die("mysql error");

$numColumns = mysql_num_rows($qColumnNames);

$x = 0;

while ($x < $numColumns)

{

    $colname = mysql_fetch_row($qColumnNames);

    $col[$colname[0]] = $colname[0];

    $x++;

}



print_r($col);



/* it will have the following output

Array (

[firstcolumn] => firstcolumn

[secondcolumn] => secondcolumn

[thirdcolumn] => thirdcolumn

)

*/

?>



Or you can number the columns from zero.  This help when using it in conjunction with mysql_fetch_row to get an array.  You don't have to remember which number of the array a certain column is.



<?php

$qColumnNames = mysql_query("SHOW COLUMNS FROM table1",$db) or die("mysql error");

$numColumns = mysql_num_rows($qColumnNames);

$x = 0;

while ($x < $numColumns)

{

    $colname = mysql_fetch_row($qColumnNames);

    $col[$colname[0]] = $x;

    $x++;

}



print_r($col);



/* it will have the following output

Array (

[firstcolumn] => 0

[secondcolumn] => 1

[thirdcolumn] => 2

)

*/

?>



To use it in conjuction with mysql_fetch_row:



<?php

$row = mysql_fetch_row("SELECT * from table1",$db) or die("mysql error");

?>



You can now call $row[col[firstcolumn]].  This becomes useful when you have a lot of columns.

down

-3

phpflow at gmail dot com ¶

12 years ago

Below script is used to get all coloumn indormation of an table.When we are working custome ORM then we need to match the coloumn name with array keys.



<?php

function getColoumn($table) {

     $result = mysql_query("SHOW COLUMNS FROM ". $table);

      if (!$result) {

        echo 'Could not run query: ' . mysql_error();

      }

      $fieldnames=array();

      if (mysql_num_rows($result) > 0) {

        while ($row = mysql_fetch_assoc($result)) {

          $fieldnames[] = $row['Field'];

        }

      }



      return $fieldnames;

}

?>

＋add a note