# mysql_list_tables

(PHP 4, PHP 5)

mysql_list_tables — Enumerar las tablas de una base de datos MySQL

Advertencia

Esta función está obsoleta en PHP 4.3.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:

- SQL Query: `SHOW TABLES FROM nombre_bd`

### Descripción

mysql_list_tables(string `$database`, resource `$link_identifier` = NULL): resource|false

Devuelve una lista con el nombre de las tablas de una base de datos MySQL.

Esta función está obsoleta. Es preferible usar mysql_query() para ejecutar la sentencia SQL `SHOW TABLES [FROM nombre_bd] [LIKE 'patrón']` en su lugar.

### Parámetros

`database`

  El nombre de la base de datos

`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

El puntero de resultados de tipo resource en caso de éxito o `false` en caso de error.

Use la función mysql_tablename() para atravesar este puntero de resultados, o cualquier otra función para mostrar tablas, como mysql_fetch_array().

### Historial de cambios

Versión | Descripción
--- | ---
4.3.7 | Esta función quedó obsoleta.

### Ejemplos

Ejemplo #1 Ejemplo alternativo de mysql_list_tables()

`<?php
$nombre_bd = 'nombre_bd_mysql';
if (!mysql_connect('anfitrión_mysql', 'usuario_mysql', 'contraseña_mysql')) {
echo 'No se pudo conectar a mysql';
exit;
}
$sql = "SHOW TABLES FROM $nombre_bd";
$resultado = mysql_query($sql);
if (!$resultado) {
echo "Error de BD, no se pudieron listar las tablas\n";
echo 'Error MySQL: ' . mysql_error();
exit;
}
while ($fila = mysql_fetch_row($resultado)) {
echo "Tabla: {$fila[0]}\n";
}
mysql_free_result($resultado);
?>`

### Notas

> Nota:

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

### Ver también

- mysql_list_dbs() - Lista las bases de datos disponibles en un servidor MySQL
- mysql_tablename() - Obtiene el nombre de la tabla de un campo