Issue #3247331 by mikelutz, smustgrave: Deprecate MigrateSkipProcessException

core/modules/migrate/src/MigrateSkipProcessException.php

@@ -4,7 +4,17 @@
 
 /**
  * This exception is thrown when the rest of the process should be skipped.
+ *
+ * @deprecated in drupal:10.3.0 and is removed from drupal:12.0.0. Return FALSE from a process
+ *   plugin's isPipelineStopped() method to stop further processing on a
+ *   pipeline.
+ * @see https://www.drupal.org/node/3414511
  */
 class MigrateSkipProcessException extends \Exception {
 
+  public function __construct(string $message = "", int $code = 0, ?\Throwable $previous = NULL) {
+    trigger_error(__CLASS__ . " is deprecated in drupal:10.3.0 and is removed from drupal:12.0.0. Return TRUE from a process plugin's isPipelineStopped() method to halt further processing on a pipeline. See https://www.drupal.org/node/3414511", E_USER_DEPRECATED);
+    parent::__construct($message, $code, $previous);
+  }
+
 }

core/modules/migrate/tests/src/Unit/Exception/MigrateSkipProcessExceptionTest.php

+<?php
+
+declare(strict_types=1);
+
+namespace Drupal\Tests\migrate\Unit\Exception;
+
+use Drupal\migrate\MigrateSkipProcessException;
+use Drupal\Tests\UnitTestCase;
+
+/**
+ * Tests deprecation error on MigrateSkipProcessException.
+ *
+ * @group legacy
+ */
+class MigrateSkipProcessExceptionTest extends UnitTestCase {
+
+  /**
+   * Tests a deprecation error is triggered on throw.
+   */
+  public function testDeprecation(): void {
+    $this->expectException(MigrateSkipProcessException::class);
+    $this->expectDeprecation("Unsilenced deprecation: " . MigrateSkipProcessException::class . " is deprecated in drupal:10.3.0 and is removed from drupal:12.0.0. Return TRUE from a process plugin's isPipelineStopped() method to halt further processing on a pipeline. See https://www.drupal.org/node/3414511");
+    throw new MigrateSkipProcessException();
+  }
+
+}