namespace Yoast\WP\SEO\Initializers;
use Yoast\WP\Lib\Migrations\Adapter;
use Yoast\WP\Lib\Migrations\Migration;
use Yoast\WP\SEO\Conditionals\No_Conditionals;
use Yoast\WP\SEO\Config\Migration_Status;
* Triggers database migrations and handles results.
class Migration_Runner implements Initializer_Interface {
* The migrations adapter.
protected $migration_status;
* Retrieves the conditionals for the migrations.
* @return array The conditionals.
public static function get_conditionals() {
* Migrations constructor.
* @param Migration_Status $migration_status The migration status.
* @param Loader $loader The loader.
* @param Adapter $adapter The migrations adapter.
public function __construct(
Migration_Status $migration_status,
$this->migration_status = $migration_status;
$this->adapter = $adapter;
* @throws Exception When a migration errored.
public function initialize() {
$this->run_free_migrations();
// The below actions is used for when queries fail, this may happen in a multisite environment when switch_to_blog is used.
\add_action( '_yoast_run_migrations', [ $this, 'run_free_migrations' ] );
* Runs the free migrations.
* @throws Exception When a migration errored.
public function run_free_migrations() {
$this->run_migrations( 'free' );
* Initializes the migrations.
* @param string $name The name of the migration.
* @param string $version The current version.
* @return bool True on success, false on failure.
* @throws Exception If the migration fails and YOAST_ENVIRONMENT is not production.
public function run_migrations( $name, $version = \WPSEO_VERSION ) {
if ( ! $this->migration_status->should_run_migration( $name, $version ) ) {
if ( ! $this->migration_status->lock_migration( $name ) ) {
$migrations = $this->loader->get_migrations( $name );
if ( $migrations === false ) {
$this->migration_status->set_error( $name, "Could not perform $name migrations. No migrations found.", $version );
$this->adapter->create_schema_version_table();
$all_versions = \array_keys( $migrations );
$migrated_versions = $this->adapter->get_migrated_versions();
$to_do_versions = \array_diff( $all_versions, $migrated_versions );
\sort( $to_do_versions, \SORT_STRING );
foreach ( $to_do_versions as $to_do_version ) {
$class = $migrations[ $to_do_version ];
$this->run_migration( $to_do_version, $class );
} catch ( Exception $exception ) {
// Something went wrong...
$this->migration_status->set_error( $name, $exception->getMessage(), $version );
if ( \defined( 'YOAST_ENVIRONMENT' ) && \YOAST_ENVIRONMENT !== 'production' ) {
$this->migration_status->set_success( $name, $version );
* Runs a single migration.
* @param string $version The version.
* @param string $class The migration class.
* @throws Exception If the migration failed. Caught by the run_migrations function.
protected function run_migration( $version, $class ) {
$migration = new $class( $this->adapter );
$this->adapter->start_transaction();
$this->adapter->add_version( $version );
$this->adapter->commit_transaction();
} catch ( Exception $e ) {
$this->adapter->rollback_transaction();
throw new Exception( \sprintf( '%s - %s', $class, $e->getMessage() ), 0, $e );