: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
// 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\Pro\Migrations\Migrations as MigrationsPro;
// phpcs:enable WPForms.PHP.UseStatement.UnusedUseStatement
* Class UpgradeBase contains both Lite and Pro plugin upgrade methods.
abstract class UpgradeBase {
* Migration class instance.
* @var Migrations|MigrationsPro
* Primary class constructor.
* @param Migrations|MigrationsPro $migrations Instance of Migrations class.
public function __construct( $migrations ) {
$this->migrations = $migrations;
* @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 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.
* @param string $class Classname of 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( $class ) { // phpcs:ignore WPForms.PHP.HooksMethod.InvalidPlaceForAddingHooks
$status = get_option( $class::STATUS );
if ( $status === $class::COMPLETED ) {
delete_option( $class::STATUS );
update_option( $class::STATUS, $class::START );
// Class Tasks does not exist at this point, so we have to add an action on init.
static function () use ( $class ) {
( new $class() )->init();