mysql_drop_db
(PHP 4, PHP 5)
mysql_drop_db — 丢弃(删除)一个 MySQL 数据库
说明
bool <strong>mysql_drop_db</strong>
( string <code>$database_name</code>
[, resource <code>$
link_identifier
</code>
] )
<p>
<strong>mysql_drop_db()</strong> 尝试丢弃(删除)指定连接标识所关联的服务器上的一整个数据库。
</p>
<p>
成功时返回 <strong><code>TRUE</code></strong>, 或者在失败时返回 <strong><code>FALSE</code></strong>。
</p>
<p>
为向下兼容也可以用 <strong>mysql_dropdb()</strong>,但反对这样做。
</p>
<p><strong>Note</strong>:
<p>
不提倡使用 <strong>mysql_drop_db()</strong> 函数。最好用
mysql_query() 提交一条
SQL DROP DATABASE 语句来替代。
</p>
</p>
<strong>Warning</strong>
<p>
如果 MySQL 扩展库是基于 MySQL 4.x 客户端库建立的,则本函数不可用。
</p>
<p>
参见 mysql_create_db() 和
mysql_query()。
</p>
参数
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 查询