トップページ　→関数リファレンス　→データベース関連　→ベンダー固有のモジュール　→MySQL　→MySQL (最初の API)

関数・クラス解説

mysql_list_dbs

version:PHP 4, PHP 5 (公式)

MySQL サーバー上で利用可能なデータベースのリストを得る

公式リファレンス

書式

mysql_list_dbs ([ resource $link_identifier = NULL ] ) : resource

説明

現在の mysql デーモンで利用可能なデータベースの結果ポインタを返します。

パラメータ

link_identifier: MySQL 接続。指定されない場合、mysql_connect() により直近にオープンされたリンクが指定されたと仮定されます。そのようなリンクがない場合、引数を指定せずにmysql_connect() がコールした時と同様にリンクを確立します。リンクが見付からない、または、確立できない場合、E_WARNING レベルのエラーが生成されます。

返値

成功した場合に結果ポインタ resource を、失敗した場合に FALSE を返します。結果ポインタの中身を調べるために mysql_tablename() 関数を利用し、取得したテーブルを利用するには mysql_fetch_array() などの関数を利用してください。

注意

注意: 下位互換のために、次の非推奨別名を使用してもいいでしょう。 mysql_listdbs()

警告この関数は PHP 5.4.0 で非推奨になり、PHP 7.0.0 でMySQL 拡張モジュール全体とあわせて削除されました。MySQLi あるいはPDO_MySQL を使うべきです。詳細な情報はMySQL: API の選択やそれに関連する FAQ を参照ください。この関数の代替として、これらが使えます。

SQL クエリー: SHOW DATABASES

サンプル

例1 mysql_list_dbs() の例 

// 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";
}

// 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";
}

 上の例の出力は、たとえば以下のようになります。 
database1
database2
database3