| Server IP : 104.21.30.238 / Your IP : 216.73.216.113 Web Server : LiteSpeed System : Linux premium151.web-hosting.com 4.18.0-553.44.1.lve.el8.x86_64 #1 SMP Thu Mar 13 14:29:12 UTC 2025 x86_64 User : tempvsty ( 647) PHP Version : 8.0.30 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : OFF | Pkexec : OFF Directory : /././home/tempvsty/./peekmysite.com/wp-content/plugins/wpforms-lite/src/Migrations/ |
Upload File : |
<?php
// phpcs:disable Generic.Commenting.DocComment.MissingShort
/** @noinspection PhpExpressionResultUnusedInspection */
/** @noinspection PhpPropertyOnlyWrittenInspection */
/** @noinspection UnusedConstructorDependenciesInspection */
/** @noinspection PhpUnusedAliasInspection */
// phpcs:enable Generic.Commenting.DocComment.MissingShort
namespace WPForms\Migrations;
// phpcs:disable WPForms.PHP.UseStatement.UnusedUseStatement
use WPForms\Migrations\Migrations;
use WPForms\Migrations\Tasks\UpgradeBaseTask;
use WPForms\Pro\Migrations\Migrations as MigrationsPro;
// phpcs:enable WPForms.PHP.UseStatement.UnusedUseStatement
/**
* Class UpgradeBase contains both Lite and Pro plugin upgrade methods.
*
* @since 1.7.5
*/
abstract class UpgradeBase {
/**
* Migration class instance.
*
* @since 1.7.5
*
* @var Migrations|MigrationsPro
*/
protected $migrations;
/**
* Primary class constructor.
*
* @since 1.7.5
*
* @param Migrations|MigrationsPro $migrations Instance of Migrations class.
*/
public function __construct( $migrations ) {
$this->migrations = $migrations;
}
/**
* Run upgrade.
*
* @since 1.7.5
*
* @return bool|null Upgrade result:
* true - the upgrade completed successfully,
* false - in the case of failure,
* null - upgrade started but not yet finished (background task).
*/
abstract public function run();
/**
* Run the async upgrade via an Action Scheduler (AS) task.
* The AS task has to support STATUS option with START, IN_PROGRESS, and COMPLETED values.
* Also, the AS task must have the init() method.
*
* @since 1.7.5
*
* @param string $classname Classname of an async AS task.
*
* @return bool|null Upgrade result:
* true - the upgrade completed successfully,
* false - in the case of failure,
* null - upgrade started but not yet finished (background task).
*/
protected function run_async( string $classname ) { // phpcs:ignore WPForms.PHP.HooksMethod.InvalidPlaceForAddingHooks
$instance = new $classname();
if ( $this->is_completed( $instance ) ) {
return true;
}
$this->maybe_start( $instance );
// Class Tasks does not exist at this point, so we have to add an action on init.
add_action(
'init',
static function () use ( $instance ) {
$instance->init();
},
PHP_INT_MAX
);
return null;
}
/**
* Determine if the async AS task is completed.
*
* @since 1.9.5
*
* @param object $instance Instance of an async AS task.
*
* @use UpgradeBaseTask::is_completed()
*
* @return bool
*/
private function is_completed( $instance ): bool {
if ( method_exists( $instance, 'is_completed' ) ) {
return $instance->is_completed();
}
// Legacy tasks.
$status = get_option( $instance::STATUS );
if ( $status === $instance::COMPLETED ) {
delete_option( $instance::STATUS );
return true;
}
return false;
}
/**
* Start the async AS task if it wasn't started yet.
*
* @since 1.9.5
*
* @param object $instance Instance of an async AS task.
*
* @use UpgradeBaseTask::maybe_start()
*/
private function maybe_start( $instance ): void {
if ( method_exists( $instance, 'maybe_start' ) ) {
$instance->maybe_start();
return;
}
// Legacy tasks.
$status = get_option( $instance::STATUS );
if ( ! $status ) {
update_option( $instance::STATUS, $instance::START );
}
}
}