Migrate Plus

The migrate_plus project provides extensions to core migration framework functionality, as well as examples.

Migration plugins can be implemented as configuration entities, allowing them to flexibly be loaded, modified, and saved.
MigrationGroup configuration entities allow migrations to be grouped in UI and command-line tools, and also allow configuration to be shared among multiple migrations.

A PREPARE_ROW event is provided to allow object-oriented responses to the core prepare_row hook (modifying source data before processing begins).

entity_lookup - Allows you to match source data to existing Drupal 8 entities and return their IDs (primarily for populating entity reference fields).
entity_generate - Extends entity_lookup to actually generate an entity from the source data where one does not already exist.
file_blob - Allows you to create a file (and corresponding file entity) from blob data.
merge - Allows you to merge multiple source arrays into one array.
skip_on_value - Like core's skip_on_empty, but allows you to skip either the row or process upon matching (or not) a specific value.
str_replace - Wrapper around str_replace, str_ireplace and preg_replace.
transliteration - process strings through the transliteration service to remove language decorations and accents. Especially helpful with file names.

SourcePluginExtension - an abstract source plugin class providing a standard mechanism for specifying a source's IDs and fields via configuration.
Url - a source plugin supporting file- or stream-based content (where a URL, including potentially a local filepath, points to a file containing data to be migrated). The source plugin itself simply manages the (potentially multiple) source URLs, and works with fetcher plugins to retrieve the content and parser plugins to parse it (see below).

Data fetcher plugins are embedded in the Url source plugin to manage retrieval of data via a given protocol.

File - A general-purpose fetcher for accessing any local file or stream wrapper supported by PHP's file_get_contents.
Http - An HTTP-specific fetcher permitting usage of HTTP-specific features (such as specifying request headers).

Data parser plugins are embedded in the Url source plugin to parse the content retrieved by a fetcher.

XML - Parses XML content using the progressive XMLReader PHP extension. Use this when XML content may be too large to be completely parsed in one go in memory.
SimpleXML - Parses XML content using the SimpleXML PHP extension. Use this when you need full xpath support to access data elements, and the XML files are not too large.
JSON - Parses JSON content. See this Lullabot article for an example.
Soap - Parses SOAP feeds.

Provides authentication services to the HTTP fetcher.

Two submodules provide examples of implementing migrations.

migrate_example - A carefully documented implementation of a custom migration scenario, designed to walk you through the basic concepts of the Drupal 8 migration framework.
migrate_example_advanced (still in progress) - Examples of more advanced techniques for Drupal 8 migration.

Related modules

migrate_tools - General-purpose drush commands and basic UI for managing migrations.
migrate_upgrade - Drush commands for running upgrades from Drupal 6 or 7 to Drupal 8.

Supporting organizations:

Ongoing maintenance

Ongoing maintenance

Ongoing maintenance

Ongoing maintenance

Module categories: Developer Tools, Import and Export
59,183 sites report using this module
Created by mikeryan on 21 February 2014, updated 13 February 2024
Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.