public function Explode::transform in Drupal 9

Same name and namespace in other branches

1. 8 core/modules/migrate/src/Plugin/migrate/process/Explode.php \Drupal\migrate\Plugin\migrate\process\Explode::transform()
2. 10 core/modules/migrate/src/Plugin/migrate/process/Explode.php \Drupal\migrate\Plugin\migrate\process\Explode::transform()

Performs the associated process.

Parameters

mixed $value: The value to be transformed.

\Drupal\migrate\MigrateExecutableInterface $migrate_executable: The migration in which this process is being executed.

\Drupal\migrate\Row $row: The row from the source to process. Normally, just transforming the value is adequate but very rarely you might need to change two columns at the same time or something like that.

string $destination_property: The destination property currently worked on. This is only used together with the $row above.

Return value

string|array The newly transformed value.

Overrides ProcessPluginBase::transform

File

core/modules/migrate/src/Plugin/migrate/process/Explode.php, line 99

Class

Explode

Splits the source string into an array of strings, using a delimiter.

Namespace

Drupal\migrate\Plugin\migrate\process

Code

public function transform($value, MigrateExecutableInterface $migrate_executable, Row $row, $destination_property) {
  if (empty($this->configuration['delimiter'])) {
    throw new MigrateException('delimiter is empty');
  }
  $strict = array_key_exists('strict', $this->configuration) ? $this->configuration['strict'] : TRUE;
  if ($strict && !is_string($value)) {
    throw new MigrateException(sprintf('%s is not a string', var_export($value, TRUE)));
  }
  elseif (!$strict) {

    // Check if the incoming value can cast to a string.
    $original = $value;
    if (!is_string($original) && $original != ($value = @strval($value))) {
      throw new MigrateException(sprintf('%s cannot be casted to a string', var_export($original, TRUE)));
    }

    // Empty strings should be exploded to empty arrays.
    if ($value === '') {
      return [];
    }
  }
  $limit = isset($this->configuration['limit']) ? $this->configuration['limit'] : PHP_INT_MAX;
  return explode($this->configuration['delimiter'], $value, $limit);
}