Manual do PHP
Anterior |  | Próxima

# mysql_drop_db

(PHP 3, PHP 4, PHP 5)

mysql_drop_db -- Exclui um banco de dados MySQL

## Descrição

bool mysql_drop_db ( string database_name [, resource link_identifier] )

mysql_drop_db() tenta remover todo um banco de dados do servidor associado ao identificador de conexão dado. Esta função é obsoleta, é preferível usar mysql_query() para realilar um comando sql `DROP DATABASE` ao invés.

## Parâmetros

`database_name`

  O nome do banco de dados que será excluído.

`link_identifier`

  A conexão MySQL. se o identificador de conexão não for especificado, a ultima conexão aberta por mysql_connect() é assumida. Se uma conexão assim não for encontrada, ela irá tentar criar uma como se a função mysql_connect() fosse chamada sem argumentos. Se uma conexão não for encontrada ou estabelecida, um aviso de nível `E_WARNING` é gerado.

## Valores de retornado

Retorna `TRUE` em caso de sucesso ou `FALSE` em falhas.

## Exemplos

Exemplo 1. Exemplo alternativo de mysql_drop_db()

`<?php $link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$link) { die('Não foi possível conectar: ' . mysql_error()); } $sql = 'DROP DATABASE my_db'; if (mysql_query($sql, $link)) { echo "O banco de dados foi excluído com sucesso\n"; } else { echo 'Erro ao excluir o banco de dados: ' . mysql_error() . "\n"; } ?>`

## Notas

Atenção
Esta função não estará disponível se a extensão MySQL foi compilada com a versão da biblioteca de cliente MySQL 4.x.

> Nota: Para compatibilidade com versões anteriores, o seguinte apelido obsoleto pode ser usado: mysql_dropdb()

## Veja também

mysql_query()

Anterior | Principal | Próxima
mysql_db_query | Acima | mysql_errno