(PHP 4, PHP 5)
mysql_drop_db — 丟棄(刪除)一個 MySQL 數據庫
說明
bool mysql_drop_db ( string$database_name
[, resource $
link_identifier
] )
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 droppedn";
} else {
echo 'Error dropping database: ' . mysql_error() . "n";
}
?>
注釋
Note:
本擴展自 PHP 5.5.0 起已廢棄,并在將來會被移除。應使用 MySQLi 或 PDO_MySQL 擴展來替換之。參見 MySQL:選擇 API 指南以及相關 FAQ 以獲取更多信息。用以替代本函數的有:
Execute a DROP DATABASE query
WarningThis function will not be available if the MySQL extension was built against a MySQL 4.x client library.
Note:
為了向下兼容,可以使用下列已廢棄的別名: mysql_dropdb()
參見
mysql_query() - 發送一條 MySQL 查詢