continue;
}
$this->migrated[ $upgrade_version ] = $migrated ? time() : self::FAILED;
$this->log_migration_message( $migrated, $plugin_name, $upgrade_version );
}
}
/**
* If an upgrade has occurred, update a version option in the database.
*
* @since 1.7.5
*/
public function update_versions(): void {
$this->update_previous_core_version();
// Retrieve the last migrated versions.
$last_migrated = get_option( static::MIGRATED_OPTION_NAME, [] );
$migrated = array_merge( $last_migrated, $this->migrated );
/**
* Store the current version upgrade timestamp even if there were no migrations to it.
* We need it in wpforms_get_upgraded_timestamp() for further usage in Event Driven Plugin Notifications.
* The version key is normalized (the '-RCn' suffix is stripped) to keep the stored state
* consistent with the normalized version comparisons in migrate() and update_previous_core_version().
*/
$current_version = wpforms_normalize_version( static::CURRENT_VERSION );
$migrated[ $current_version ] = $migrated[ $current_version ] ?? time();
uksort( $last_migrated, 'version_compare' );
uksort( $migrated, 'version_compare' );
if ( $migrated === $last_migrated ) {
return;
}
update_option( static::MIGRATED_OPTION_NAME, $migrated );
$fully_completed = array_reduce(
$migrated,
static function ( $carry, $status ) {
return $carry && ( $status >= 0 );
},
true
);
if ( ! $fully_completed ) {
return;
}
$this->log(
sprintf( 'Migration of %1$s to %2$s is fully completed.', static::PLUGIN_NAME, static::CURRENT_VERSION )
);
}
/**
* Update previous core version.
*
* @since 1.9.8
*
* @return void
*/
private function update_previous_core_version(): void {
if ( ! $this->is_core_plugin() ) {
return;
}
// Retrieve the last migrated versions.
$last_migrated = get_option( static::MIGRATED_OPTION_NAME, [] );
$previous_core_version = $this->get_max_version( $last_migrated );
if (
$previous_core_version === self::INITIAL_FAKE_VERSION ||
wpforms_version_compare( $previous_core_version, static::CURRENT_VERSION, '>=' )
) {
return;
}
// Store the previous core version in the option.
update_option( self::PREVIOUS_CORE_VERSION_OPTION_NAME, $previous_core_version );
/**
* Fires after the core plugin has been upgraded.
* Please note: some of the migrations that run via Active Scheduler can be not completed yet.
*
* @since 1.8.8
*
* @param string $previous_core_version The core version from which the plugin was upgraded.
* @param Base $migration_obj The migration class instance.
*/
do_action( 'wpforms_migrations_base_core_upgraded', $previous_core_version, $this );
}
/**
* Get upgrade classes.
*
* @since 1.7.5
*
* @return string[]
*/
protected function get_upgrade_classes(): array {
$classes = static::UPGRADE_CLASSES;
sort( $classes );
return $classes;
}
/**
* Get an upgrade version from the class name.
*
* @since 1.7.5
*
* @param string $class_name Class name.
*
* @return string
*/
public function get_upgrade_version( string $class_name ): string {
// Find only the digits and underscores to get the version number.
if ( ! preg_match( '/(\d_?)+/', $class_name, $matches ) ) {
return '';
}
$raw_version = $matches[0];
if ( strpos( $raw_version, '_' ) ) {
// Modern notation: 1_10_0_3 means 1.10.0.3 version.
return str_replace( '_', '.', $raw_version );
}
// Legacy notation, with 1-digit subversion numbers: 1751 means 1.7.5.1 version.
return implode( '.', str_split( $raw_version ) );
}
/**
* Get a plugin /addon name.
*
* @since 1.7.5
*
* @param string $class_name Upgrade class name.
*
* @return string
* @noinspection PhpUnusedParameterInspection
*/
protected function get_plugin_name( string $class_name ): string { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
return static::PLUGIN_NAME;
}
/**
* Force log message to WPForms logger.
*
* @since 1.7.5
*
* @param string $message The error message that should be logged.
*/
protected function log( string $message ): void {
wpforms_log(
'Migration',
$message,
[
'type' => 'log',
'force' => true,
]
);
}
/**
* Determine if migration is allowed.
*
* @since 1.7.5
*/
private function is_allowed(): bool {
// phpcs:ignore WordPress.Security.NonceVerification.Recommended
if ( isset( $_GET['service-worker'] ) ) {
return false;
}
return wp_doing_cron() || is_admin() || wpforms_doing_wp_cli();
}
/**
* Maybe create custom plugin tables.
*
* @since 1.7.6
*/
public function maybe_create_tables(): void {
if ( $this->tables_check_done ) {
/**
* We should do table check only once - when the first migration has been started.
* The DB::get_existing_custom_tables() without caching causes performance issue
* on huge multisite with thousands of tables.
*/
return;
}
DB::create_custom_tables( true );
$this->tables_check_done = true;
}
/**
* Maybe convert the migration option format.
*
* @since 1.7.5
*/
private function maybe_convert_migration_option(): void {
/**
* Retrieve the migration option and check its format.
* Old format: a string 'x.y.z' containing the last migrated version.
* New format: [ 'x.y.z' => {status}, 'x1.y1.z1' => {status}... ],
* where {status} is a migration status.
* Negative means some status (-1 for 'started' etc.),
* zero means completed earlier at an unknown time,
* positive means completion timestamp.
*/
$this->migrated = get_option( static::MIGRATED_OPTION_NAME );
// If the option is an array, it means that it is already converted to the new format.
if ( is_array( $this->migrated ) ) {
return;
}
/**
* Convert the option to the new format.
*
* Old option names contained 'version',
* like 'wpforms_version', 'wpforms_version_lite', 'wpforms_stripe_version', etc.
* We preserve old options for downgrade cases.
* New option names should contain 'versions' and be like 'wpforms_versions', etc.
*/
$this->migrated = get_option(
str_replace( 'versions', 'version', static::MIGRATED_OPTION_NAME )
);
$version = $this->migrated === false ? self::INITIAL_FAKE_VERSION : (string) $this->migrated;
$timestamp = $version === static::CURRENT_VERSION ? time() : 0;
$this->migrated = [ $version => $timestamp ];
$max_version = $this->get_max_version( $this->migrated );
foreach ( $this->get_upgrade_classes() as $upgrade_class ) {
$upgrade_version = $this->get_upgrade_version( $upgrade_class );
if (
! isset( $this->migrated[ $upgrade_version ] ) &&
version_compare( $upgrade_version, $max_version, '<' )
) {
$this->migrated[ $upgrade_version ] = 0;
}
}
unset( $this->migrated[ self::INITIAL_FAKE_VERSION ] );
ksort( $this->migrated );
update_option( static::MIGRATED_OPTION_NAME, $this->migrated );
}
/**
* Get the max version.
*
* @since 1.7.5
*
* @param array $versions Versions.
*
* @return string
*/
private function get_max_version( array $versions ): string {
// phpcs:ignore WPForms.Formatting.EmptyLineBeforeReturn.RemoveEmptyLineBeforeReturnStatement
return array_reduce(
array_keys( $versions ),
static function ( $carry, $version ) {
return version_compare( $version, $carry, '>' ) ? $version : $carry;
},
self::INITIAL_FAKE_VERSION
);
}
/**
* Determine if it is the core plugin (Lite or Pro).
*
* @since 1.7.5
*
* @return bool True if it is the core plugin.
*/
protected function is_core_plugin(): bool {
// phpcs:ignore WPForms.Formatting.EmptyLineBeforeReturn.RemoveEmptyLineBeforeReturnStatement
return strpos( static::MIGRATED_OPTION_NAME, 'wpforms_versions' ) === 0;
}
/**
* Log migration message.
*
* @since 1.8.2.3
*
* @param bool $migrated Migration status.
* @param string $plugin_name Plugin name.
* @param string $upgrade_version Upgrade version.
*
* @return void
*/
private function log_migration_message( bool $migrated, string $plugin_name, string $upgrade_version ): void {
$message = $migrated ?
sprintf( 'Migration of %1$s to %2$s completed.', $plugin_name, $upgrade_version ) :
sprintf( 'Migration of %1$s to %2$s failed.', $plugin_name, $upgrade_version );
$this->log( $message );
}
}
Fatal error: Uncaught Error: Class "WPForms\Migrations\Base" not found in /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/Migrations/Migrations.php:15
Stack trace:
#0 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/the-events-calendar/vendor/composer/ClassLoader.php(576): include()
#1 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/the-events-calendar/vendor/composer/ClassLoader.php(427): {closure:Composer\Autoload\ClassLoader::initializeIncludeClosure():575}()
#2 [internal function]: Composer\Autoload\ClassLoader->loadClass()
#3 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/WPForms.php(412): class_exists()
#4 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/WPForms.php(473): WPForms\WPForms->register()
#5 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/Loader.php(34): WPForms\WPForms->register_bulk()
#6 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/WPForms.php(433): WPForms\Loader->init()
#7 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/WPForms.php(440): WPForms\WPForms->{closure:WPForms\WPForms::register():422}()
#8 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/WPForms.php(294): WPForms\WPForms->register()
#9 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/WPForms.php(228): WPForms\WPForms->includes_magic()
#10 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/WPForms.php(162): WPForms\WPForms->includes()
#11 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/WPForms.php(142): WPForms\WPForms->init()
#12 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/WPForms.php(612): WPForms\WPForms::instance()
#13 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/wpforms.php(250): wpforms()
#14 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-settings.php(597): include_once('/var/www/vhosts...')
#15 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-config.php(92): require_once('/var/www/vhosts...')
#16 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-load.php(50): require_once('/var/www/vhosts...')
#17 /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-blog-header.php(13): require_once('/var/www/vhosts...')
#18 /var/www/vhosts/canottaggiotoscana.org/httpdocs/index.php(17): require('/var/www/vhosts...')
#19 {main}
thrown in /var/www/vhosts/canottaggiotoscana.org/httpdocs/wp-content/plugins/wpforms-lite/src/Migrations/Migrations.php on line 15