fix: pass join column options to FK

docs/en/reference/attributes-reference.rst

@@ -686,6 +686,7 @@ Optional parameters:
    make foreign keys work.
 -  **options**:
    See "options" attribute on :ref:`#[Column] <attrref_column>`.
+   It's possible to add other options, for example (PostgreSQL) `['deferrable' => true, 'deferred' => true]`.
 
 Example:
 

src/Tools/SchemaTool.php

@@ -31,6 +31,7 @@
 use function array_filter;
 use function array_flip;
 use function array_intersect_key;
+use function array_merge;
 use function assert;
 use function count;
 use function current;
@@ -712,6 +713,10 @@ private function gatherRelationJoinColumns(
                 $uniqueConstraints[] = ['columns' => [$quotedColumnName]];
             }
 
+            if ($joinColumn->options) {
+                $fkOptions = array_merge($fkOptions, $joinColumn->options);
+            }
+
             if (isset($joinColumn->onDelete)) {
                 $fkOptions['onDelete'] = $joinColumn->onDelete;
             }

tests/Tests/ORM/Functional/SchemaTool/PostgreSqlSchemaToolTest.php

@@ -11,11 +11,13 @@
 use Doctrine\ORM\Mapping\Id;
 use Doctrine\ORM\Mapping\JoinColumn;
 use Doctrine\ORM\Mapping\ManyToOne;
+use Doctrine\ORM\Mapping\OneToOne;
 use Doctrine\ORM\Mapping\Table;
 use Doctrine\Tests\OrmFunctionalTestCase;
 use PHPUnit\Framework\Attributes\Group;
 
 use function array_filter;
+use function array_slice;
 use function implode;
 use function str_starts_with;
 
@@ -42,6 +44,60 @@ public function testUpdateSchemaWithPostgreSQLSchema(): void
 
         self::assertCount(0, $sql, implode("\n", $sql));
     }
+
+    public function testUpdateSchemaWithJoinColumnWithOptions(): void
+    {
+        $sql = $this->getUpdateSchemaSqlForModels(
+            TestEntityWithJoinColumnWithOptions::class,
+            TestEntityWithJoinColumnWithOptionsRelation::class,
+        );
+
+        $this->assertSame([
+            'CREATE TABLE test (id INT NOT NULL, testRelation1_id INT DEFAULT NULL, testRelation2_id INT DEFAULT NULL, PRIMARY KEY(id))',
+            'CREATE UNIQUE INDEX UNIQ_D87F7E0C331521C6 ON test (testRelation1_id)',
+            'CREATE UNIQUE INDEX UNIQ_D87F7E0C21A08E28 ON test (testRelation2_id)',
+            'CREATE TABLE test_relation (id INT NOT NULL, PRIMARY KEY(id))',
+            'ALTER TABLE test ADD CONSTRAINT FK_D87F7E0C331521C6 FOREIGN KEY (testRelation1_id) REFERENCES test_relation (id) DEFERRABLE INITIALLY DEFERRED',
+            'ALTER TABLE test ADD CONSTRAINT FK_D87F7E0C21A08E28 FOREIGN KEY (testRelation2_id) REFERENCES test_relation (id) NOT DEFERRABLE INITIALLY IMMEDIATE',
+        ], array_slice($sql, 0, 5));
+
+        foreach ($sql as $query) {
+            $this->_em->getConnection()->executeQuery($query);
+        }
+
+        $sql = $this->getUpdateSchemaSqlForModels(
+            TestEntityWithJoinColumnWithOptions::class,
+            TestEntityWithJoinColumnWithOptionsRelation::class,
+        );
+
+        $this->assertSame([], $sql);
+    }
+}
+
+#[Table('test')]
+#[Entity]
+class TestEntityWithJoinColumnWithOptions
+{
+    #[Id]
+    #[Column]
+    private int $id;
+
+    #[OneToOne(targetEntity: TestEntityWithJoinColumnWithOptionsRelation::class)]
+    #[JoinColumn(options: ['deferrable' => true, 'deferred' => true])]
+    private TestEntityWithJoinColumnWithOptionsRelation $testRelation1;
+
+    #[OneToOne(targetEntity: TestEntityWithJoinColumnWithOptionsRelation::class)]
+    #[JoinColumn]
+    private TestEntityWithJoinColumnWithOptionsRelation $testRelation2;
+}
+
+#[Table('test_relation')]
+#[Entity]
+class TestEntityWithJoinColumnWithOptionsRelation
+{
+    #[Id]
+    #[Column]
+    private int $id;
 }
 
 #[Table(name: 'stonewood.screen')]

tests/Tests/ORM/Tools/SchemaToolTest.php

@@ -5,6 +5,7 @@
 namespace Doctrine\Tests\ORM\Tools;
 
 use Doctrine\Common\Collections\Collection;
+use Doctrine\DBAL\Platforms\PostgreSQLPlatform;
 use Doctrine\ORM\Mapping\ClassMetadata;
 use Doctrine\ORM\Mapping\Column;
 use Doctrine\ORM\Mapping\Entity;
@@ -391,6 +392,53 @@ public function testLoadUniqueConstraintWithoutName(): void
         self::assertTrue($tableIndex->isUnique());
         self::assertSame(['field', 'anotherField'], $tableIndex->getColumns());
     }
+
+    public function testJoinColumnWithOptions(): void
+    {
+        $em         = $this->getTestEntityManager();
+        $schemaTool = new SchemaTool($em);
+
+        $classes = [
+            $em->getClassMetadata(TestEntityWithJoinColumnWithOptions::class),
+            $em->getClassMetadata(TestEntityWithJoinColumnWithOptionsRelation::class),
+        ];
+
+        $schema = $schemaTool->getSchemaFromMetadata($classes);
+
+        self::assertSame(['deferrable' => true, 'deferred' => true], $schema->getTable('test')->getForeignKey('FK_D87F7E0C331521C6')->getOptions());
+        self::assertSame([], $schema->getTable('test')->getForeignKey('FK_D87F7E0C21A08E28')->getOptions());
+
+        $sql = $schema->toSql(new PostgreSQLPlatform());
+
+        $this->assertSame('ALTER TABLE test ADD CONSTRAINT FK_D87F7E0C331521C6 FOREIGN KEY (testRelation1_id) REFERENCES test_relation (id) DEFERRABLE INITIALLY DEFERRED', $sql[count($sql) - 2]);
+        $this->assertSame('ALTER TABLE test ADD CONSTRAINT FK_D87F7E0C21A08E28 FOREIGN KEY (testRelation2_id) REFERENCES test_relation (id) NOT DEFERRABLE INITIALLY IMMEDIATE', $sql[count($sql) - 1]);
+    }
+}
+
+#[Table('test')]
+#[Entity]
+class TestEntityWithJoinColumnWithOptions
+{
+    #[Id]
+    #[Column]
+    private int $id;
+
+    #[OneToOne(targetEntity: TestEntityWithJoinColumnWithOptionsRelation::class)]
+    #[JoinColumn(options: ['deferrable' => true, 'deferred' => true])]
+    private TestEntityWithJoinColumnWithOptionsRelation $testRelation1;
+
+    #[OneToOne(targetEntity: TestEntityWithJoinColumnWithOptionsRelation::class)]
+    #[JoinColumn]
+    private TestEntityWithJoinColumnWithOptionsRelation $testRelation2;
+}
+
+#[Table('test_relation')]
+#[Entity]
+class TestEntityWithJoinColumnWithOptionsRelation
+{
+    #[Id]
+    #[Column]
+    private int $id;
 }
 
 #[Table(options: ['foo' => 'bar', 'baz' => ['key' => 'val']])]