From c161161717a17874a8cd93748f30c23a05bafe57 Mon Sep 17 00:00:00 2001
From: Tigrov <rrr-r@ya.ru>
Date: Mon, 10 Feb 2025 10:21:57 +0700
Subject: [PATCH] Add `ReferentialAction` class

---
 docs/guide/en/command/ddl.md                  |  5 +-
 docs/guide/pt-BR/command/ddl.md               |  5 +-
 src/Command/CommandInterface.php              | 18 +++--
 src/Constant/ReferentialAction.php            | 46 +++++++++++++
 src/Constraint/ForeignKeyConstraint.php       | 14 ++++
 .../AbstractColumnDefinitionBuilder.php       |  5 ++
 src/QueryBuilder/DDLQueryBuilderInterface.php | 11 +--
 tests/Db/Command/CommandTest.php              | 14 ++--
 tests/Provider/CommandProvider.php            | 69 +++++++++++--------
 tests/Provider/QueryBuilderProvider.php       | 13 ++--
 tests/Provider/SchemaProvider.php             |  5 +-
 11 files changed, 142 insertions(+), 63 deletions(-)
 create mode 100644 src/Constant/ReferentialAction.php

diff --git a/docs/guide/en/command/ddl.md b/docs/guide/en/command/ddl.md
index 96519aa4c..d740e3bd9 100644
--- a/docs/guide/en/command/ddl.md
+++ b/docs/guide/en/command/ddl.md
@@ -181,6 +181,7 @@ method:
 
 ```php
 use Yiisoft\Db\Connection\ConnectionInterface;
+use Yiisoft\Db\Constant\ReferentialAction;
 
 /** @var ConnectionInterface $db */
 $db->createCommand()->addForeignKey(
@@ -189,8 +190,8 @@ $db->createCommand()->addForeignKey(
     'profile_id',
     '{{%profile}}',
     'id',
-    'CASCADE',
-    'CASCADE'
+    ReferentialAction::CASCADE,
+    ReferentialAction::CASCADE
 )->execute();
 ```
 
diff --git a/docs/guide/pt-BR/command/ddl.md b/docs/guide/pt-BR/command/ddl.md
index 82d22cf7f..ebaa68498 100644
--- a/docs/guide/pt-BR/command/ddl.md
+++ b/docs/guide/pt-BR/command/ddl.md
@@ -177,6 +177,7 @@ Para adicionar uma chave estrangeira a uma tabela existente, você pode usar o m
 
 ```php
 use Yiisoft\Db\Connection\ConnectionInterface;
+use Yiisoft\Db\Constant\ReferentialAction;
 
 /** @var ConnectionInterface $db */
 $db->createCommand()->addForeignKey(
@@ -185,8 +186,8 @@ $db->createCommand()->addForeignKey(
     'profile_id',
     '{{%profile}}',
     'id',
-    'CASCADE',
-    'CASCADE'
+    ReferentialAction::CASCADE,
+    ReferentialAction::CASCADE
 )->execute();
 ```
 
diff --git a/src/Command/CommandInterface.php b/src/Command/CommandInterface.php
index f88b469bf..8801050cd 100644
--- a/src/Command/CommandInterface.php
+++ b/src/Command/CommandInterface.php
@@ -12,6 +12,7 @@
 use Yiisoft\Db\Constant\DataType;
 use Yiisoft\Db\Constant\IndexType;
 use Yiisoft\Db\Constant\PseudoType;
+use Yiisoft\Db\Constant\ReferentialAction;
 use Yiisoft\Db\Exception\Exception;
 use Yiisoft\Db\Exception\InvalidArgumentException;
 use Yiisoft\Db\Exception\InvalidCallException;
@@ -99,8 +100,7 @@ public function addDefaultValue(string $table, string $name, string $column, mix
 
     /**
      * Creates an SQL command for adding a foreign key constraint to an existing table.
-     *
-     * The method will quote the table and column names.
+     * The method will quote the `name`, `table`, `referenceTable` parameters before using them in the generated SQL.
      *
      * @param string $table The name of the table to add foreign key constraint to.
      * @param string $name The name of the foreign key constraint.
@@ -109,16 +109,14 @@ public function addDefaultValue(string $table, string $name, string $column, mix
      * @param string $referenceTable The name of the table that the foreign key references to.
      * @param array|string $referenceColumns The name of the column that the foreign key references to. If there are
      * many columns, separate them with commas.
-     * @param string|null $delete The `ON DELETE` option. Most DBMS support these options: `RESTRICT`, `CASCADE`, `NO ACTION`,
-     * `SET DEFAULT`, `SET NULL`.
-     * @param string|null $update The `ON UPDATE` option. Most DBMS support these options: `RESTRICT`, `CASCADE`, `NO ACTION`,
-     * `SET DEFAULT`, `SET NULL`.
+     * @param string|null $delete The `ON DELETE` option. See {@see ReferentialAction} class for possible values.
+     * @param string|null $update The `ON UPDATE` option. See {@see ReferentialAction} class for possible values.
      *
      * @throws Exception
      * @throws InvalidArgumentException
      *
-     * Note: The method will quote the `name`, `table`, `referenceTable` parameters before using them in the generated
-     * SQL.
+     * @psalm-param ReferentialAction::*|null $delete
+     * @psalm-param ReferentialAction::*|null $update
      */
     public function addForeignKey(
         string $table,
@@ -126,8 +124,8 @@ public function addForeignKey(
         array|string $columns,
         string $referenceTable,
         array|string $referenceColumns,
-        string $delete = null,
-        string $update = null
+        string|null $delete = null,
+        string|null $update = null
     ): static;
 
     /**
diff --git a/src/Constant/ReferentialAction.php b/src/Constant/ReferentialAction.php
new file mode 100644
index 000000000..f264f3463
--- /dev/null
+++ b/src/Constant/ReferentialAction.php
@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yiisoft\Db\Constant;
+
+/**
+ * `ReferentialAction` represents the possible actions that can be performed on the referenced table.
+ *
+ * The constants are used to specify `ON DELETE` and `ON UPDATE` actions by {@see ForeignKeyConstraint::onDelete()},
+ * {@see ForeignKeyConstraint::onUpdate()}, {@see DDLQueryBuilderInterface::addForeignKey()}
+ * and {@see CommandInterface::addForeignKey()}.
+ *
+ * MSSQL does not support `RESTRICT` key world but uses this behavior by default (if no action is specified).
+ *
+ * Oracle supports only `CASCADE` and `SET NULL` key worlds and only `ON DELETE` clause.
+ * `NO ACTION` is used by default for `ON DELETE` and `ON UPDATE` (if no action is specified).
+ */
+final class ReferentialAction
+{
+    /**
+     * @var string Used when the referenced rows are not deleted or updated. If rows of the referenced table are used
+     * by rows of the referencing table, an error is thrown. This is the default behavior.
+     */
+    public const NO_ACTION = 'NO ACTION';
+    /**
+     * @var string Used when the referenced rows cannot be deleted or updated. For example, if rows of the referenced
+     * table are used by rows of the referencing table, it is not permitted to delete those rows from the referenced table.
+     * This is similar to {@see NO_ACTION}, but is not used by some DBMSs.
+     */
+    public const RESTRICT = 'RESTRICT';
+    /**
+     * @var string Used when the referenced row is deleted or updated and all rows that reference it are deleted
+     * or updated accordingly.
+     */
+    public const CASCADE = 'CASCADE';
+    /**
+     * @var string Used when the rows that refer to the deleted or updated row are set to `NULL`.
+     * If columns are defined as `NOT NULL`, an error is thrown.
+     */
+    public const SET_NULL = 'SET NULL';
+    /**
+     * @var string Used when the rows that refer to the deleted or updated row are set to their default values.
+     */
+    public const SET_DEFAULT = 'SET DEFAULT';
+}
diff --git a/src/Constraint/ForeignKeyConstraint.php b/src/Constraint/ForeignKeyConstraint.php
index 06016cf0b..d19d5f35d 100644
--- a/src/Constraint/ForeignKeyConstraint.php
+++ b/src/Constraint/ForeignKeyConstraint.php
@@ -4,6 +4,8 @@
 
 namespace Yiisoft\Db\Constraint;
 
+use Yiisoft\Db\Constant\ReferentialAction;
+
 /**
  * Represents a foreign key constraint in a database.
  *
@@ -17,7 +19,9 @@ final class ForeignKeyConstraint extends Constraint
     private string|null $foreignSchemaName = null;
     private string|null $foreignTableName = null;
     private array $foreignColumnNames = [];
+    /** @psalm-var ReferentialAction::*|null */
     private string|null $onUpdate = null;
+    /** @psalm-var ReferentialAction::*|null */
     private string|null $onDelete = null;
 
     /**
@@ -46,6 +50,8 @@ public function getForeignColumnNames(): array
 
     /**
      * @return string|null The referential action if rows in a referenced table are to be updated.
+     *
+     * @psalm-return ReferentialAction::*|null
      */
     public function getOnUpdate(): string|null
     {
@@ -54,6 +60,8 @@ public function getOnUpdate(): string|null
 
     /**
      * @return string|null The referential action if rows in a referenced table are to be deleted.
+     *
+     * @psalm-return ReferentialAction::*|null
      */
     public function getOnDelete(): string|null
     {
@@ -97,6 +105,9 @@ public function foreignColumnNames(array $value): self
      * Set the referential action if rows in a referenced table are to be updated.
      *
      * @param string|null $value The referential action if rows in a referenced table are to be updated.
+     * See {@see ReferentialAction} class for possible values.
+     *
+     * @psalm-param ReferentialAction::*|null $value
      */
     public function onUpdate(string|null $value): self
     {
@@ -108,6 +119,9 @@ public function onUpdate(string|null $value): self
      * Set the referential action if rows in a referenced table are to be deleted.
      *
      * @param string|null $value The referential action if rows in a referenced table are to be deleted.
+     * See {@see ReferentialAction} class for possible values.
+     *
+     * @psalm-param ReferentialAction::*|null $value
      */
     public function onDelete(string|null $value): self
     {
diff --git a/src/QueryBuilder/AbstractColumnDefinitionBuilder.php b/src/QueryBuilder/AbstractColumnDefinitionBuilder.php
index b0894c30f..329465031 100644
--- a/src/QueryBuilder/AbstractColumnDefinitionBuilder.php
+++ b/src/QueryBuilder/AbstractColumnDefinitionBuilder.php
@@ -5,6 +5,7 @@
 namespace Yiisoft\Db\QueryBuilder;
 
 use Yiisoft\Db\Constant\ColumnType;
+use Yiisoft\Db\Constant\ReferentialAction;
 use Yiisoft\Db\Schema\Column\ColumnInterface;
 
 use function in_array;
@@ -231,6 +232,8 @@ protected function buildReferenceDefinition(ColumnInterface $column): string|nul
 
     /**
      * Builds the ON DELETE clause for the column reference.
+     *
+     * @psalm-param ReferentialAction::* $onDelete
      */
     protected function buildOnDelete(string $onDelete): string
     {
@@ -239,6 +242,8 @@ protected function buildOnDelete(string $onDelete): string
 
     /**
      * Builds the ON UPDATE clause for the column reference.
+     *
+     * @psalm-param ReferentialAction::* $onUpdate
      */
     protected function buildOnUpdate(string $onUpdate): string
     {
diff --git a/src/QueryBuilder/DDLQueryBuilderInterface.php b/src/QueryBuilder/DDLQueryBuilderInterface.php
index ef6756062..e0d51245e 100644
--- a/src/QueryBuilder/DDLQueryBuilderInterface.php
+++ b/src/QueryBuilder/DDLQueryBuilderInterface.php
@@ -5,6 +5,7 @@
 namespace Yiisoft\Db\QueryBuilder;
 
 use Yiisoft\Db\Constant\IndexType;
+use Yiisoft\Db\Constant\ReferentialAction;
 use Yiisoft\Db\Exception\Exception;
 use Yiisoft\Db\Exception\InvalidArgumentException;
 use Yiisoft\Db\Exception\InvalidConfigException;
@@ -103,6 +104,7 @@ public function addDefaultValue(string $table, string $name, string $column, mix
 
     /**
      * Builds an SQL statement for adding a foreign key constraint to an existing table.
+     * The method will quote the `name`, `table`, `referenceTable` parameters before using them in the generated SQL.
      *
      * @param string $table The table to add the foreign key constraint will to.
      * @param string $name The name of the foreign key constraint.
@@ -111,17 +113,16 @@ public function addDefaultValue(string $table, string $name, string $column, mix
      * @param string $referenceTable The table that the foreign key references to.
      * @param array|string $referenceColumns The name of the column that the foreign key references to.
      * If there are many columns, separate them with commas or use an array to represent them.
-     * @param string|null $delete The `ON DELETE` option. Most DBMS support these options: `RESTRICT`, `CASCADE`, `NO ACTION`,
-     * `SET DEFAULT`, `SET NULL`.
-     * @param string|null $update The `ON UPDATE` option. Most DBMS support these options: `RESTRICT`, `CASCADE`, `NO ACTION`,
-     * `SET DEFAULT`, `SET NULL`.
+     * @param string|null $delete The `ON DELETE` option. See {@see ReferentialAction} class for possible values.
+     * @param string|null $update The `ON UPDATE` option. See {@see ReferentialAction} class for possible values.
      *
      * @throws Exception
      * @throws InvalidArgumentException
      *
      * @return string The SQL statement for adding a foreign key constraint to an existing table.
      *
-     * Note: The method will quote the `name`, `table`, `referenceTable` parameters before using them in the generated SQL.
+     * @psalm-param ReferentialAction::*|null $delete
+     * @psalm-param ReferentialAction::*|null $update
      */
     public function addForeignKey(
         string $table,
diff --git a/tests/Db/Command/CommandTest.php b/tests/Db/Command/CommandTest.php
index c0d60227f..f55e46857 100644
--- a/tests/Db/Command/CommandTest.php
+++ b/tests/Db/Command/CommandTest.php
@@ -117,18 +117,20 @@ public function testAddDefaultValue(): void
      * @dataProvider \Yiisoft\Db\Tests\Provider\CommandProvider::addForeignKeySql
      */
     public function testAddForeignKeySql(
-        string $name,
-        string $tableName,
-        array|string $column1,
-        array|string $column2,
+        array|string $columns,
+        array|string $referenceColumns,
         string|null $delete,
         string|null $update,
         string $expected
     ): void {
         $db = $this->getConnection();
-
         $command = $db->createCommand();
-        $sql = $command->addForeignKey($tableName, $name, $column1, $tableName, $column2, $delete, $update)->getSql();
+
+        $name = '{{fk_constraint}}';
+        $tableName = '{{fk_table}}';
+        $referenceTable = '{{fk_referenced_table}}';
+
+        $sql = $command->addForeignKey($tableName, $name, $columns, $referenceTable, $referenceColumns, $delete, $update)->getSql();
 
         $this->assertSame($expected, $sql);
     }
diff --git a/tests/Provider/CommandProvider.php b/tests/Provider/CommandProvider.php
index 7f559e01f..bb3bf6d8d 100644
--- a/tests/Provider/CommandProvider.php
+++ b/tests/Provider/CommandProvider.php
@@ -11,6 +11,7 @@
 use Yiisoft\Db\Command\Param;
 use Yiisoft\Db\Constant\ColumnType;
 use Yiisoft\Db\Constant\IndexType;
+use Yiisoft\Db\Constant\ReferentialAction;
 use Yiisoft\Db\Expression\Expression;
 use Yiisoft\Db\Query\Query;
 use Yiisoft\Db\Schema\Column\ColumnBuilder;
@@ -38,113 +39,121 @@ public static function addForeignKeySql(): array
     {
         return [
             [
-                '{{test_fk_constraint_1}}',
-                '{{test_fk}}',
                 'int1',
                 'int3',
                 null,
                 null,
                 DbHelper::replaceQuotes(
                     <<<SQL
-                    ALTER TABLE [[test_fk]] ADD CONSTRAINT [[test_fk_constraint_1]] FOREIGN KEY ([[int1]]) REFERENCES [[test_fk]] ([[int3]])
+                    ALTER TABLE [[fk_table]] ADD CONSTRAINT [[fk_constraint]] FOREIGN KEY ([[int1]]) REFERENCES [[fk_referenced_table]] ([[int3]])
                     SQL,
                     static::$driverName,
                 ),
             ],
             [
-                '{{test_fk_constraint_2}}',
-                '{{test_fk}}',
                 ['int1'],
                 'int3',
                 null,
                 null,
                 DbHelper::replaceQuotes(
                     <<<SQL
-                    ALTER TABLE [[test_fk]] ADD CONSTRAINT [[test_fk_constraint_2]] FOREIGN KEY ([[int1]]) REFERENCES [[test_fk]] ([[int3]])
+                    ALTER TABLE [[fk_table]] ADD CONSTRAINT [[fk_constraint]] FOREIGN KEY ([[int1]]) REFERENCES [[fk_referenced_table]] ([[int3]])
                     SQL,
                     static::$driverName,
                 ),
             ],
             [
-                '{{test_fk_constraint_3}}',
-                '{{test_fk}}',
                 ['int1'],
                 ['int3'],
                 null,
                 null,
                 DbHelper::replaceQuotes(
                     <<<SQL
-                    ALTER TABLE [[test_fk]] ADD CONSTRAINT [[test_fk_constraint_3]] FOREIGN KEY ([[int1]]) REFERENCES [[test_fk]] ([[int3]])
+                    ALTER TABLE [[fk_table]] ADD CONSTRAINT [[fk_constraint]] FOREIGN KEY ([[int1]]) REFERENCES [[fk_referenced_table]] ([[int3]])
                     SQL,
                     static::$driverName,
                 ),
             ],
             [
-                '{{test_fk_constraint_4}}',
-                '{{test_fk}}',
                 ['int1'],
                 ['int3'],
-                'CASCADE',
+                ReferentialAction::CASCADE,
                 null,
                 DbHelper::replaceQuotes(
                     <<<SQL
-                    ALTER TABLE [[test_fk]] ADD CONSTRAINT [[test_fk_constraint_4]] FOREIGN KEY ([[int1]]) REFERENCES [[test_fk]] ([[int3]]) ON DELETE CASCADE
+                    ALTER TABLE [[fk_table]] ADD CONSTRAINT [[fk_constraint]] FOREIGN KEY ([[int1]]) REFERENCES [[fk_referenced_table]] ([[int3]]) ON DELETE CASCADE
                     SQL,
                     static::$driverName,
                 ),
             ],
             [
-                '{{test_fk_constraint_5}}',
-                '{{test_fk}}',
                 ['int1'],
                 ['int3'],
-                'CASCADE',
-                'CASCADE',
+                ReferentialAction::CASCADE,
+                ReferentialAction::CASCADE,
                 DbHelper::replaceQuotes(
                     <<<SQL
-                    ALTER TABLE [[test_fk]] ADD CONSTRAINT [[test_fk_constraint_5]] FOREIGN KEY ([[int1]]) REFERENCES [[test_fk]] ([[int3]]) ON DELETE CASCADE ON UPDATE CASCADE
+                    ALTER TABLE [[fk_table]] ADD CONSTRAINT [[fk_constraint]] FOREIGN KEY ([[int1]]) REFERENCES [[fk_referenced_table]] ([[int3]]) ON DELETE CASCADE ON UPDATE CASCADE
                     SQL,
                     static::$driverName,
                 ),
             ],
             [
-                '{{test_fk_constraint_6}}',
-                '{{test_fk}}',
                 ['int1', 'int2'],
                 ['int3', 'int4'],
                 null,
                 null,
                 DbHelper::replaceQuotes(
                     <<<SQL
-                    ALTER TABLE [[test_fk]] ADD CONSTRAINT [[test_fk_constraint_6]] FOREIGN KEY ([[int1]], [[int2]]) REFERENCES [[test_fk]] ([[int3]], [[int4]])
+                    ALTER TABLE [[fk_table]] ADD CONSTRAINT [[fk_constraint]] FOREIGN KEY ([[int1]], [[int2]]) REFERENCES [[fk_referenced_table]] ([[int3]], [[int4]])
                     SQL,
                     static::$driverName,
                 ),
             ],
             [
-                '{{test_fk_constraint_7}}',
-                '{{test_fk}}',
                 ['int1', 'int2'],
                 ['int3', 'int4'],
-                'CASCADE',
+                ReferentialAction::CASCADE,
                 null,
                 DbHelper::replaceQuotes(
                     <<<SQL
-                    ALTER TABLE [[test_fk]] ADD CONSTRAINT [[test_fk_constraint_7]] FOREIGN KEY ([[int1]], [[int2]]) REFERENCES [[test_fk]] ([[int3]], [[int4]]) ON DELETE CASCADE
+                    ALTER TABLE [[fk_table]] ADD CONSTRAINT [[fk_constraint]] FOREIGN KEY ([[int1]], [[int2]]) REFERENCES [[fk_referenced_table]] ([[int3]], [[int4]]) ON DELETE CASCADE
                     SQL,
                     static::$driverName,
                 ),
             ],
             [
-                '{{test_fk_constraint_8}}',
-                '{{test_fk}}',
                 ['int1', 'int2'],
                 ['int3', 'int4'],
-                'CASCADE',
-                'CASCADE',
+                ReferentialAction::CASCADE,
+                ReferentialAction::CASCADE,
+                DbHelper::replaceQuotes(
+                    <<<SQL
+                    ALTER TABLE [[fk_table]] ADD CONSTRAINT [[fk_constraint]] FOREIGN KEY ([[int1]], [[int2]]) REFERENCES [[fk_referenced_table]] ([[int3]], [[int4]]) ON DELETE CASCADE ON UPDATE CASCADE
+                    SQL,
+                    static::$driverName,
+                ),
+            ],
+            [
+                ['int1'],
+                ['int3'],
+                ReferentialAction::NO_ACTION,
+                ReferentialAction::RESTRICT,
+                DbHelper::replaceQuotes(
+                    <<<SQL
+                    ALTER TABLE [[fk_table]] ADD CONSTRAINT [[fk_constraint]] FOREIGN KEY ([[int1]]) REFERENCES [[fk_referenced_table]] ([[int3]]) ON DELETE NO ACTION ON UPDATE RESTRICT
+                    SQL,
+                    static::$driverName,
+                ),
+            ],
+            [
+                ['int1'],
+                ['int3'],
+                ReferentialAction::SET_DEFAULT,
+                ReferentialAction::SET_NULL,
                 DbHelper::replaceQuotes(
                     <<<SQL
-                    ALTER TABLE [[test_fk]] ADD CONSTRAINT [[test_fk_constraint_8]] FOREIGN KEY ([[int1]], [[int2]]) REFERENCES [[test_fk]] ([[int3]], [[int4]]) ON DELETE CASCADE ON UPDATE CASCADE
+                    ALTER TABLE [[fk_table]] ADD CONSTRAINT [[fk_constraint]] FOREIGN KEY ([[int1]]) REFERENCES [[fk_referenced_table]] ([[int3]]) ON DELETE SET DEFAULT ON UPDATE SET NULL
                     SQL,
                     static::$driverName,
                 ),
diff --git a/tests/Provider/QueryBuilderProvider.php b/tests/Provider/QueryBuilderProvider.php
index 45ffd38b8..6053085e7 100644
--- a/tests/Provider/QueryBuilderProvider.php
+++ b/tests/Provider/QueryBuilderProvider.php
@@ -10,6 +10,7 @@
 use Yiisoft\Db\Constant\ColumnType;
 use Yiisoft\Db\Constant\IndexType;
 use Yiisoft\Db\Constant\PseudoType;
+use Yiisoft\Db\Constant\ReferentialAction;
 use Yiisoft\Db\Constraint\ForeignKeyConstraint;
 use Yiisoft\Db\Expression\Expression;
 use Yiisoft\Db\Expression\JsonExpression;
@@ -52,8 +53,8 @@ public static function addForeignKey(): array
                 'C_fk_id_1',
                 $pkTableName,
                 'C_id_1',
-                'CASCADE',
-                'CASCADE',
+                ReferentialAction::CASCADE,
+                ReferentialAction::CASCADE,
                 Dbhelper::replaceQuotes(
                     <<<SQL
                     ALTER TABLE [[$tableName]] ADD CONSTRAINT [[$name]] FOREIGN KEY ([[C_fk_id_1]]) REFERENCES [[$pkTableName]] ([[C_id_1]]) ON DELETE CASCADE ON UPDATE CASCADE
@@ -67,8 +68,8 @@ public static function addForeignKey(): array
                 'C_fk_id_1, C_fk_id_2',
                 $pkTableName,
                 'C_id_1, C_id_2',
-                'CASCADE',
-                'CASCADE',
+                ReferentialAction::CASCADE,
+                ReferentialAction::CASCADE,
                 Dbhelper::replaceQuotes(
                     <<<SQL
                     ALTER TABLE [[$tableName]] ADD CONSTRAINT [[$name]] FOREIGN KEY ([[C_fk_id_1]], [[C_fk_id_2]]) REFERENCES [[$pkTableName]] ([[C_id_1]], [[C_id_2]]) ON DELETE CASCADE ON UPDATE CASCADE
@@ -1580,8 +1581,8 @@ public static function buildColumnDefinition(): array
         $reference = new ForeignKeyConstraint();
         $reference->foreignColumnNames(['id']);
         $reference->foreignTableName('ref_table');
-        $reference->onDelete('CASCADE');
-        $reference->onUpdate('CASCADE');
+        $reference->onDelete(ReferentialAction::CASCADE);
+        $reference->onUpdate(ReferentialAction::CASCADE);
 
         $referenceWithSchema = clone $reference;
         $referenceWithSchema->foreignSchemaName('ref_schema');
diff --git a/tests/Provider/SchemaProvider.php b/tests/Provider/SchemaProvider.php
index fe840547d..970826173 100644
--- a/tests/Provider/SchemaProvider.php
+++ b/tests/Provider/SchemaProvider.php
@@ -6,6 +6,7 @@
 
 use PDO;
 use Yiisoft\Db\Constant\IndexType;
+use Yiisoft\Db\Constant\ReferentialAction;
 use Yiisoft\Db\Constraint\CheckConstraint;
 use Yiisoft\Db\Constraint\Constraint;
 use Yiisoft\Db\Constraint\ForeignKeyConstraint;
@@ -105,8 +106,8 @@ public static function constraints(): array
                         ->columnNames(['C_fk_id_1', 'C_fk_id_2'])
                         ->foreignTableName('T_constraints_2')
                         ->foreignColumnNames(['C_id_1', 'C_id_2'])
-                        ->onDelete('CASCADE')
-                        ->onUpdate('CASCADE'),
+                        ->onDelete(ReferentialAction::CASCADE)
+                        ->onUpdate(ReferentialAction::CASCADE),
                 ],
             ],
             '3: unique' => ['T_constraints_3', SchemaInterface::UNIQUES, []],