class D7FileEntityDeriver in Media Migration 8

Deriver for file entity migrations.

Hierarchy

class \Drupal\Component\Plugin\Derivative\DeriverBase implements DeriverInterface
- class \Drupal\media_migration\Plugin\migrate\D7FileEntityConfigDeriver implements ContainerDeriverInterface uses StringTranslationTrait, MigrationDeriverTrait
  - class \Drupal\media_migration\Plugin\migrate\D7FileEntityDeriver

Expanded class hierarchy of D7FileEntityDeriver

1 string reference to 'D7FileEntityDeriver'

d7_file_entity.yml in migrations/d7_file_entity.yml: migrations/d7_file_entity.yml

File

src/Plugin/migrate/D7FileEntityDeriver.php, line 20

Namespace

Drupal\media_migration\Plugin\migrate

View source

class D7FileEntityDeriver extends D7FileEntityConfigDeriver {

  /**
   * The base plugin ID this derivative is for.
   *
   * @var string
   */
  protected $basePluginId;

  /**
   * The field plugin manager.
   *
   * @var \Drupal\migrate_drupal\Plugin\MigrateFieldPluginManagerInterface
   */
  protected $fieldPluginManager;

  /**
   * The entity type manager.
   *
   * @var \Drupal\Core\Entity\EntityTypeManagerInterface
   */
  protected $entityTypeManager;

  /**
   * The migration field discovery service.
   *
   * @var \Drupal\migrate_drupal\FieldDiscoveryInterface
   */
  protected $fieldDiscovery;

  /**
   * The file entity dealer plugin manager.
   *
   * @var \Drupal\media_migration\FileEntityDealerManagerInterface
   */
  protected $fileEntityDealerManager;

  /**
   * D7FileEntityDeriver constructor.
   *
   * @param \Drupal\media_migration\FileEntityDealerManagerInterface $file_entity_dealer_manager
   *   The file entity dealer plugin manager.
   * @param \Drupal\migrate_drupal\FieldDiscoveryInterface $field_discovery
   *   The migration field discovery service.
   */
  public function __construct(FileEntityDealerManagerInterface $file_entity_dealer_manager, FieldDiscoveryInterface $field_discovery) {
    parent::__construct($file_entity_dealer_manager);
    $this->fieldDiscovery = $field_discovery;
  }

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container, $base_plugin_id) {
    return new static($container
      ->get('plugin.manager.file_entity_dealer'), $container
      ->get('migrate_drupal.field_discovery'));
  }

  /**
   * {@inheritdoc}
   */
  public function getDerivativeDefinitions($base_plugin_definition) {
    $file_entity_types = static::getSourcePlugin('d7_file_entity_type');
    try {
      $file_entity_types
        ->checkRequirements();
    } catch (RequirementsException $e) {
      return $this->derivatives;
    }
    try {
      foreach ($file_entity_types as $file_entity_type_row) {
        assert($file_entity_type_row instanceof Row);
        [
          'types' => $types,
          'schemes' => $schemes,
        ] = $file_entity_type_row
          ->getSource();
        foreach (explode(ConfigSourceBase::MULTIPLE_SEPARATOR, $types) as $type) {
          foreach (explode(ConfigSourceBase::MULTIPLE_SEPARATOR, $schemes) as $scheme) {
            $dealer_plugin = $this->fileEntityDealerManager
              ->createInstanceFromTypeAndScheme($type, $scheme);

            // No plugin was found for this file entity type row.
            if (!$dealer_plugin instanceof FileEntityDealerPluginInterface) {
              throw new \LogicException(sprintf('No FileEntityDealer plugin applies for file entities with type "%s" and with scheme "%s/*"', $type, $scheme));
            }
            $destination_media_type_id = $dealer_plugin
              ->getDestinationMediaTypeId();
            $derivative_definition = $base_plugin_definition;
            $derivative_id = implode(PluginBase::DERIVATIVE_SEPARATOR, [
              $type,
              $scheme,
            ]);

            // Create the migration derivative.
            $derivative_definition['migration_tags'][] = MediaMigration::MIGRATION_TAG_MAIN;
            $derivative_definition['migration_tags'][] = MediaMigration::MIGRATION_TAG_CONTENT;
            $derivative_definition['source']['type'] = $type;
            $derivative_definition['source']['scheme'] = $scheme;
            $derivative_definition['source']['destination_media_type_id'] = $destination_media_type_id;
            $derivative_definition['label'] = $this
              ->t('@label (@type)', [
              '@label' => $base_plugin_definition['label'],
              '@type' => $dealer_plugin
                ->getDestinationMediaTypeLabel(),
            ]);

            // Post-process migration dependencies: instead of depending on
            // migrations based on their base plugin ID, it is better to use the
            // corresponding derivatives where possible.
            $derived_migration_ids = [
              'd7_file_entity_type',
              'd7_file_entity_source_field',
              'd7_file_entity_source_field_config',
              'd7_file_entity_widget',
              'd7_file_entity_formatter',
            ];
            foreach ($derived_migration_ids as $derived_migration_base_id) {
              $required_dependencies = !empty($derivative_definition['migration_dependencies']['required']) ? $derivative_definition['migration_dependencies']['required'] : [];
              $dependency_key = array_search($derived_migration_base_id, $required_dependencies, TRUE);
              if ($dependency_key !== FALSE) {
                $derivative_definition['migration_dependencies']['required'][$dependency_key] .= PluginBase::DERIVATIVE_SEPARATOR . $destination_media_type_id;
              }
            }

            // Add bundle field processes.
            $migration = \Drupal::service('plugin.manager.migration')
              ->createStubMigration($derivative_definition);
            $process_keys_before = array_keys($derivative_definition['process']);
            assert($migration instanceof Migration);
            $this->fieldDiscovery
              ->addBundleFieldProcesses($migration, 'file', $type);
            $derivative_definition = $migration
              ->getPluginDefinition();
            if (!empty(array_diff(array_keys($derivative_definition['process']), $process_keys_before))) {
              $derivative_definition['migration_dependencies']['required'][] = 'd7_field_instance';
            }

            // Add the corresponding file migration as migration dependency.
            switch ($scheme) {
              case 'public':
                $derivative_definition['migration_dependencies']['required'][] = 'd7_file';
                break;
              case 'private':
                $derivative_definition['migration_dependencies']['required'][] = 'd7_file_private';
                break;
            }
            $dealer_plugin
              ->alterMediaEntityMigrationDefinition($derivative_definition, $file_entity_types
              ->getDatabase());
            $this->derivatives[$derivative_id] = $derivative_definition;
          }
        }
      }
    } catch (DatabaseExceptionWrapper $e) {

      // Once we begin iterating the source plugin it is possible that the
      // source tables will not exist. This can happen when the
      // MigrationPluginManager gathers up the migration definitions but we do
      // not actually have a Drupal 7 source database.
    }
    return $this->derivatives;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
D7FileEntityDeriver::$basePluginId	protected	property	The base plugin ID this derivative is for.
D7FileEntityDeriver::$entityTypeManager	protected	property	The entity type manager.
D7FileEntityDeriver::$fieldDiscovery	protected	property	The migration field discovery service.
D7FileEntityDeriver::$fieldPluginManager	protected	property	The field plugin manager.
D7FileEntityDeriver::$fileEntityDealerManager	protected	property	The file entity dealer plugin manager. Overrides D7FileEntityConfigDeriver::$fileEntityDealerManager
D7FileEntityDeriver::create	public static	function	Creates a new class instance. Overrides D7FileEntityConfigDeriver::create
D7FileEntityDeriver::getDerivativeDefinitions	public	function	Gets the definition of all derivatives of a base plugin. Overrides D7FileEntityConfigDeriver::getDerivativeDefinitions
D7FileEntityDeriver::__construct	public	function	D7FileEntityDeriver constructor. Overrides D7FileEntityConfigDeriver::__construct
DeriverBase::$derivatives	protected	property	List of derivative definitions.	1
DeriverBase::getDerivativeDefinition	public	function	Gets the definition of a derivative plugin. Overrides DeriverInterface::getDerivativeDefinition
MigrationDeriverTrait::getSourcePlugin	public static	function	Returns a fully initialized instance of a source plugin.
StringTranslationTrait::$stringTranslation	protected	property	The string translation service.	1
StringTranslationTrait::formatPlural	protected	function	Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals	protected	function	Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation	protected	function	Gets the string translation service.
StringTranslationTrait::setStringTranslation	public	function	Sets the string translation service to use.	2
StringTranslationTrait::t	protected	function	Translates a string to the current language or to a given language.

You are here

class D7FileEntityDeriver in Media Migration 8

Hierarchy

File

Namespace

Members

API Navigation