# mysql_create_db

(PHP 4, PHP 5, PECL mysql:1.0)

mysql_create_db — Create a MySQL database

### Description

bool mysql_create_db ( string `$database_name` [, resource `$link_identifier` ] )

mysql_create_db() attempts to create a new database on the server associated with the specified link identifier.

### Parameters

`database_name`

  The name of the database being created.

`link_identifier`

  The MySQL connection. If the link identifier is not specified, the last link opened by mysql_connect() is assumed. If no such link is found, it will try to create one as if mysql_connect() was called with no arguments. If by chance no connection is found or established, an `E_WARNING` level warning is generated.

### Return Values

Returns `TRUE` on success or `FALSE` on failure.

### Examples

Example#1 mysql_create_db() alternative example

The function mysql_create_db() is deprecated. It is preferable to use mysql_query() to issue a sql CREATE DATABASE statement instead.

`<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
$sql = 'CREATE DATABASE my_db';
if (mysql_query($sql, $link)) {
echo "Database my_db created successfully\n";
} else {
echo 'Error creating database: ' . mysql_error() . "\n";
}
?>`

The above example will output something similar to:

    Database my_db created successfully

### Notes

> Note: For downward compatibility, the following deprecated alias may be used: mysql_createdb()

> Note: This function will not be available if the MySQL extension was built against a MySQL 4.x client library.

### See Also

- mysql_query()
- mysql_select_db()