feat: add getComment() method annotation into ColumnInterface

(cherry picked from commit c3cab76)

Author: roxblnfk

src/ColumnInterface.php

@@ -13,6 +13,9 @@
 
 /**
  * Represents table schema column abstraction.
+ *
+ * @method string getComment() Get column comment.
+ *         An empty string will be returned if the feature is not supported by the driver.
  */
 interface ColumnInterface
 {

src/Schema/AbstractColumn.php

@@ -785,4 +785,13 @@ protected function formatDatetime(
             default => $value,
         };
     }
+
+    /**
+     * Get column comment.
+     * An empty string will be returned if the feature is not supported by the driver.
+     */
+    public function getComment(): string
+    {
+        return '';
+    }
 }

tests/Database/Functional/Driver/Common/Schema/CommentTest.php

@@ -5,6 +5,7 @@
 namespace Cycle\Database\Tests\Functional\Driver\Common\Schema;
 
 // phpcs:ignore
+use Cycle\Database\ColumnInterface;
 use Cycle\Database\Tests\Functional\Driver\Common\BaseTest;
 use Cycle\Database\Tests\Utils\DontGenerateAttribute;