Add support for creating temporary tables in schema

docs/en/reference/schema-representation.rst

@@ -93,7 +93,18 @@ and absolutely not portable.
 -  **engine** (string): The DB engine used for the table. Currently only supported on MySQL.
 
 -  **unlogged** (boolean): Set a PostgreSQL table type as
-  `unlogged <https://www.postgresql.org/docs/current/sql-createtable.htmll>`_
+   `unlogged <https://www.postgresql.org/docs/current/sql-createtable.html#SQL-CREATETABLE-UNLOGGED>`_
+
+-  **temporary** (boolean): Set a PostgreSQL table type as
+   `temporary <https://www.postgresql.org/docs/current/sql-createtable.html#SQL-CREATETABLE-TEMPORARY>`_
+
+-  **on_commit** (string): Set a PostgreSQL table
+   `commit options <https://www.postgresql.org/docs/current/sql-createtable.html#SQL-CREATETABLE-PARMS-ON-COMMIT>`_,
+   only used if **temporary** is true
+
+   - ``preserve``: preserve rows on commit
+   - ``delete``: delete rows on commit
+   - ``drop``: drop rows on commit
 
 Column
 ~~~~~~

src/Platforms/PostgreSQLPlatform.php

@@ -391,9 +391,18 @@
             $queryFields .= ', PRIMARY KEY(' . implode(', ', $keyColumns) . ')';
         }
 
+        $temporary = isset($options['temporary']) && $options['temporary'] === true ? ' TEMPORARY' : '';
+
+        $onCommit = $options['temporary'] ?? false ? match ($options['on_commit'] ?? '') {
+            'preserve' => ' ON COMMIT PRESERVE ROWS',
+            'delete' => ' ON COMMIT DELETE ROWS',
+            'drop' => ' ON COMMIT DROP',
+            default => ''
+        } : '';
+
         $unlogged = isset($options['unlogged']) && $options['unlogged'] === true ? ' UNLOGGED' : '';
 
-        $query = 'CREATE' . $unlogged . ' TABLE ' . $name . ' (' . $queryFields . ')';
+        $query = 'CREATE' . $temporary . $unlogged . ' TABLE ' . $name . ' (' . $queryFields . ')' . $onCommit;
 
         $sql = [$query];
 

tests/Platforms/PostgreSQLPlatformTest.php

@@ -13,6 +13,7 @@
 use Doctrine\DBAL\TransactionIsolationLevel;
 use Doctrine\DBAL\Types\Type;
 use Doctrine\DBAL\Types\Types;
+use Generator;
 use PHPUnit\Framework\Attributes\DataProvider;
 use UnexpectedValueException;
 
@@ -191,6 +192,57 @@ public function testGenerateTableWithAutoincrement(): void
         );
     }
 
+    #[DataProvider('pgTemporaryProvider')]
+    public function testGenerateTemporaryTable(
+        bool $temporary,
+        string|null $onCommit,
+        string $expectedSQL,
+    ): void {
+        $table = new Table('mytable');
+        $table->addOption('temporary', $temporary);
+        if ($onCommit !== null) {
+            $table->addOption('on_commit', $onCommit);
+        }
+
+        $table->addColumn('foo', 'string');
+
+        self::assertEquals(
+            [$expectedSQL],
+            $this->platform->getCreateTableSQL($table),
+        );
+    }
+
+    public static function pgTemporaryProvider(): Generator
+    {
+        yield 'temporary, no on commit option' => [true, null, 'CREATE TEMPORARY TABLE mytable (foo VARCHAR NOT NULL)'];
+
+        yield 'temporary, empty on commit option' =>
+        [true, '', 'CREATE TEMPORARY TABLE mytable (foo VARCHAR NOT NULL)'];
+
+        yield 'temporary, invalid on commit option' =>
+        [true, 'invalid', 'CREATE TEMPORARY TABLE mytable (foo VARCHAR NOT NULL)'];
+
+        yield 'non temporary' => [false, null, 'CREATE TABLE mytable (foo VARCHAR NOT NULL)'];
+
+        yield 'temporary, preserve rows on commit' =>
+        [true, 'preserve', 'CREATE TEMPORARY TABLE mytable (foo VARCHAR NOT NULL) ON COMMIT PRESERVE ROWS'];
+
+        yield 'non temporary, preserve rows on commit omitted' =>
+        [false, 'preserve', 'CREATE TABLE mytable (foo VARCHAR NOT NULL)'];
+
+        yield 'temporary, delete rows on commit' =>
+        [true, 'delete', 'CREATE TEMPORARY TABLE mytable (foo VARCHAR NOT NULL) ON COMMIT DELETE ROWS'];
+
+        yield 'non temporary, delete rows on commit omitted' =>
+        [false, 'delete', 'CREATE TABLE mytable (foo VARCHAR NOT NULL)'];
+
+        yield 'temporary, drop on commit' =>
+        [true, 'drop', 'CREATE TEMPORARY TABLE mytable (foo VARCHAR NOT NULL) ON COMMIT DROP'];
+
+        yield 'non temporary, drop on commit omitted' =>
+        [false, 'drop', 'CREATE TABLE mytable (foo VARCHAR NOT NULL)'];
+    }
+
     public function testGenerateUnloggedTable(): void
     {
         $table = new Table('mytable');