doctrine · GromNaN · Aug 4, 2026
diff --git a/UPGRADE.md b/UPGRADE.md
@@ -66,6 +66,26 @@ method instead:
 - `Column::setComment()` - use `ColumnEditor::setComment()`.
 - `Column::setValues()` - use `ColumnEditor::setValues()`.
 
+## Deprecated `Column::getType()`, `Column::setType()` and passing a `Type` instance to `Column::__construct()`
+
+`Column` now stores the DBAL type name (string) as source of truth. Use
+`Column::getTypeName()` / `Column::setTypeName()` and pass the type name to
+the constructor instead of a `Type` instance.
+
+```diff
+-use Doctrine\DBAL\Types\Type;
+ use Doctrine\DBAL\Types\Types;
+
+-$column = new Column('id', Type::getType(Types::INTEGER));
++$column = new Column('id', Types::INTEGER);
+
+-$typeName = Type::getTypeRegistry()->lookupName($column->getType());
++$typeName = $column->getTypeName();
+```
+
+Libraries that need to support older DBAL versions can keep passing a `Type`
+instance; the deprecated path stays functional until the next major.
+
 ## Deprecated `Table` features
 
 The `Table` constructor has been marked as internal. Use `Table::editor()` to instantiate an editor and

diff --git a/src/Platforms/AbstractMySQLPlatform.php b/src/Platforms/AbstractMySQLPlatform.php
@@ -366,7 +366,7 @@ public function getAlterTableSQL(TableDiff $diff): array
         $queryParts = [];
 
         foreach ($diff->getAddedColumns() as $column) {
-            $columnProperties = array_merge($column->toArray(), [
+            $columnProperties = array_merge($column->toArray(true), [
                 'comment' => $column->getComment(),
             ]);
 
@@ -383,7 +383,7 @@ public function getAlterTableSQL(TableDiff $diff): array
         foreach ($diff->getChangedColumns() as $columnDiff) {
             $newColumn = $columnDiff->getNewColumn();
 
-            $newColumnProperties = array_merge($newColumn->toArray(), [
+            $newColumnProperties = array_merge($newColumn->toArray(true), [
                 'comment' => $newColumn->getComment(),
             ]);
 
@@ -536,7 +536,7 @@ private function getPreAlterTableAlterPrimaryKeySQL(TableDiff $diff, Index $inde
             $column->setAutoincrement(false);
 
             $sql[] = 'ALTER TABLE ' . $tableNameSQL . ' MODIFY ' .
-                $this->getColumnDeclarationSQL($column->getQuotedName($this), $column->toArray());
+                $this->getColumnDeclarationSQL($column->getQuotedName($this), $column->toArray(true));
 
             // original autoincrement information might be needed later on by other parts of the table alteration
             $column->setAutoincrement(true);
@@ -593,7 +593,7 @@ private function getPreAlterTableAlterIndexForeignKeySQL(TableDiff $diff): array
                 $column->setAutoincrement(false);
 
                 $sql[] = 'ALTER TABLE ' . $tableNameSQL . ' MODIFY ' .
-                    $this->getColumnDeclarationSQL($column->getQuotedName($this), $column->toArray());
+                    $this->getColumnDeclarationSQL($column->getQuotedName($this), $column->toArray(true));
 
                 // Restore the autoincrement attribute as it might be needed later on
                 // by other parts of the table alteration.

diff --git a/src/Platforms/AbstractPlatform.php b/src/Platforms/AbstractPlatform.php
@@ -889,6 +889,15 @@ final protected function getCreateTableWithoutForeignKeysSQL(Table $table): arra
         return $this->buildCreateTableSQL($table, false);
     }
 
+    /**
+     * Resolves the DBAL type instance for a column type name.
+     */
+    protected function getType(string $typeName): Type
+    {
+        // @phpstan-ignore missingType.checkedException
+        return Type::getType($typeName);
+    }
+
     /** @return list<string> */
     private function buildCreateTableSQL(Table $table, bool $createForeignKeys): array
     {
@@ -1493,7 +1502,7 @@ public function getColumnDeclarationSQL(string $name, array $column): string
 
             $notnull = ! empty($column['notnull']) ? ' NOT NULL' : '';
 
-            $typeDecl    = $column['type']->getSQLDeclaration($column, $this);
+            $typeDecl    = $this->getType($column['typeName'])->getSQLDeclaration($column, $this);
             $declaration = $typeDecl . $charset . $default . $notnull . $collation;
 
             if ($this->supportsInlineColumnComments() && isset($column['comment']) && $column['comment'] !== '') {
@@ -1544,12 +1553,14 @@ public function getDefaultValueDeclarationSQL(array $column): string
             return ' DEFAULT ' . $default->toSQL($this);
         }
 
-        if (! isset($column['type'])) {
+        if (isset($column['typeName']) && is_string($column['typeName'])) {
+            $type = $this->getType($column['typeName']);
+        } elseif (isset($column['type']) && $column['type'] instanceof Type) {
+            $type = $column['type'];
+        } else {
             return " DEFAULT '" . $default . "'";
         }
 
-        $type = $column['type'];
-
         if ($type instanceof Types\PhpIntegerMappingType) {
             return ' DEFAULT ' . $default;
         }
@@ -2382,7 +2393,7 @@ final public function escapeStringForLike(string $inputString, string $escapeCha
      */
     private function columnToArray(Column $column): array
     {
-        return array_merge($column->toArray(), [
+        return array_merge($column->toArray(true), [
             'name' => $column->getQuotedName($this),
             'version' => $column->hasPlatformOption('version') ? $column->getPlatformOption('version') : false,
             'comment' => $column->getComment(),

diff --git a/src/Platforms/DB2Platform.php b/src/Platforms/DB2Platform.php
@@ -19,6 +19,7 @@
 use Doctrine\DBAL\SQL\Builder\SelectSQLBuilder;
 use Doctrine\DBAL\TransactionIsolationLevel;
 use Doctrine\DBAL\Types\PhpDateTimeMappingType;
+use Doctrine\DBAL\Types\Type;
 use Doctrine\DBAL\Types\Types;
 use Doctrine\Deprecations\Deprecation;
 
@@ -27,6 +28,7 @@
 use function current;
 use function explode;
 use function implode;
+use function is_string;
 use function sprintf;
 use function str_contains;
 
@@ -284,7 +286,7 @@ public function getAlterTableSQL(TableDiff $diff): array
 
         $queryParts = [];
         foreach ($diff->getAddedColumns() as $column) {
-            $columnDef = $column->toArray();
+            $columnDef = $column->toArray(true);
             $queryPart = 'ADD COLUMN ' . $this->getColumnDeclarationSQL($column->getQuotedName($this), $columnDef);
 
             // Adding non-nullable columns to a table requires a default value to be specified.
@@ -400,7 +402,7 @@ private function gatherAlterColumnSQL(
     private function getAlterColumnClausesSQL(ColumnDiff $columnDiff, bool &$needsReorg): array
     {
         $newColumn   = $columnDiff->getNewColumn();
-        $columnArray = $newColumn->toArray();
+        $columnArray = $newColumn->toArray(true);
 
         $newName = $columnDiff->getNewColumn()->getQuotedName($this);
         $oldName = $columnDiff->getOldColumn()->getQuotedName($this);
@@ -427,7 +429,7 @@ private function getAlterColumnClausesSQL(ColumnDiff $columnDiff, bool &$needsRe
             $columnDiff->hasFixedChanged()
         ) {
             $needsReorg = true;
-            $clauses[]  = $alterClause . ' SET DATA TYPE ' . $newColumn->getType()
+            $clauses[]  = $alterClause . ' SET DATA TYPE ' . $this->getType($newColumn->getTypeName())
                     ->getSQLDeclaration($columnArray, $this);
         }
 
@@ -484,7 +486,15 @@ public function getDefaultValueDeclarationSQL(array $column): string
                 'The "version" column platform option is deprecated.',
             );
 
-            if ($column['type'] instanceof PhpDateTimeMappingType) {
+            if (isset($column['typeName']) && is_string($column['typeName'])) {
+                $type = $this->getType($column['typeName']);
+            } elseif (isset($column['type']) && $column['type'] instanceof Type) {
+                $type = $column['type'];
+            } else {
+                $type = null;
+            }
+
+            if ($type instanceof PhpDateTimeMappingType) {
                 $column['default'] = '1';
             }
         }

diff --git a/src/Platforms/MariaDBPlatform.php b/src/Platforms/MariaDBPlatform.php
@@ -149,7 +149,11 @@ public function getColumnDeclarationSQL(string $name, array $column): string
     {
         // MariaDb forces column collation to utf8mb4_bin where the column was declared as JSON so ignore
         // collation and character set for json columns as attempting to set them can cause an error.
-        if ($this->getJsonTypeDeclarationSQL([]) === 'JSON' && ($column['type'] ?? null) instanceof JsonType) {
+        if (
+            $this->getJsonTypeDeclarationSQL([]) === 'JSON'
+            && isset($column['typeName'])
+            && $this->getType($column['typeName']) instanceof JsonType
+        ) {
             unset($column['collation']);
             unset($column['charset']);
         }

diff --git a/src/Platforms/MySQLPlatform.php b/src/Platforms/MySQLPlatform.php
@@ -11,8 +11,11 @@
 use Doctrine\DBAL\SQL\Builder\WithSQLBuilder;
 use Doctrine\DBAL\Types\BlobType;
 use Doctrine\DBAL\Types\TextType;
+use Doctrine\DBAL\Types\Type;
 use Doctrine\Deprecations\Deprecation;
 
+use function is_string;
+
 /**
  * Provides the behavior, features and SQL dialect of the Oracle MySQL database platform
  * of the oldest supported version.
@@ -30,8 +33,16 @@ class MySQLPlatform extends AbstractMySQLPlatform
      */
     public function getDefaultValueDeclarationSQL(array $column): string
     {
-        if ($column['type'] instanceof TextType || $column['type'] instanceof BlobType) {
-            unset($column['default']);
+        if (isset($column['typeName']) && is_string($column['typeName'])) {
+            $type = $this->getType($column['typeName']);
+        } elseif (isset($column['type']) && $column['type'] instanceof Type) {
+            $type = $column['type'];
+        } else {
+            $type = null;
+        }
+
+        if ($type instanceof TextType || $type instanceof BlobType) {
+            $column['default'] = null;
         }
 
         return parent::getDefaultValueDeclarationSQL($column);

diff --git a/src/Platforms/OraclePlatform.php b/src/Platforms/OraclePlatform.php
@@ -577,7 +577,7 @@ public function getAlterTableSQL(TableDiff $diff): array
         $tableNameSQL = $diff->getOldTable()->getQuotedName($this);
 
         foreach ($diff->getAddedColumns() as $column) {
-            $addColumnSQL[] = $this->getColumnDeclarationSQL($column->getQuotedName($this), $column->toArray());
+            $addColumnSQL[] = $this->getColumnDeclarationSQL($column->getQuotedName($this), $column->toArray(true));
             $comment        = $column->getComment();
 
             if ($comment !== '') {
@@ -614,7 +614,7 @@ public function getAlterTableSQL(TableDiff $diff): array
             // Oracle only supports binary type columns with variable length.
             // Avoids unnecessary table alteration statements.
             if (
-                $newColumn->getType() instanceof BinaryType &&
+                $this->getType($newColumn->getTypeName()) instanceof BinaryType &&
                 $columnDiff->hasFixedChanged() &&
                 $countChangedProperties === 1
             ) {
@@ -627,9 +627,9 @@ public function getAlterTableSQL(TableDiff $diff): array
              * Do not add query part if only comment has changed
              */
             if ($countChangedProperties > ($columnHasChangedComment ? 1 : 0)) {
-                $newColumnProperties = $newColumn->toArray();
+                $newColumnProperties = $newColumn->toArray(true);
 
-                $oldSQL = $this->getColumnDeclarationSQL('', $oldColumn->toArray());
+                $oldSQL = $this->getColumnDeclarationSQL('', $oldColumn->toArray(true));
                 $newSQL = $this->getColumnDeclarationSQL('', $newColumnProperties);
 
                 if ($newSQL !== $oldSQL) {
@@ -690,7 +690,7 @@ public function getColumnDeclarationSQL(string $name, array $column): string
                 $notnull = $column['notnull'] ? ' NOT NULL' : ' NULL';
             }
 
-            $typeDecl    = $column['type']->getSQLDeclaration($column, $this);
+            $typeDecl    = $this->getType($column['typeName'])->getSQLDeclaration($column, $this);
             $declaration = $typeDecl . $default . $notnull;
         }
 

diff --git a/src/Platforms/PostgreSQLPlatform.php b/src/Platforms/PostgreSQLPlatform.php
@@ -217,7 +217,7 @@ public function getAlterTableSQL(TableDiff $diff): array
         foreach ($diff->getAddedColumns() as $addedColumn) {
             $query = 'ADD ' . $this->getColumnDeclarationSQL(
                 $addedColumn->getQuotedName($this),
-                $addedColumn->toArray(),
+                $addedColumn->toArray(true),
             );
 
             $sql[] = 'ALTER TABLE ' . $tableNameSQL . ' ' . $query;
@@ -272,7 +272,7 @@ public function getAlterTableSQL(TableDiff $diff): array
             if ($columnDiff->hasDefaultChanged()) {
                 $defaultClause = $newColumn->getDefault() === null
                     ? ' DROP DEFAULT'
-                    : ' SET' . $this->getDefaultValueDeclarationSQL($newColumn->toArray());
+                    : ' SET' . $this->getDefaultValueDeclarationSQL($newColumn->toArray(true));
 
                 $query = 'ALTER ' . $newColumnName . $defaultClause;
                 $sql[] = 'ALTER TABLE ' . $tableNameSQL . ' ' . $query;
@@ -312,10 +312,10 @@ public function getAlterTableSQL(TableDiff $diff): array
 
     private function getTypeSQLDeclaration(Column $column): string
     {
-        $type = $column->getType();
+        $type = $this->getType($column->getTypeName());
 
         // SERIAL/BIGSERIAL are not "real" types and we can't alter a column to that type
-        $columnDefinition                  = $column->toArray();
+        $columnDefinition                  = $column->toArray(true);
         $columnDefinition['autoincrement'] = false;
 
         return $type->getSQLDeclaration($columnDefinition, $this);

diff --git a/src/Platforms/SQLServerPlatform.php b/src/Platforms/SQLServerPlatform.php
@@ -50,6 +50,8 @@
 /**
  * Provides the behavior, features and SQL dialect of the Microsoft SQL Server database platform
  * of the oldest supported version.
+ *
+ * @phpstan-import-type ColumnProperties from Column
  */
 class SQLServerPlatform extends AbstractPlatform
 {
@@ -325,7 +327,7 @@ protected function getCreateColumnCommentSQL(string $tableName, string $columnNa
      *
      * @internal The method should be only used by the {@see SQLServerPlatform} class.
      *
-     * @param mixed[] $column Column definition.
+     * @param ColumnProperties $column Column definition.
      */
     protected function getDefaultConstraintDeclarationSQL(array $column): string
     {
@@ -393,7 +395,7 @@ public function getAlterTableSQL(TableDiff $diff): array
         $tableName = $table->getName();
 
         foreach ($diff->getAddedColumns() as $column) {
-            $columnProperties = $column->toArray();
+            $columnProperties = $column->toArray(true);
 
             $addColumnSql = 'ADD ' . $this->getColumnDeclarationSQL($column->getQuotedName($this), $columnProperties);
 
@@ -469,8 +471,8 @@ public function getAlterTableSQL(TableDiff $diff): array
 
             $columnNameSQL = $newColumn->getQuotedName($this);
 
-            $newDeclarationSQL     = $this->getColumnDeclarationSQL($columnNameSQL, $newColumn->toArray());
-            $oldDeclarationSQL     = $this->getColumnDeclarationSQL($columnNameSQL, $oldColumn->toArray());
+            $newDeclarationSQL     = $this->getColumnDeclarationSQL($columnNameSQL, $newColumn->toArray(true));
+            $oldDeclarationSQL     = $this->getColumnDeclarationSQL($columnNameSQL, $oldColumn->toArray(true));
             $declarationSQLChanged = $newDeclarationSQL !== $oldDeclarationSQL;
 
             $defaultChanged = $columnDiff->hasDefaultChanged();
@@ -522,7 +524,7 @@ public function getRenameTableSQL(string $oldName, string $newName): string
      */
     private function getAlterTableAddDefaultConstraintClause(string $tableName, Column $column): string
     {
-        $columnDef         = $column->toArray();
+        $columnDef         = $column->toArray(true);
         $columnDef['name'] = $column->getQuotedName($this);
 
         return 'ADD' . $this->getDefaultConstraintDeclarationSQL($columnDef);
@@ -1244,7 +1246,7 @@ public function getColumnDeclarationSQL(string $name, array $column): string
 
             $notnull = ! empty($column['notnull']) ? ' NOT NULL' : '';
 
-            $typeDecl    = $column['type']->getSQLDeclaration($column, $this);
+            $typeDecl    = $this->getType($column['typeName'])->getSQLDeclaration($column, $this);
             $declaration = $typeDecl . $collation . $notnull;
         }
 
@@ -1265,8 +1267,8 @@ public function columnsEqual(Column $column1, Column $column2): bool
             return false;
         }
 
-        return $this->getDefaultValueDeclarationSQL($column1->toArray())
-            === $this->getDefaultValueDeclarationSQL($column2->toArray());
+        return $this->getDefaultValueDeclarationSQL($column1->toArray(true))
+            === $this->getDefaultValueDeclarationSQL($column2->toArray(true));
     }
 
     /**

diff --git a/src/Platforms/SQLitePlatform.php b/src/Platforms/SQLitePlatform.php
@@ -756,9 +756,9 @@ private function getSimpleAlterTableSQL(TableDiff $diff): array|false
         $sql = [];
 
         foreach ($diff->getAddedColumns() as $column) {
-            $definition = $column->toArray();
+            $definition = $column->toArray(true);
 
-            $type = $definition['type'];
+            $type = $this->getType($definition['typeName']);
 
             switch (true) {
                 case isset($definition['columnDefinition']):