mysql_list_dbs

(PHP 4, PHP 5)

mysql_list_dbs — Lista las bases de datos disponibles en un servidor MySQL

Advertencia

Esta función está obsoleta en PHP 5.4.0, por lo que será eliminada en el futuro, junto con la totalidad de la extensión original de MySQL. Deberían utilizarse en su lugar las extensiones MySQLi o PDO_MySQL. Véase también la guía MySQL: elegir una API y P+F relacionadas para más información. Las alternativas a esta función incluyen:

  • Consulta SQL: SHOW DATABASES

Descripción

resource mysql_list_dbs ([ resource $link_identifier = NULL ] )

Devuelve un puntero de resultados que contiene las bases de datos disponibles en el demonio de mysql actual.

Parámetros

link_identifier

La conexión MySQL. Si el identificador de enlace no se especifica, el último enlace abierto por mysql_connect() es asumido. Si no se encuentra dicho enlace, la función intentará establecer un nuevo enlace como si mysql_connect() fuese invocado sin parámetros. Si no se encuentra o establece una conexión, un error de nivel E_WARNING es generado.

Valores devueltos

Devuelve un resource de puntero de resultados en caso de éxito, o FALSE en caso de error. Use la función mysql_tablename() para atravesar este puntero de resultado, o cualquier función para obtener tablas, tal como mysql_fetch_array().

Ejemplos

Ejemplo #1 Ejemplo de mysql_list_dbs()

<?php
// Uso sin mysql_list_dbs()
$enlace = mysql_connect('localhost', 'usuario_mysql', 'contraseña_mysql');
$resultado = mysql_query("SHOW DATABASES");

while ($fila = mysql_fetch_assoc($res)) {
    echo $fila['Database'] . "\n";
}

// Obsoleto a partir de PHP 5.4.0
$enlace = mysql_connect('localhost', 'usuario_mysql', 'contraseña_mysql');
$lista_bd = mysql_list_dbs($enlace);

while ($fila = mysql_fetch_object($lista_bd)) {
     echo $fila->Database . "\n";
}
?>

El resultado del ejemplo sería algo similar a:

basedatos1
basedatos2
basedatos3

Notas

Nota:

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

Ver también