mysql_list_dbs

List databases available on a MySQL server

&mysql.alternative.note.5-4-0;

- SQL Query: `SHOW DATABASES`

&reftitle.description; `resource` `mysql_list_dbs` `resource` `link_identifier` NULL

Returns a result pointer containing the databases available from the current mysql daemon.

&reftitle.parameters;

&mysql.linkid.description;
&reftitle.returnvalues;

Returns a result pointer `resource` on success, or &false; on failure. Use the `mysql_tablename` function to traverse this result pointer, or any function for result tables, such as `mysql_fetch_array`.

&reftitle.examples;

### `mysql_list_dbs` 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'] . "\n";
    }

    // 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 . "\n";
    }
    ?>

&example.outputs.similar;

    database1
    database2
    database3

&reftitle.notes;

&info.deprecated.alias; `mysql_listdbs`

&reftitle.seealso;

- `mysql_db_name`
- `mysql_select_db`