mysql_drop_db
(PHP 4, PHP 5)
mysql_drop_db — Suprime (elimina) una base de datos MySQL
Descripción
$database_name
[, resource $link_identifier = NULL
] )mysql_drop_db() intenta omitir (remover) una una base de datos entera del servidor asociado con el identificador de enlace especificado. Esta función es obsoleta, es preferible usar mysql_query() para emitir una sentencia sql DROP DATABASE en su lugar.
Parámetros
-
database_name -
El nombre de la base de datos que va a ser eliminada.
-
link_identifier -
La conexión MySQL. Si el identificador de enlace no se especifica, el último enlace abierto por mysql_connect() es asumido. Si no se encuentra dicho enlace, la función intentará establecer un nuevo enlace como si mysql_connect() fuese invocado sin parámetros. Si no se encuentra o establece una conexión, un error de nivel
E_WARNINGes generado.
Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.
Ejemplos
Ejemplo #1 Ejemplo alternativo de mysql_drop_db()
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('No pudo conectarse: ' . mysql_error());
}
$sql = 'DROP DATABASE my_db';
if (mysql_query($sql, $link)) {
echo "La base de datos my_db fue eliminada con éxito\n";
} else {
echo 'Error a omitir la base de datos: ' . mysql_error() . "\n";
}
?>
Notas
Nota: Alternativas sugeridas
El uso de esta función está desaconsejado. En su lugar debería usarse la extensión MySQLi o PDO_MySQL. Véase también MySQL: escoger una API para más información.
Las alternativas a esta función incluyen:
- Ejecutar una consulta DROP DATABASE
Ésta función no estará disponible si la extensión MySQL fue construida con una biblioteca MySQL 4.x del cliente.
Nota:
Por razones de compatibilidad con versiones anteriores, los siguientes alias obsoletos podrían usarse: mysql_dropdb()
