mysql_drop_db
(PHP 4, PHP 5)
mysql_drop_db — Efface une base de données MySQL
Cette extension est obsolète depuis PHP 5.5.0, et sera supprimée dans le futur. À la place, les extensions MySQLi ou PDO_MySQL doivent être utilisées. Voir aussi le guide MySQL : choix de l'API ainsi que la FAQ associée pour plus d'information. Voici les alternatives à cette fonction :
- Exécute une requête DROP DATABASE
Description
$database_name
[, resource $link_identifier
= NULL
] )
mysql_drop_db() essaie d'effacer la base
de données database_name
complète
sur le serveur associé à la ressource de connexion
link_identifier
.
La fonction mysql_drop_db() est obsolète. Il est
préférable d'utiliser mysql_query() avec la requête
DROP DATABASE à la place.
Liste de paramètres
-
database_name
-
Le nom de la base de données à effacer.
-
link_identifier
-
La connexion MySQL. S'il n'est pas spécifié, la dernière connexion ouverte avec la fonction mysql_connect() sera utilisée. Si une telle connexion n'est pas trouvée, la fonction tentera d'ouvrir une connexion, comme si la fonction mysql_connect() avait été appelée sans argument. Si aucune connexion n'est trouvée ou établie, une alerte
E_WARNING
est générée.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Exemples
Exemple #1 Exemple avec mysql_drop_db()
<?php $link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$link) { die('Impossible de se connecter : ' . mysql_error()); } $sql = 'DROP DATABASE my_db'; if (mysql_query($sql, $link)) { echo "La base de données my_db a été effacée avec succès.\n"; } else { echo 'Erreur lors de l\'effacement de la base : ' . mysql_error() . "\n"; } ?>
Notes
Cette fonction ne sera pas disponible si vous avez compilé MySQL avec la bibliothèque cliente MySQL 4.x.
Note:
Pour des raisons de compatibilité ascendante, l'alias obsolète suivant peut être utilisé : mysql_dropdb()