MySQL 関数
PHP Manual

mysql_list_dbs

(PHP 4, PHP 5)

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

警告

この拡張モジュールは PHP 5.5.0 で非推奨になりました。将来のバージョンで削除される予定です。 MySQLi あるいは PDO_MySQL を使うべきです。詳細な情報は MySQL: API の選択それに関連する FAQ を参照ください。 この関数の代替として、これらが使えます。

  • SQL クエリー: SHOW DATABASES

説明

resource mysql_list_dbs ([ resource $link_identifier = NULL ] )

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

警告

この関数は、PHP 5.4.0 以降では非推奨となりました。 この関数は決して使わないようにしましょう。

パラメータ

link_identifier

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

返り値

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

例1 mysql_list_dbs() の例

<?php
// 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

注意

注意:

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

参考


MySQL 関数
PHP Manual