Implement hasTable() method in Connection::class. (#88)

CHANGELOG.md

@@ -27,6 +27,7 @@ Yii Core version 2 Change Log
 - Enh #84: Remove `Oracle-11c` service image versions in build workflow (@terabytesoftw)
 - Enh #86: Remove unnecesary `resolveTableNames()` and refactor `resolveTableName()` in `Schema::class` in `MSSQL`, `MYSQL`, `OCI`, `PGSQL` (@terabytesoftw)
 - Enh #87: Refactor `TableSchema::class` in `MSSQL` (@terabytesoftw)
+- Enh #88: Implement `hasTable()` method in `Connection::class` (@terabytesoftw)
 
 Yii Framework 2 Change Log
 ==========================

src/db/Connection.php

@@ -990,6 +990,18 @@ public function getTableSchema(string $name, bool $refresh = false): TableSchema
         return $this->getSchema()->getTableSchema($name, $refresh);
     }
 
+    /**
+     * Checks if a table exists.
+     *
+     * @param string $name table name.
+     *
+     * @return bool whether a table exists in the database.
+     */
+    public function hasTable(string $name): bool
+    {
+        return $this->getSchema()->getTableSchema($name, true) !== null;
+    }
+
     /**
      * Returns the ID of the last inserted row or sequence value.
      *

tests/framework/db/connection/AbstractConnection.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace yiiunit\framework\db\connection;
+
+use yii\db\Connection;
+use yii\db\Schema;
+
+abstract class AbstractConnection extends \yiiunit\TestCase
+{
+    protected Connection|null $db = null;
+
+    protected function tearDown(): void
+    {
+        $this->db->close();
+        $this->db = null;
+
+        parent::tearDown();
+    }
+
+    public function testHasTable(): void
+    {
+        $tableName = 'T_table';
+        $this->assertFalse($this->db->hasTable($tableName));
+
+        $result = $this->db->createCommand()->createTable(
+            $tableName,
+            [
+                'id' => Schema::TYPE_PK,
+                'name' => Schema::TYPE_STRING,
+            ],
+        )->execute();
+
+        $this->assertSame(0, $result);
+
+        $this->assertTrue($this->db->hasTable($tableName));
+
+        $result = $this->db->createCommand()->dropTable($tableName)->execute();
+
+        $this->assertSame(0, $result);
+    }
+}

tests/framework/db/mssql/connection/ConnectionTest.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace yiiunit\framework\db\mssql\command;
+
+use yiiunit\support\MssqlConnection;
+
+/**
+ * @group db
+ * @group mssql
+ * @group connection
+ */
+final class ConnectionTest extends \yiiunit\framework\db\connection\AbstractConnection
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->db = MssqlConnection::getConnection();
+    }
+}

tests/framework/db/mysql/connection/ConnectionTest.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace yiiunit\framework\db\mysql\command;
+
+use yiiunit\support\MysqlConnection;
+
+/**
+ * @group db
+ * @group mysql
+ * @group connection
+ */
+final class ConnectionTest extends \yiiunit\framework\db\connection\AbstractConnection
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->db = MysqlConnection::getConnection();
+    }
+}

tests/framework/db/oci/connection/ConnectionTest.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace yiiunit\framework\db\oci\command;
+
+use yiiunit\support\OciConnection;
+
+/**
+ * @group db
+ * @group oci
+ * @group connection
+ */
+final class ConnectionTest extends \yiiunit\framework\db\connection\AbstractConnection
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->db = OciConnection::getConnection();
+    }
+}

tests/framework/db/pgsql/connection/ConnectionTest.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace yiiunit\framework\db\pgsql\command;
+
+use yiiunit\support\PgsqlConnection;
+
+/**
+ * @group db
+ * @group pgsql
+ * @group connection
+ */
+final class ConnectionTest extends \yiiunit\framework\db\connection\AbstractConnection
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->db = PgsqlConnection::getConnection();
+    }
+}

tests/framework/db/sqlite/connection/ConnectionTest.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace yiiunit\framework\db\sqlite\command;
+
+use yiiunit\support\SqliteConnection;
+
+/**
+ * @group db
+ * @group sqlite
+ * @group connection
+ */
+final class ConnectionTest extends \yiiunit\framework\db\connection\AbstractConnection
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->db = SqliteConnection::getConnection();
+    }
+}