<?php

[0] Fix | Delete

[1] Fix | Delete

if (!defined('UPDRAFTPLUS_DIR')) die('No access.');

[2] Fix | Delete

[3] Fix | Delete

/**

[4] Fix | Delete

* A class for scheduling-related code.

[5] Fix | Delete

* N.B. This class began life Nov 2018; it is not guaranteed to contain all scheduling-related code. The variables used have also generally remained in the UpdraftPlus class.

[6] Fix | Delete

*/

[7] Fix | Delete

class UpdraftPlus_Job_Scheduler {

[8] Fix | Delete

[9] Fix | Delete

/**

[10] Fix | Delete

* This function is purely for timing - we just want to know the maximum run-time; not whether we have achieved anything during it. It will also run a check on whether the resumption interval is being approached.

[11] Fix | Delete

*/

[12] Fix | Delete

public static function record_still_alive() {

[13] Fix | Delete

[14] Fix | Delete

global $updraftplus;

[15] Fix | Delete

[16] Fix | Delete

// Update the record of maximum detected runtime on each run

[17] Fix | Delete

$time_passed = $updraftplus->jobdata_get('run_times');

[18] Fix | Delete

if (!is_array($time_passed)) $time_passed = array();

[19] Fix | Delete

[20] Fix | Delete

$time_this_run = microtime(true)-$updraftplus->opened_log_time;

[21] Fix | Delete

$time_passed[$updraftplus->current_resumption] = $time_this_run;

[22] Fix | Delete

$updraftplus->jobdata_set('run_times', $time_passed);

[23] Fix | Delete

[24] Fix | Delete

$resume_interval = $updraftplus->jobdata_get('resume_interval');

[25] Fix | Delete

if ($time_this_run + 30 > $resume_interval) {

[26] Fix | Delete

$new_interval = ceil($time_this_run + 30);

[27] Fix | Delete

set_site_transient('updraft_initial_resume_interval', (int) $new_interval, 8*86400);

[28] Fix | Delete

$updraftplus->log("The time we have been running (".round($time_this_run, 1).") is approaching the resumption interval ($resume_interval) - increasing resumption interval to $new_interval");

[29] Fix | Delete

$updraftplus->jobdata_set('resume_interval', $new_interval);

[30] Fix | Delete

}

[31] Fix | Delete

[32] Fix | Delete

}

[33] Fix | Delete

[34] Fix | Delete

/**

[35] Fix | Delete

* This method helps with efficient scheduling

[36] Fix | Delete

*/

[37] Fix | Delete

public static function reschedule_if_needed() {

[38] Fix | Delete

[39] Fix | Delete

global $updraftplus;

[40] Fix | Delete

[41] Fix | Delete

// If nothing is scheduled, then no re-scheduling is needed, so return

[42] Fix | Delete

if (empty($updraftplus->newresumption_scheduled)) return;

[43] Fix | Delete

[44] Fix | Delete

$time_away = $updraftplus->newresumption_scheduled - time();

[45] Fix | Delete

[46] Fix | Delete

// 45 is chosen because it is 15 seconds more than what is used to detect recent activity on files (file mod times). (If we use exactly the same, then it's more possible to slightly miss each other)

[47] Fix | Delete

if ($time_away > 1 && $time_away <= 45) {

[48] Fix | Delete

$updraftplus->log('The scheduled resumption is within 45 seconds - will reschedule');

[49] Fix | Delete

// Increase interval generally by 45 seconds, on the assumption that our prior estimates were innaccurate (i.e. not just 45 seconds *this* time)

[50] Fix | Delete

self::increase_resume_and_reschedule(45);

[51] Fix | Delete

}

[52] Fix | Delete

}

[53] Fix | Delete

[54] Fix | Delete

/**

[55] Fix | Delete

* Indicate that something useful happened. Calling this at appropriate times is an important part of scheduling decisions.

[56] Fix | Delete

*/

[57] Fix | Delete

public static function something_useful_happened() {

[58] Fix | Delete

[59] Fix | Delete

global $updraftplus;

[60] Fix | Delete

[61] Fix | Delete

self::record_still_alive();

[62] Fix | Delete

[63] Fix | Delete

if (!$updraftplus->something_useful_happened) {

[64] Fix | Delete

[65] Fix | Delete

// Update the record of when something useful happened

[66] Fix | Delete

$useful_checkins = $updraftplus->jobdata_get('useful_checkins');

[67] Fix | Delete

if (!is_array($useful_checkins)) $useful_checkins = array();

[68] Fix | Delete

if (!in_array($updraftplus->current_resumption, $useful_checkins)) {

[69] Fix | Delete

$useful_checkins[] = $updraftplus->current_resumption;

[70] Fix | Delete

$updraftplus->jobdata_set('useful_checkins', $useful_checkins);

[71] Fix | Delete

}

[72] Fix | Delete

[73] Fix | Delete

}

[74] Fix | Delete

[75] Fix | Delete

$updraftplus->something_useful_happened = true;

[76] Fix | Delete

[77] Fix | Delete

$clone_job = $updraftplus->jobdata_get('clone_job');

[78] Fix | Delete

[79] Fix | Delete

if (!empty($clone_job)) {

[80] Fix | Delete

static $last_call = false;

[81] Fix | Delete

[82] Fix | Delete

// Check we haven't yet made a call or that 15 minutes has passed before we make another call

[83] Fix | Delete

if (!$last_call || time() - $last_call > 900) {

[84] Fix | Delete

$last_call = time();

[85] Fix | Delete

$clone_id = $updraftplus->jobdata_get('clone_id');

[86] Fix | Delete

$secret_token = $updraftplus->jobdata_get('secret_token');

[87] Fix | Delete

$log_data = $updraftplus->get_last_log_chunk($updraftplus->file_nonce);

[88] Fix | Delete

$log_contents = isset($log_data['log_contents']) ? $log_data['log_contents'] : '';

[89] Fix | Delete

$first_byte = isset($log_data['first_byte']) ? $log_data['first_byte'] : 0;

[90] Fix | Delete

$response = $updraftplus->get_updraftplus_clone()->backup_checkin(array('clone_id' => $clone_id, 'secret_token' => $secret_token, 'first_byte' => $first_byte, 'log_contents' => $log_contents));

[91] Fix | Delete

if (!isset($response['status']) || 'success' != $response['status']) {

[92] Fix | Delete

$updraftplus->log("UpdraftClone backup check-in failed.");

[93] Fix | Delete

} else {

[94] Fix | Delete

$updraftplus->log("UpdraftClone backup check-in made successfully.");

[95] Fix | Delete

}

[96] Fix | Delete

}

[97] Fix | Delete

}

[98] Fix | Delete

[99] Fix | Delete

$updraft_dir = $updraftplus->backups_dir_location();

[100] Fix | Delete

if (file_exists($updraft_dir.'/deleteflag-'.$updraftplus->nonce.'.txt')) {

[101] Fix | Delete

$updraftplus->log("User request for abort: backup job will be immediately halted");

[102] Fix | Delete

@unlink($updraft_dir.'/deleteflag-'.$updraftplus->nonce.'.txt');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged

[103] Fix | Delete

$updraftplus->backup_finish(true, true, true);

[104] Fix | Delete

die;

[105] Fix | Delete

}

[106] Fix | Delete

[107] Fix | Delete

if ($updraftplus->current_resumption >= 9 && false == $updraftplus->newresumption_scheduled) {

[108] Fix | Delete

$updraftplus->log("This is resumption ".$updraftplus->current_resumption.", but meaningful activity is still taking place; so a new one will be scheduled");

[109] Fix | Delete

// We just use max here to make sure we get a number at all

[110] Fix | Delete

$resume_interval = max($updraftplus->jobdata_get('resume_interval'), 75);

[111] Fix | Delete

// Don't consult the minimum here

[112] Fix | Delete

// if (!is_numeric($resume_interval) || $resume_interval<300) { $resume_interval = 300; }

[113] Fix | Delete

$schedule_for = time()+$resume_interval;

[114] Fix | Delete

$updraftplus->newresumption_scheduled = $schedule_for;

[115] Fix | Delete

wp_schedule_single_event($schedule_for, 'updraft_backup_resume', array($updraftplus->current_resumption + 1, $updraftplus->nonce));

[116] Fix | Delete

} else {

[117] Fix | Delete

self::reschedule_if_needed();

[118] Fix | Delete

}

[119] Fix | Delete

}

[120] Fix | Delete

[121] Fix | Delete

/**

[122] Fix | Delete

* Reschedule the next resumption for the specified amount of time in the future

[123] Fix | Delete

*

[124] Fix | Delete

* @uses wp_schedule_single_event()

[125] Fix | Delete

*

[126] Fix | Delete

* @param Integer $how_far_ahead - a number of seconds

[127] Fix | Delete

*/

[128] Fix | Delete

public static function reschedule($how_far_ahead) {

[129] Fix | Delete

[130] Fix | Delete

global $updraftplus;

[131] Fix | Delete

[132] Fix | Delete

// Reschedule - remove presently scheduled event

[133] Fix | Delete

$next_resumption = $updraftplus->current_resumption + 1;

[134] Fix | Delete

wp_clear_scheduled_hook('updraft_backup_resume', array($next_resumption, $updraftplus->nonce));

[135] Fix | Delete

// Add new event

[136] Fix | Delete

// This next line may be too cautious; but until 14-Aug-2014, it was 300.

[137] Fix | Delete

// Update 20-Mar-2015 - lowered from 180 to 120

[138] Fix | Delete

// Update 03-Aug-2018 - lowered from 120 to 100

[139] Fix | Delete

// Update 09-Oct-2020 - lowered from 100 to 60

[140] Fix | Delete

if ($how_far_ahead < 60) $how_far_ahead = 60;

[141] Fix | Delete

$schedule_for = time() + $how_far_ahead;

[142] Fix | Delete

$updraftplus->log("Rescheduling resumption $next_resumption: moving to $how_far_ahead seconds from now ($schedule_for)");

[143] Fix | Delete

wp_schedule_single_event($schedule_for, 'updraft_backup_resume', array($next_resumption, $updraftplus->nonce));

[144] Fix | Delete

$updraftplus->newresumption_scheduled = $schedule_for;

[145] Fix | Delete

}

[146] Fix | Delete

[147] Fix | Delete

/**

[148] Fix | Delete

* Terminate a backup run because other activity on the backup has been detected

[149] Fix | Delete

*

[150] Fix | Delete

* @uses die()

[151] Fix | Delete

*

[152] Fix | Delete

* @param String $file - Indicate the file whose recent modification is indicative of activity

[153] Fix | Delete

* @param Integer $time_now - The epoch time at which the detection took place

[154] Fix | Delete

* @param Integer $time_mod - The epoch time at which the file was modified

[155] Fix | Delete

* @param Boolean $increase_resumption - Whether or not to increase the resumption interval

[156] Fix | Delete

*/

[157] Fix | Delete

public static function terminate_due_to_activity($file, $time_now, $time_mod, $increase_resumption = true) {

[158] Fix | Delete

[159] Fix | Delete

global $updraftplus;

[160] Fix | Delete

[161] Fix | Delete

// We check-in, to avoid 'no check in last time!' detectors firing.

[162] Fix | Delete

self::record_still_alive();

[163] Fix | Delete

[164] Fix | Delete

// Log

[165] Fix | Delete

$file_size = file_exists($file) ? round(filesize($file)/1024, 1). 'KB' : 'n/a';

[166] Fix | Delete

$updraftplus->log("Terminate: ".basename($file)." exists with activity within the last 30 seconds (time_mod=$time_mod, time_now=$time_now, diff=".(floor($time_now-$time_mod)).", size=$file_size). This likely means that another UpdraftPlus run is at work; so we will exit.");

[167] Fix | Delete

[168] Fix | Delete

$increase_by = $increase_resumption ? 120 : 0;

[169] Fix | Delete

self::increase_resume_and_reschedule($increase_by, true);

[170] Fix | Delete

[171] Fix | Delete

// Die, unless there was a deliberate over-ride (for development purposes)

[172] Fix | Delete

if (!defined('UPDRAFTPLUS_ALLOW_RECENT_ACTIVITY') || !UPDRAFTPLUS_ALLOW_RECENT_ACTIVITY) die;

[173] Fix | Delete

}

[174] Fix | Delete

[175] Fix | Delete

/**

[176] Fix | Delete

* Increase the resumption interval and reschedule the next resumption

[177] Fix | Delete

*

[178] Fix | Delete

* @uses self::reschedule()

[179] Fix | Delete

*

[180] Fix | Delete

* @param Integer $howmuch - how much to add to the existing resumption interval

[181] Fix | Delete

* @param Boolean $due_to_overlap - setting this changes the strategy for calculating the next resumption; it indicates that the reason for an increase is because of recent activity detection

[182] Fix | Delete

*/

[183] Fix | Delete

private static function increase_resume_and_reschedule($howmuch = 120, $due_to_overlap = false) {

[184] Fix | Delete

[185] Fix | Delete

global $updraftplus;

[186] Fix | Delete

[187] Fix | Delete

$resume_interval = max((int) $updraftplus->jobdata_get('resume_interval'), (0 === $howmuch) ? 120 : 300);

[188] Fix | Delete

[189] Fix | Delete

if (empty($updraftplus->newresumption_scheduled) && $due_to_overlap) {

[190] Fix | Delete

$updraftplus->log('A new resumption will be scheduled to prevent the job ending');

[191] Fix | Delete

}

[192] Fix | Delete

[193] Fix | Delete

$new_resume = $resume_interval + $howmuch;

[194] Fix | Delete

// It may be that we're increasing for the second (or more) time during a run, and that we already know that the new value will be insufficient, and can be increased

[195] Fix | Delete

if ($updraftplus->opened_log_time > 100 && microtime(true)-$updraftplus->opened_log_time > $new_resume) {

[196] Fix | Delete

$new_resume = ceil(microtime(true)-$updraftplus->opened_log_time)+45;

[197] Fix | Delete

$howmuch = $new_resume-$resume_interval;

[198] Fix | Delete

}

[199] Fix | Delete

[200] Fix | Delete

// This used to be always $new_resume, until 14-Aug-2014. However, people who have very long-running processes can end up with very long times between resumptions as a result.

[201] Fix | Delete

// Actually, let's not try this yet. I think it is safe, but think there is a more conservative solution available.

[202] Fix | Delete

// $how_far_ahead = min($new_resume, 600);

[203] Fix | Delete

// Nov 2018 - scheduling the next resumption unnecessarily-far-in-the-future after an overlap is still occurring, so, we're adjusting this to have a maximum value in that particular case

[204] Fix | Delete

$how_far_ahead = $due_to_overlap ? min($new_resume, 900) : $new_resume;

[205] Fix | Delete

[206] Fix | Delete

// If it is very long-running, then that would normally be known soon.

[207] Fix | Delete

// If the interval is already 12 minutes or more, then try the next resumption 10 minutes from now (i.e. sooner than it would have been). Thus, we are guaranteed to get at least 24 minutes of processing in the first 34.

[208] Fix | Delete

if ($updraftplus->current_resumption <= 1 && $new_resume > 720) $how_far_ahead = 600;

[209] Fix | Delete

[210] Fix | Delete

if (!empty($updraftplus->newresumption_scheduled) || $due_to_overlap) self::reschedule($how_far_ahead);

[211] Fix | Delete

[212] Fix | Delete

$updraftplus->jobdata_set('resume_interval', $new_resume);

[213] Fix | Delete

[214] Fix | Delete

$updraftplus->log("To decrease the likelihood of overlaps, increasing resumption interval to: $resume_interval + $howmuch = $new_resume");

[215] Fix | Delete

}

[216] Fix | Delete

}

[217] Fix | Delete

[218] Fix | Delete