Manual do PHP
Anterior |  | Próxima

# mysql_create_db

(PHP 3, PHP 4, PHP 5)

mysql_create_db -- Cria um banco de dados MySQL

## Descrição

bool mysql_create_db ( string database_name [, resource link_identifier] )

mysql_create_db() tenta criar um novo banco de dados no servidor indicado pelo identificador de conexão especificado.

## Parâmetros

`database_name`

  O nome do banco de dados sendo criado.

`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_create_db()

A função mysql_create_db() esta obsoleta. É preferível usar a função mysql_query() para executar ao invés um comando `CREATE DATABASE`.

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

O exemplo acima irá imprimir algo similar a:

    O banco de dados my_db foi criado

## Notas

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

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

## Veja também

mysql_query()
mysql_select_db()

Anterior | Principal | Próxima
mysql_connect | Acima | mysql_data_seek