Same name and namespace in other branches
  1. 8.9.x core/modules/migrate/src/MigrateSkipRowException.php \Drupal\migrate\MigrateSkipRowException
  2. 9 core/modules/migrate/src/MigrateSkipRowException.php \Drupal\migrate\MigrateSkipRowException

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.

Hierarchy

Expanded class hierarchy of MigrateSkipRowException

17 files declare their use of MigrateSkipRowException
BlockVisibility.php in core/modules/block/src/Plugin/migrate/process/BlockVisibility.php
BlockVisibilityTest.php in core/modules/block/tests/src/Unit/Plugin/migrate/process/BlockVisibilityTest.php
MenuLinkParent.php in core/modules/migrate/src/Plugin/migrate/process/MenuLinkParent.php
MenuLinkParentTest.php in core/modules/migrate/tests/src/Unit/process/MenuLinkParentTest.php
MigrateSourceTest.php in core/modules/migrate/tests/src/Unit/MigrateSourceTest.php

... See full list

File

core/modules/migrate/src/MigrateSkipRowException.php, line 12

Namespace

Drupal\migrate
View source
class MigrateSkipRowException extends \Exception {

  /**
   * Whether to record the skip in the map table, or skip silently.
   *
   * @var bool
   *   TRUE to record as STATUS_IGNORED in the map, FALSE to skip silently.
   */
  protected $saveToMap;

  /**
   * Constructs a MigrateSkipRowException object.
   *
   * @param string $message
   *   The message for the exception.
   * @param bool $save_to_map
   *   TRUE to record as STATUS_IGNORED in the map, FALSE to skip silently.
   */
  public function __construct($message = '', $save_to_map = TRUE) {
    parent::__construct($message);
    $this->saveToMap = $save_to_map;
  }

  /**
   * Whether the thrower wants to record this skip in the map table.
   *
   * @return bool
   *   TRUE to record as STATUS_IGNORED in the map, FALSE to skip silently.
   */
  public function getSaveToMap() {
    return $this->saveToMap;
  }

}

Members

Name Modifierssort descending Type Description Overrides
MigrateSkipRowException::$saveToMap protected property Whether to record the skip in the map table, or skip silently.
MigrateSkipRowException::__construct public function Constructs a MigrateSkipRowException object.
MigrateSkipRowException::getSaveToMap public function Whether the thrower wants to record this skip in the map table.