public function FieldFile::transform in Drupal 8

Same name and namespace in other branches

1. 9 core/modules/file/src/Plugin/migrate/process/d6/FieldFile.php \Drupal\file\Plugin\migrate\process\d6\FieldFile::transform()
2. 10 core/modules/file/src/Plugin/migrate/process/d6/FieldFile.php \Drupal\file\Plugin\migrate\process\d6\FieldFile::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/file/src/Plugin/migrate/process/d6/FieldFile.php, line 87

Class

FieldFile

Plugin annotation @MigrateProcessPlugin( id = "d6_field_file" )

Namespace

Drupal\file\Plugin\migrate\process\d6

Code

public function transform($value, MigrateExecutableInterface $migrate_executable, Row $row, $destination_property) {
  $options = unserialize($value['data']);

  // Try to look up the ID of the migrated file. If one cannot be found, it
  // means the file referenced by the current field item did not migrate for
  // some reason -- file migration is notoriously brittle -- and we do NOT
  // want to send invalid file references into the field system (it causes
  // fatals), so return an empty item instead.
  // This BC layer is included because if the plugin constructor was called
  // in the legacy way with a migration_lookup process plugin, it may have
  // been preconfigured with a different migration to look up against. While
  // this is unlikely, for maximum BC we will continue to use the plugin to do
  // the lookup if it is provided, and support for this will be removed in
  // Drupal 9.
  if ($this->migrationPlugin) {
    $fid = $this->migrationPlugin
      ->transform($value['fid'], $migrate_executable, $row, $destination_property);
  }
  else {
    $lookup_result = $this->migrateLookup
      ->lookup('d6_file', [
      $value['fid'],
    ]);
    if ($lookup_result) {
      $fid = $lookup_result[0]['fid'];
    }
  }
  if (!empty($fid)) {
    return [
      'target_id' => $fid,
      'display' => $value['list'],
      'description' => isset($options['description']) ? $options['description'] : '',
      'alt' => isset($options['alt']) ? $options['alt'] : '',
      'title' => isset($options['title']) ? $options['title'] : '',
    ];
  }
  else {
    return [];
  }
}