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

# mysql_drop_db

(PHP 4, PHP 5)

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

警告

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

- Execute a `DROP DATABASE` query

### 说明

function mysql_drop_db(string `$database_name`, resource `$ link_identifier` = ?): bool

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

成功时返回 `true`， 或者在失败时返回 `false`。

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

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

警告

如果 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`。

### 示例

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

### 注释

警告

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

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

### 参见

- mysql_query() - 发送一条 MySQL 查询

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open