[4.7] Upgrade events

.github/workflows/ci.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - '4.x'
+      - '4.7'
   pull_request:
 permissions:
   contents: read

CHANGELOG-WIP.md

@@ -0,0 +1,3 @@
+# Release Notes for Craft Commerce 4.7 (WIP)
+
+## Unreleased

src/console/controllers/UpgradeController.php

@@ -12,6 +12,7 @@
 use craft\commerce\console\Controller;
 use craft\commerce\db\Table;
 use craft\commerce\elements\conditions\addresses\PostalCodeFormulaConditionRule;
+use craft\commerce\events\UpgradeEvent;
 use craft\commerce\Plugin;
 use craft\commerce\records\Store;
 use craft\db\Connection;
@@ -51,6 +52,11 @@
  */
 class UpgradeController extends Controller
 {
+    /**
+     * @event Event The event that is triggered before the v3 columns and tables are dropped.
+     */
+    const EVENT_BEFORE_DROP_V3_DATABASE_ENTITIES = 'beforeDropV3DatabaseEntities';
+
     /**
      * @inheritdoc
      */
@@ -316,6 +322,13 @@ public function actionRun(): int
             return ExitCode::UNSPECIFIED_ERROR;
         }
 
+        $event = new UpgradeEvent();
+        $event->v3columnMap = $this->_v3droppableColumns;
+        $event->v3tables = $this->_v3tables;
+        if($this->hasEventHandlers(self::EVENT_BEFORE_DROP_V3_DATABASE_ENTITIES)) {
+            $this->trigger(self::EVENT_BEFORE_DROP_V3_DATABASE_ENTITIES, $event);
+        }
+
         $this->stdout("Cleaning up tables…");
         foreach ($this->_v3tables as $table) {
             Db::dropAllForeignKeysToTable($table, $this->db);

src/events/UpgradeEvent.php

@@ -0,0 +1,29 @@
+<?php
+/**
+ * @link https://craftcms.com/
+ * @copyright Copyright (c) Pixel & Tonic, Inc.
+ * @license https://craftcms.github.io/license/
+ */
+
+namespace craft\commerce\events;
+
+use craft\commerce\models\Email;
+use yii\base\Event;
+
+/**
+ * Class UpgradeEvent
+ *
+ * @author Pixel & Tonic, Inc. <[email protected]>
+ */
+class UpgradeEvent extends Event
+{
+    /**
+     * @var array $columns
+     */
+    public array $v3columnMap = [];
+
+    /**
+     * @var array $v3tables
+     */
+    public array $v3tables = [];
+}