(PHP 4, PHP 5)
mysql_list_dbs — MySQL サーバー上で利用可能なデータベースのリストを得る
この拡張モジュールは PHP 5.5.0 で非推奨になりました。将来のバージョンで削除される予定です。 MySQLi あるいは PDO_MySQL を使うべきです。詳細な情報は MySQL: API の選択 や それに関連する FAQ を参照ください。 この関数の代替として、これらが使えます。
$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()