php man page for mysql_list_dbs

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)