Skip hooks during a Drupal 8 & 9 migration

15 Jan. 2020

When migrating content with the Drupal 8 migrate module, the creation and updating of new entities may fire lots of custom module hooks. This may or may not be desired; if you have found yourself here, it probably interferes with the source data in a problematic way, or unnecessarily slows down the migration process.

The cleanest way I found to stop specific hooks for specific migrations, is to add a dummy/meta field to the migration and check for its value in the hook.

Include a dummy field in the migration

In the process section of the migration, add a field with a name that will not interfere with any field name of the target entity:

  1. # This is the field that will provide a custom hook
  2. # with the information about the migration.
  3. _migration:
  4. - plugin: default_value
  5. default_value: 'blog_categories'

This is an example migration with CSV as source and taxonomy terms as target:

  1. id: blog_categories
  2. label: 'Blog category migration'
  3. migration_group: default
  5. source:
  6. plugin: csv
  7. path: 'public://migrations/blog_categories.csv'
  8. delimiter: ','
  9. enclosure: '"'
  10. header_row_count: 1
  11. ids: [tid]
  13. process:
  14. name: name
  16. # This is the field that will provide a custom hook
  17. # with the information about the migration.
  18. _migration:
  19. - plugin: default_value
  20. default_value: 'blog_categories'
  22. destination:
  23. plugin: entity:taxonomy_term
  24. default_bundle: blog_categories
  26. migration_dependencies:
  27. required: {}
  28. optional: {}

Check for the value in an entity hook

  1. /**
  2.  * Implements hook_entity_update().
  3.  */
  4. function my_module_entity_update(Drupal\Core\Entity\EntityInterface $entity) {
  5. if (isset($entity->_migration) && $entity->_migration === 'blog_categories') {
  6. return;
  7. }
  9. // Some undesired custom hook logic.
  10. }

In this case the hook will never fire for this specific migration, but may fire for other migrations. Skipping the second condition will make sure the hook will never fire for migrations where the _migration dummy field is defined.


If you have a site that has real people editing content at the same time a migration is running, this might lead to an issue. Where the real user's edits are ignored because the migration is in progress.

Neuen Kommentar hinzufügen

Der Inhalt dieses Feldes wird nicht öffentlich zugänglich angezeigt.

Restricted HTML

  • Erlaubte HTML-Tags: <a href hreflang target> <em> <strong> <cite> <blockquote cite> <pre> <ul type> <ol start type> <li> <dl> <dt> <dd> <h4 id> <h5 id> <h6 id>
  • Zeilenumbrüche und Absätze werden automatisch erzeugt.
  • Website- und E-Mail-Adressen werden automatisch in Links umgewandelt.

Angebot innerhalb von 24 Stunden

Ob ein großes kommerzielles System, oder eine kleine Business Seite, wir schicken ein Angebot ab innerhalb von 24 Stunden nachdem Sie diese Taste drücken: Angebot anfordern