MYSQL_LIST_DBS(3) 1 MYSQL_LIST_DBS(3)
mysql_list_dbs - List databases available on a MySQL server
SYNOPSIS
Warning
This function was deprecated in PHP 5.4.0, and will be removed in the future, along with the entirety of the original MySQL exten-
sion. Instead, the MySQLi or PDO_MySQL extension should be used. See also MySQL: choosing an API guide and related FAQ for more
information. Alternatives to this function include:
oSQL Query:
SHOW DATABASES
resource mysql_list_dbs ([resource $link_identifier = NULL])
DESCRIPTION
Returns a result pointer containing the databases available from the current mysql daemon.
o $
link_identifier -The MySQL connection. If the link identifier is not specified, the last link opened by mysql_connect(3) is
assumed. If no such link is found, it will try to create one as if mysql_connect(3) was called with no arguments. If no connection
is found or established, an E_WARNING level error is generated.
Returns a result pointer resource on success, or FALSE on failure. Use the mysql_tablename(3) function to traverse this result pointer, or
any function for result tables, such as mysql_fetch_array(3).
Example #1
mysql_list_dbs(3) example
<?php
// Usage without mysql_list_dbs()
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
$res = mysql_query("SHOW DATABASES");
while ($row = mysql_fetch_assoc($res)) {
echo $row['Database'] . "
";
}
// Deprecated as of PHP 5.4.0
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
$db_list = mysql_list_dbs($link);
while ($row = mysql_fetch_object($db_list)) {
echo $row->Database . "
";
}
?>
The above example will output something similar to:
database1
database2
database3
Note
For backward compatibility, the following deprecated alias may be used: mysql_listdbs(3)
mysql_db_name(3), mysql_select_db(3).
PHP Documentation Group MYSQL_LIST_DBS(3)
