feat: Add migration files for tree and multiple_tree tables with support for various database drivers.

migrations/m250707_103609_tree.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+use yii\db\Migration;
+
+class m250707_103609_tree extends Migration
+{
+    public function safeUp()
+    {
+        $primaryKey = $this->db->driverName === 'oci'
+            ? 'NUMBER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY'
+            : $this->primaryKey();
+
+        $nameColumn = $this->db->driverName === 'oci'
+            ? $this->string(4000)->notNull()
+            : $this->text()->notNull();
+
+        $this->createTable('{{%tree}}', [
+            'id' => $primaryKey,
+            'name' => $nameColumn,
+            'lft' => $this->integer()->notNull(),
+            'rgt' => $this->integer()->notNull(),
+            'depth' => $this->integer()->notNull(),
+        ]);
+
+        $this->createIndex('idx_tree_lft', '{{%tree}}', 'lft');
+        $this->createIndex('idx_tree_rgt', '{{%tree}}', 'rgt');
+        $this->createIndex('idx_tree_depth', '{{%tree}}', 'depth');
+        $this->createIndex('idx_tree_lft_rgt', '{{%tree}}', ['lft', 'rgt']);
+
+        if ($this->db->driverName !== 'sqlite') {
+            $this->addCommentOnTable('{{%tree}}', 'Nested sets tree structure for hierarchical data');
+            $this->addCommentOnColumn('{{%tree}}', 'id', 'Primary key of the tree node');
+            $this->addCommentOnColumn('{{%tree}}', 'name', 'Name of the tree node');
+            $this->addCommentOnColumn('{{%tree}}', 'lft', 'Left boundary of nested set');
+            $this->addCommentOnColumn('{{%tree}}', 'rgt', 'Right boundary of nested set');
+            $this->addCommentOnColumn('{{%tree}}', 'depth', 'Node depth in the tree hierarchy');
+        }
+    }
+
+    public function safeDown()
+    {
+        $this->dropTable('{{%tree}}');
+    }
+}

migrations/m250707_104009_multiple_tree.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+use yii\db\Migration;
+
+class m250707_104009_multiple_tree extends Migration
+{
+    public function safeUp()
+    {
+        $primaryKey = $this->db->driverName === 'oci'
+            ? 'NUMBER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY'
+            : $this->primaryKey();
+
+        $nameColumn = $this->db->driverName === 'oci'
+            ? $this->string(4000)->notNull()
+            : $this->text()->notNull();
+
+        $this->createTable('{{%multiple_tree}}', [
+            'id' => $primaryKey,
+            'tree' => $this->integer()->null(),
+            'name' => $nameColumn,
+            'lft' => $this->integer()->notNull(),
+            'rgt' => $this->integer()->notNull(),
+            'depth' => $this->integer()->notNull(),
+        ]);
+
+        $this->createIndex('idx_multiple_tree_tree', '{{%multiple_tree}}', 'tree');
+        $this->createIndex('idx_multiple_tree_lft', '{{%multiple_tree}}', 'lft');
+        $this->createIndex('idx_multiple_tree_rgt', '{{%multiple_tree}}', 'rgt');
+        $this->createIndex('idx_multiple_tree_depth', '{{%multiple_tree}}', 'depth');
+        $this->createIndex('idx_multiple_tree_tree_lft_rgt', '{{%multiple_tree}}', ['tree', 'lft', 'rgt']);
+
+        if ($this->db->driverName !== 'sqlite') {
+            $this->addCommentOnTable('{{%multiple_tree}}', 'Multiple nested sets tree structure for hierarchical data');
+            $this->addCommentOnColumn('{{%multiple_tree}}', 'tree', 'Tree identifier for multiple trees support');
+            $this->addCommentOnColumn('{{%multiple_tree}}', 'lft', 'Left boundary of nested set');
+            $this->addCommentOnColumn('{{%multiple_tree}}', 'rgt', 'Right boundary of nested set');
+            $this->addCommentOnColumn('{{%multiple_tree}}', 'depth', 'Node depth in the tree hierarchy');
+        }
+    }
+
+    public function safeDown()
+    {
+        $this->dropTable('{{%multiple_tree}}');
+    }
+}

tests/TestCase.php

@@ -9,8 +9,9 @@
 use Yii;
 use yii\base\InvalidArgumentException;
 use yii\console\Application;
-use yii\db\{ActiveQuery, ActiveRecord, Connection, SchemaBuilderTrait};
+use yii\db\{ActiveQuery, ActiveRecord, Connection, Query, SchemaBuilderTrait};
 use yii2\extensions\nestedsets\tests\support\model\{MultipleTree, Tree};
+use yii2\extensions\nestedsets\tests\support\stub\EchoMigrateController;
 
 use function array_merge;
 use function array_values;
@@ -168,45 +169,8 @@ protected function buildFlatXMLDataSet(array $dataSet): string
 
     protected function createDatabase(): void
     {
-        $command = $this->getDb()->createCommand();
-
-        if ($this->getDb()->getTableSchema('tree', true) !== null) {
-            $command->dropTable('tree')->execute();
-        }
-
-        if ($this->getDb()->getTableSchema('multiple_tree', true) !== null) {
-            $command->dropTable('multiple_tree')->execute();
-        }
-
-        $primaryKey = $this->driverName === 'oci'
-            ? 'NUMBER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY'
-            : $this->primaryKey()->notNull();
-        $name = $this->driverName === 'oci'
-            ? $this->string()->notNull()
-            : $this->text()->notNull();
-
-        $command->createTable(
-            'tree',
-            [
-                'id' => $primaryKey,
-                'name' => $name,
-                'lft' => $this->integer()->notNull(),
-                'rgt' => $this->integer()->notNull(),
-                'depth' => $this->integer()->notNull(),
-            ],
-        )->execute();
-
-        $command->createTable(
-            'multiple_tree',
-            [
-                'id' => $primaryKey,
-                'tree' => $this->integer(),
-                'name' => $name,
-                'lft' => $this->integer()->notNull(),
-                'rgt' => $this->integer()->notNull(),
-                'depth' => $this->integer()->notNull(),
-            ],
-        )->execute();
+        $this->runMigrate('down');
+        $this->runMigrate('up');
     }
 
     /**
@@ -261,7 +225,7 @@ protected function createTreeStructure(
 
     protected function generateFixtureTree(): void
     {
-        $this->createDatabase();
+        $this->runMigrate('up');
 
         $command = $this->getDb()->createCommand();
 
@@ -334,6 +298,30 @@ protected function getDataSetMultipleTree(): array
         return array_values($dataSetMultipleTree);
     }
 
+    /**
+     * @phpstan-param array<string, mixed> $params
+     */
+    protected function runMigrate(string $action, array $params = []): mixed
+    {
+        $migrate = new EchoMigrateController(
+            'migrate',
+            Yii::$app,
+            [
+                'migrationPath' => dirname(__DIR__) . '/migrations',
+                'interactive' => false,
+            ],
+        );
+
+        ob_start();
+        ob_implicit_flush(false);
+
+        $result = $migrate->run($action, $params);
+
+        ob_get_clean();
+
+        return $result;
+    }
+
     protected function loadFixtureXML(string $fileName): SimpleXMLElement
     {
         $filePath = "{$this->fixtureDirectory}/{$fileName}";

tests/support/stub/EchoMigrateController.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace yii2\extensions\nestedsets\tests\support\stub;
+
+use yii\console\controllers\MigrateController;
+
+final class EchoMigrateController extends MigrateController
+{
+    public function stdout($string)
+    {
+        echo $string;
+
+        return true;
+    }
+}