mysql_list_dbs

(PHP 4, PHP 5)

mysql_list_dbs列出 MySQL 服务器中可用的数据库

警告

本函数自 PHP 5.4.0 起已废弃,并且它和整个MySQL 扩展自 PHP 7.0.0 开始被移除。 可以选择出于活跃开发中的MySQLiPDO_MySQL扩展来作为替代。 参见MySQL:选择 API 指南来获取更多信息。 用以替代本函数的有:

  • SQL 查询:SHOW DATABASES

说明

mysql_list_dbs(resource $link_identifier = NULL): resource

返回结果指针,包含当前 MySQL 守护进程中可用的数据库。

参数

link_identifier

MySQL 连接。如不指定连接标识,则使用由 mysql_connect() 最近打开的连接。如果没有找到该连接,会尝试不带参数调用 mysql_connect() 来创建。如没有找到连接或无法建立连接,则会生成 E_WARNING 级别的错误。

返回值

Returns a result pointer resource on success, or false on failure. 使用 mysql_tablename() 函数或任何使用结果表的函数(比如 mysql_fetch_array())来遍历此结果指针。

示例

示例 #1 mysql_list_dbs() 示例

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

以上示例的输出类似于:

database1
database2
database3

注释

注意:

为了向下兼容,可以使用下列已废弃的别名: mysql_listdbs()

参见