Удалить таблицу Connection::dropTable

Модуль: main — подключать отдельно не нужно

Доступно с версии: 14.5.1

Метод Connection::dropTable удаляет таблицу запросом DROP TABLE и очищает кеш описания ее колонок. Запрос не содержит IF EXISTS. Если таблицы нет, база данных вернет ошибку.

Сигнатура метода в классе Bitrix\Main\DB\Connection:

abstract public function dropTable($tableName);

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
tableName* string Задает имя таблицы

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

Возвращаемое значение

Метод ничего не возвращает.

Исключения

Исключение Когда возникает
Bitrix\Main\DB\SqlQueryException База данных вернула ошибку, например таблицы нет
Bitrix\Main\DB\ConnectionException Подключиться к базе данных не удалось

Примеры

Пример. Код создает рабочую таблицу, удаляет ее и проверяет, что таблицы больше нет:

<?php
use Bitrix\Main\Application;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$connection = Application::getConnection();

$connection->queryExecute('CREATE TABLE demo_api_status (ID INT NOT NULL)');
$connection->dropTable('demo_api_status');

var_dump($connection->isTableExists('demo_api_status'));

Смотрите также