feat(ModuleInstaller): Add method to rename tables in the DB

setup/moduleinstaller.class.inc.php

@@ -258,7 +258,7 @@ public static function MoveColumnInDB($sOrigTable, $sOrigColumn, $sDstTable, $sD
 			return;
 		}
 
-		if (!CMDBSource::IsTable($sOrigTable) || !CMDBSource::IsField($sOrigTable, $sOrigColumn))
+		if (!CMDBSource::IsField($sOrigTable, $sOrigColumn))
 		{
 			// Original field is not present
 			return;
@@ -290,4 +290,41 @@ public static function MoveColumnInDB($sOrigTable, $sOrigColumn, $sDstTable, $sD
 		CMDBSource::CacheReset($sDstTable);
 	}
 
+	/**
+	 * Rename a table providing:
+	 * - The original name exists
+	 * - The destination name does not exist
+	 *
+	 * @param $sOrigTable string
+	 * @param $sDstTable string
+	 *
+	 * @return void
+	 * @throws CoreException
+	 * @throws MySQLException
+	 */
+	public static function RenameTableInDB(string $sOrigTable, string $sDstTable)
+	{
+		if (!MetaModel::DBExists(false))
+		{
+			// Install from scratch, no migration
+			return;
+		}
+
+		if (!CMDBSource::IsTable($sOrigTable))
+		{
+			// Origin table is not present
+			return;
+		}
+
+		if (CMDBSource::IsTable($sDstTable))
+		{
+			// Destination table is already present
+			return;
+		}
+
+		$sQueryRename = sprintf(/** @lang MariaDB */ "RENAME TABLE `%s` TO `%s`;", $sOrigTable, $sDstTable);
+		CMDBSource::Query($sQueryRename);
+
+		CMDBSource::CacheReset($sOrigTable);
+	}
 }

tests/php-unit-tests/unitary-tests/setup/ModuleInstallerAPITest.php

@@ -128,4 +128,26 @@ public function MoveColumnInDB_IgnoreExistingDstColumnParamProvider(): array
 		];
 	}
 
+	/**
+	 * Test that the table has been renamed
+	 *
+	 * @covers \ModuleInstallerAPI::MoveColumnInDB
+	 *
+	 * @return void
+	 * @throws \CoreException
+	 * @throws \MySQLException
+	 */
+	public function testRenameTableInDB()
+	{
+		$sOrigTable = MetaModel::DBGetTable('Person');
+		$aOrigTableInfo = CMDBSource::GetTableInfo($sOrigTable);
+		$this->assertNotEmpty($aOrigTableInfo, 'Origin table does not exist');
+
+		$sDstTable = static::$sWorkTable;
+		$this->assertFalse(CMDBSource::IsTable($sDstTable), 'Work table already exists');
+
+		ModuleInstallerAPI::RenameTableInDB($sOrigTable, $sDstTable);
+
+		$this->assertEquals($aOrigTableInfo, CMDBSource::GetTableInfo($sDstTable), 'Table was not renamed');
+	}
 }