mysql_drop_db

(PHP 4, PHP 5)

mysql_drop_db — 丟棄（刪除）一個(gè) MySQL 數(shù)據(jù)庫(kù)

說(shuō)明

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

mysql_drop_db() 嘗試丟棄（刪除）指定連接標(biāo)識(shí)所關(guān)聯(lián)的服務(wù)器上的一整個(gè)數(shù)據(jù)庫(kù)。

成功時(shí)返回 true， 或者在失敗時(shí)返回 false。

為向下兼容也可以用 mysql_dropdb()，但反對(duì)這樣做。

注意:

不提倡使用 mysql_drop_db() 函數(shù)。最好用 mysql_query() 提交一條 SQL DROP DATABASE 語(yǔ)句來(lái)替代。

警告

如果 MySQL 擴(kuò)展庫(kù)是基于 MySQL 4.x 客戶端庫(kù)建立的，則本函數(shù)不可用。

參見(jiàn) mysql_create_db() 和 mysql_query()。

參數(shù)

database_name

The name of the database that will be deleted.

link_identifier

MySQL 連接。如不指定連接標(biāo)識(shí)，則使用由 mysql_connect() 最近打開(kāi)的連接。如果沒(méi)有找到該連接，會(huì)嘗試不帶參數(shù)調(diào)用 mysql_connect() 來(lái)創(chuàng)建。如沒(méi)有找到連接或無(wú)法建立連接，則會(huì)生成 E_WARNING 級(jí)別的錯(cuò)誤。

返回值

成功時(shí)返回 true， 或者在失敗時(shí)返回 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";
}
?>

注釋

注意:

本擴(kuò)展自 PHP 5.5.0 起已廢棄，并在自 PHP 7.0.0 開(kāi)始被移除。應(yīng)使用 MySQLi 或 PDO_MySQL 擴(kuò)展來(lái)替換之。參見(jiàn) MySQL：選擇 API 指南來(lái)獲取更多信息。用以替代本函數(shù)的有：

  • Execute a DROP DATABASE query

警告

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

注意:

為了向下兼容，可以使用下列已廢棄的別名： mysql_dropdb()

參見(jiàn)