php man page for mysql_drop_db

MYSQL_DROP_DB(3)							 1							  MYSQL_DROP_DB(3)

mysql_drop_db - Drop (delete) a MySQL database

SYNOPSIS
       Warning

	      This  function  was deprecated in PHP 4.3.0, and will be removed in the future, along with the entirety of the original MySQL exten-
	      sion. Instead, the MySQLi or PDO_MySQL extension should be used. See also MySQL: choosing an API guide  and  related  FAQ  for  more
	      information. Alternatives to this function include:

		     oExecute a
		       DROP DATABASE query

       bool mysql_drop_db (string  $database_name, [resource  $link_identifier = NULL])

DESCRIPTION
       mysql_drop_db(3)  attempts to drop (remove) an entire database from the server associated with the specified link identifier. This function
       is deprecated, it is preferable to use mysql_query(3) to issue an sql DROP DATABASE statement instead.

	      o $database_name
		- The name of the database that will be deleted.

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

	Returns TRUE on success or FALSE on failure.

       Example #1

	      mysql_drop_db(3) alternative example

	      <?php
	      $link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
	      if (!$link) {
		  die('Could not connect: ' . mysql_error());
	      }

	      $sql = 'DROP DATABASE my_db';
	      if (mysql_query($sql, $link)) {
		  echo "Database my_db was successfully dropped
";
	      } else {
		  echo 'Error dropping database: ' . mysql_error() . "
";
	      }
	      ?>

       Warning

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

       Note

	       For backward compatibility, the following deprecated alias may be used: mysql_dropdb(3)

       mysql_query(3).

PHP Documentation Group 													  MYSQL_DROP_DB(3)