Add $ifExists and $cascade to dropTable() methods

CHANGELOG.md

@@ -27,6 +27,8 @@
 - New #374: Add `IndexType` and `IndexMethod` classes (@Tigrov)
 - Enh #376: Move `JsonExpressionBuilder` and JSON type tests to `yiisoft/db` package (@Tigrov)
 - Bug #377: Explicitly mark nullable parameters (@vjik)
+- New #379: Add parameters `$ifExists` and `$cascade` to `CommandInterface::dropTable()` and
+  `DDLQueryBuilderInterface::dropTable()` methods (@vjik)
 
 ## 1.2.0 March 21, 2024
 

src/DDLQueryBuilder.php

@@ -187,4 +187,15 @@ private function getColumnDefinition(string $table, string $column): string
 
         return $matches[2];
     }
+
+    /**
+     * @throws NotSupportedException MySQL doesn't support cascade drop table.
+     */
+    public function dropTable(string $table, bool $ifExists = false, bool $cascade = false): string
+    {
+        if ($cascade) {
+            throw new NotSupportedException('MySQL doesn\'t support cascade drop table.');
+        }
+        return parent::dropTable($table, $ifExists, false);
+    }
 }

tests/CommandTest.php

@@ -93,6 +93,15 @@ public function testDropDefaultValue(): void
         parent::testDropDefaultValue();
     }
 
+    public function testDropTableCascade(): void
+    {
+        $command = $this->getConnection()->createCommand();
+
+        $this->expectException(NotSupportedException::class);
+        $this->expectExceptionMessage('MySQL doesn\'t support cascade drop table.');
+        $command->dropTable('{{table}}', cascade: true);
+    }
+
     /**
      * @dataProvider \Yiisoft\Db\Mysql\Tests\Provider\CommandProvider::rawSql
      *

tests/QueryBuilderTest.php

@@ -4,6 +4,7 @@
 
 namespace Yiisoft\Db\Mysql\Tests;
 
+use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\DataProviderExternal;
 use Throwable;
 use Yiisoft\Db\Command\Param;
@@ -758,4 +759,23 @@ public function testBuildColumnDefinition(string $expected, ColumnInterface|stri
     {
         parent::testBuildColumnDefinition($expected, $column);
     }
+
+    #[DataProvider('dataDropTable')]
+    public function testDropTable(string $expected, ?bool $ifExists, ?bool $cascade): void
+    {
+        if ($cascade) {
+            $qb = $this->getConnection()->getQueryBuilder();
+
+            $this->expectException(NotSupportedException::class);
+            $this->expectExceptionMessage('MySQL doesn\'t support cascade drop table.');
+
+            $ifExists === null
+                ? $qb->dropTable('customer', cascade: true)
+                : $qb->dropTable('customer', ifExists: $ifExists, cascade: true);
+
+            return;
+        }
+
+        parent::testDropTable($expected, $ifExists, $cascade);
+    }
 }