Jak migrować jednostki plików do jednostek mediów?

Korzystam z modułu migracji do migracji z D7 na D8 i piszę całą migrację ręcznie w kodzie (zamiast używać wbudowanego modułu migracji D7, ponieważ chciałem bardziej szczegółowej kontroli nad migracją).

Mam następującą strukturę: strona D7 ma pole obrazu, w którym obrazy są przechowywane jako byty plików. W witrynie D8 pole obrazu jest odniesieniem do obiektu Media (a obiekt Media z kolei ma pole Image).

Początkowo miałem do migracji obrazy:

id: image_files

source:
  plugin: legacy_images
  constants:
    source_base_path: http://example.com/

destination:
  plugin: 'entity:file'

process:
  fid: fid
  filename: filename
  source_full_path:
    -
      plugin: concat
      delimiter: /
      source:
    -     constants/source_base_path
    -     uri
    -
      plugin: urlencode
  uri:
    plugin: file_copy
    source:
      - '@source_full_path'
      - uri
  filemime: filemime
  status: status

W moim pliku migracji węzła artykułu miałem następujące elementy:

'field_article_image/target_id':
plugin: migration
migration: image_files
source: field_article_image 

ale zdałem sobie sprawę, że to nie zadziała. Identyfikator target pochodzący z migracji image_files był naprawdę identyfikatorem jednostki pliku, a nie identyfikatorem jednostki medialnej. W idealnym świecie chciałbym znaleźć sposób na utworzenie trzeciej migracji, która stworzyłaby ten środkowy krok i migrował by podmioty plików do encji medialnych, a następnie zamapował tę migrację na migrację artykułów. Jednak nie mogę znaleźć dobrego sposobu na zrobienie tego.

Plan B będzie polegał po prostu na stworzeniu wtyczki procesowej do migracji obrazów, która ręcznie utworzy encje plików, przyczepi je do encji medialnych i przekaże tę migrację do artykułów (usuwa to środkowy krok). Oznaczałoby to jednak, że chociaż encje multimedialne można wycofać, encje plików nie mogą.

Skończyło się na tym, że postanowiłem to zrobić nieco inaczej - tworzę regularny import plików, ustawiam tę migrację jako źródło w polu referencyjnym encji medialnej, a następnie zastosowałem drugą wtyczkę procesową „MediaGenerate”, aby przetłumaczyć FID na nowy nośnik target_id

<?php

namespace Drupal\my_migration\Plugin\migrate\process;

use Drupal\media_entity\Entity\Media;
use Drupal\migrate\MigrateExecutableInterface;
use Drupal\migrate\MigrateException;
use Drupal\migrate\Row;
use Drupal\migrate_plus\Plugin\migrate\process\EntityGenerate;

/**
 * Generate a media entity with specified metadata.
 *
 * This plugin is to be used by migrations which have media entity reference
 * fields.
 *
 * Available configuration keys:
 * - destinationField: the name of the file field on the media entity.
 *
 * @code
 * process:
 *   'field_files/target_id':
 *     -
 *       plugin: migration
 *       source: files
 *     -
 *       plugin: media_generate
 *       destinationField: image
 *
 * @endcode
 *
 * @MigrateProcessPlugin(
 *   id = "media_generate"
 * )
 */
class MediaGenerate extends EntityGenerate {

/**
* {@inheritdoc}
*/
public function transform($value, MigrateExecutableInterface $migrateExecutable, Row $row, $destinationProperty) {
if (!isset($this->configuration['destinationField'])) {
  throw new MigrateException('Destination field must be set.');
}
// First load the target_id of the file referenced via the migration.
/* @var /Drupal/file/entity/File $file */
$file = $this->entityManager->getStorage('file')->load($value);

if (empty($file)) {
  throw new MigrateException('Referenced file does not exist');
}

// Creates a media entity if the lookup determines it doesn't exist.
$fileName = $file->label();
if (!($entityId = parent::transform($fileName, $migrateExecutable, $row, $destinationProperty))) {
  return NULL;
}
$entity = Media::load($entityId);

$fileId = $file->id();
$entity->{$this->configuration['destinationField']}->setValue($fileId);
$entity->save();

return $entityId;
}

}

Bardzo doceniam przyjętą odpowiedź, jednak miała ona już trochę przestarzałe definicje i nie obsługiwała publikowania właściwości obrazu alt i tytułu. Dlatego trochę go ulepszyłem, aby to obsługiwać i pracować płynnie z najnowszym Drupalem 8.6.x. Oto kod MediaGenerate.php (odpowiednia składnia Yamla znajduje się w komentarzu do dokumentu):

<?php

namespace Drupal\my_migration\Plugin\migrate\process;

use Drupal\media\Entity\Media;
use Drupal\migrate\MigrateExecutableInterface;
use Drupal\migrate\MigrateException;
use Drupal\migrate\Row;
use Drupal\migrate_plus\Plugin\migrate\process\EntityGenerate;

/**
 * Generate a media entity with specified metadata.
 *
 * This plugin is to be used by migrations which have media entity reference
 * fields.
 *
 * Available configuration keys:
 * - destinationField: the name of the file field on the media entity.
 *
 * @code
 * process:
 *   'field_files/target_id':
 *     -
 *       plugin: migration_lookup
 *       migration: my_file_migration
 *       source: field_image/0/fid
 *     -
 *       plugin: media_generate
 *       destinationField: image
 *       imageAltSource: field_image/0/alt
 *       imageTitleSource: field_image/0/title
 *
 * @endcode
 *
 * If image_alt_source and/or image_title_source configuration parameters
 * are provided, alt and/or title image properties will be fetched from provided
 * source fields (if available) and pushed into media entity
 *
 * @MigrateProcessPlugin(
 *   id = "media_generate"
 * )
 */
class MediaGenerate extends EntityGenerate {

  /**
   * {@inheritdoc}
   */
  public function transform($value, MigrateExecutableInterface $migrateExecutable, Row $row, $destinationProperty) {
    if (!isset($this->configuration['destinationField'])) {
      throw new MigrateException('Destination field must be set.');
    }

    // First load the target_id of the file referenced via the migration.
    /* @var /Drupal/file/entity/File $file */
    $file = $this->entityManager->getStorage('file')->load($value);

    if (empty($file)) {
      throw new MigrateException('Referenced file does not exist');
    }

    // Creates a media entity if the lookup determines it doesn't exist.
    $fileName = $file->label();
    if (!($entityId = parent::transform($fileName, $migrateExecutable, $row, $destinationProperty))) {
      return NULL;
    }

    $entity = Media::load($entityId);

    $fileId = $file->id();

    $destinationFieldValues = $entity->{$this->configuration['destinationField']}->getValue();
    $destinationFieldValues[0]['target_id'] = $fileId;

    $this->insertPropertyIntoDestinationField($destinationFieldValues, $row, 'alt', 'imageAltSource');
    $this->insertPropertyIntoDestinationField($destinationFieldValues, $row, 'title', 'imageTitleSource');

    $entity->{$this->configuration['destinationField']}->setValue($destinationFieldValues);
    $entity->save();

    return $entityId;
  }

  protected function insertPropertyIntoDestinationField(array &$destinationFieldValues, Row $row, $propertyKey, $configurationKey) {
    // Set alt and title into media entity if not empty
    if (isset($this->configuration[$configurationKey])) {
      $propertyValue = $row->getSourceProperty($this->configuration[$configurationKey]);
      if (!empty($propertyValue)) {
        $destinationFieldValues[0][$propertyKey] = $propertyValue;
      }
    }
  }
}

Ponieważ Media to typ encji, należy utworzyć własną migrację. Możesz wygenerować nowe źródło z tabeli plików. Oto przykład

https://gist.github.com/jibran/8e7cd2319e873858dd49a272227a4fd2

Następnie migration_lookupmożesz zmapować takie pola.

field_d8_media_image/0/target_id:
  plugin: migration_lookup
  migration: my_media_image
  source: field_d7_image/0/fid

Jeśli chcesz migrować pliki w Drupal 8 do encji medialnych, możesz użyć tego modułu: https://www.drupal.org/project/migrate_file_to_media

Ma skrypt Drush, który automatycznie tworzy pola odniesienia mediów. Dodatkowo wykrywa zduplikowane obrazy za pomocą binarnego skrótu. I obsługuje tłumaczenia.