mysql_drop_db()

(PHP 4, PHP 5)

丢弃（删除）一个 MySQL 数据库

说明

mysql_drop_db(string $database_name[,resource$ link_identifier]): bool

mysql_drop_db()尝试丢弃（删除）指定连接标识所关联的服务器上的一整个数据库。

成功时返回TRUE，或者在失败时返回FALSE。

为向下兼容也可以用mysql_dropdb()，但反对这样做。

Note:

不提倡使用mysql_drop_db()函数。最好用mysql_query()提交一条SQL DROP DATABASE语句来替代。

Warning

如果 MySQL 扩展库是基于 MySQL 4.x 客户端库建立的，则本函数不可用。

参见mysql_create_db()和mysql_query()。

参数

$database_name

The name of the database that will be deleted.

$link_identifier

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

返回值

成功时返回TRUE，或者在失败时返回FALSE。

范例

Example #1 mysql_drop_db() alternative example

<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
    die('Could not connect: ' . mysql_error());
}
$sql = 'DROP DATABASE my_db';
if (mysql_query($sql, $link)) {
    echo "Database my_db was successfully dropped\n";
} else {
    echo 'Error dropping database: ' . mysql_error() . "\n";
}
?>

注释

Note:

本扩展自 PHP 5.5.0起已废弃，并在自 PHP 7.0.0 开始被移除。应使用MySQLi或PDO_MySQL扩展来替换之。参见MySQL：选择 API指南以及相关 FAQ来获取更多信息。用以替代本函数的有：

• Execute aDROP DATABASEquery

Warning

This function will not be available if the MySQL extension was built against a MySQL 4.x client library.

Note:

为了向下兼容，可以使用下列已废弃的别名：mysql_dropdb()

参见

• mysql_query()发送一条 MySQL 查询