La fonction
sql_drop_table() supprime une table SQL de la base de données. Elle retourne
true en cas de réussite,
false sinon.
Elle accepte 4 paramètres :
-#
$table est le nom de la table,
-#
$exist permet de demander à ajouter une vérification sur l’existence de la table lors de la suppression (cela se traduit par l’ajout de
IF EXISTS sur la requête). Par défaut
'', mettre
true pour vérifier,
-#
$serveur,
-#
$option.
Cette fonction
sql_drop_table() s’écrit :
sql_drop_table('table');
sql_drop_table('table', true);
Exemple
Les plugins utilisent souvent cette fonction lors de la suppression complète (données comprises) d’un plugin, comme le plugin « Géographie » :
function geographie_vider_tables($nom_meta_base_version) {
sql_drop_table("spip_geo_pays");
sql_drop_table("spip_geo_regions");
sql_drop_table("spip_geo_departements");
sql_drop_table("spip_geo_communes");
effacer_meta($nom_meta_base_version);
ecrire_metas();
}