From 290d8a420d82fc4bf6d2758506cf9298b6c70f2f Mon Sep 17 00:00:00 2001
From: Dave Long <dave@longwaveconsulting.com>
Date: Sat, 3 Feb 2024 18:42:15 +0000
Subject: [PATCH] Issue #3247040 by _shY, quietone, smustgrave, joachim:
MigrateSkipRowException should document that it is for use within migration
process plugins
(cherry picked from commit e03d3ec54939e71bcb17140670f319d46fc5a7b0)
---
core/modules/migrate/src/MigrateSkipRowException.php | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/core/modules/migrate/src/MigrateSkipRowException.php b/core/modules/migrate/src/MigrateSkipRowException.php
index 164f5d77db45..aca182678019 100644
--- a/core/modules/migrate/src/MigrateSkipRowException.php
+++ b/core/modules/migrate/src/MigrateSkipRowException.php
@@ -4,6 +4,10 @@
/**
* This exception is thrown when a row should be skipped.
+ *
+ * This exception should be used in Migrate process plugins. Throwing it in a
+ * source plugin may cause unexpected results in the count of rows processed.
+ * And throwing it in a destination plugin causes an error.
*/
class MigrateSkipRowException extends \Exception {
--
GitLab