# mysql_drop_db

(PHP 4, PHP 5)

mysql_drop_db — Elimina (DROP) una base de datos MySQL

Advertencia

Esta función está obsoleta en PHP 4.3.0, por lo que ha sido eliminada, junto a la totalidad de la extensión original de MySQL, en PHP 7.0.0. En su lugar, utilice las extensiones MySQLi o PDO_MySQL activamente desarrolladas. Véase también la guía MySQL: elegir una API. Las alternativas a esta función son:

- Ejecutar una consulta `DROP DATABASE`

### Descripción

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

mysql_drop_db() intenta eliminar (remover) 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 ejecutar 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 no se especifica el identificador de enlace, se asume el último enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se encuentra o establece ninguna conexión, se genera un error de nivel `E_WARNING`.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo alternativo de mysql_drop_db()

`<?php
$enlace = mysql_connect('localhost', 'usuario_mysql', 'contraseña_mysql');
if (!$enlace) {
die('No pudo conectarse: ' . mysql_error());
}
$sql = 'DROP DATABASE mi_bd';
if (mysql_query($sql, $enlace)) {
echo "La base de datos mi_bd fue eliminada con éxito\n";
} else {
echo 'Error al eliminar la base de datos: ' . mysql_error() . "\n";
}
?>`

### Notas

Advertencia

Ésta función no estará disponible si la extensión MySQL fue construida con una biblioteca cliente MySQL 4.x.

> Nota:

> Por razones de compatibilidad con versiones anteriores, los siguientes alias obsoletos podrían usarse: mysql_dropdb()

### Ver también

- mysql_query() - Enviar una consulta MySQL