class-job-scheduler.php — UpdraftPlus: WP Backup & Migration Plugin 1.16.22

updraftplus / includes / class-job-scheduler.php

updraftplus / includes Last commit date

class-job-scheduler.php

211 lines

1	<?php
2
3	if (!defined('UPDRAFTPLUS_DIR')) die('No access.');
4
5	/**
6	* A class for scheduling-related code.
7	* 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.
8	*/
9	class UpdraftPlus_Job_Scheduler {
10
11	/**
12	* 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.
13	*/
14	public static function record_still_alive() {
15
16	global $updraftplus;
17
18	// Update the record of maximum detected runtime on each run
19	$time_passed = $updraftplus->jobdata_get('run_times');
20	if (!is_array($time_passed)) $time_passed = array();
21
22	$time_this_run = microtime(true)-$updraftplus->opened_log_time;
23	$time_passed[$updraftplus->current_resumption] = $time_this_run;
24	$updraftplus->jobdata_set('run_times', $time_passed);
25
26	$resume_interval = $updraftplus->jobdata_get('resume_interval');
27	if ($time_this_run + 30 > $resume_interval) {
28	$new_interval = ceil($time_this_run + 30);
29	set_site_transient('updraft_initial_resume_interval', (int) $new_interval, 8*86400);
30	$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");
31	$updraftplus->jobdata_set('resume_interval', $new_interval);
32	}
33
34	}
35
36	/**
37	* This method helps with efficient scheduling
38	*/
39	public static function reschedule_if_needed() {
40
41	global $updraftplus;
42
43	// If nothing is scheduled, then no re-scheduling is needed, so return
44	if (empty($updraftplus->newresumption_scheduled)) return;
45
46	$time_away = $updraftplus->newresumption_scheduled - time();
47
48	// 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)
49	if ($time_away > 1 && $time_away <= 45) {
50	$updraftplus->log('The scheduled resumption is within 45 seconds - will reschedule');
51	// Increase interval generally by 45 seconds, on the assumption that our prior estimates were innaccurate (i.e. not just 45 seconds this time)
52	self::increase_resume_and_reschedule(45);
53	}
54	}
55
56	/**
57	* Indicate that something useful happened. Calling this at appropriate times is an important part of scheduling decisions.
58	*/
59	public static function something_useful_happened() {
60
61	global $updraftplus;
62
63	self::record_still_alive();
64
65	if (!$updraftplus->something_useful_happened) {
66	$useful_checkin = $updraftplus->jobdata_get('useful_checkin');
67	if (empty($useful_checkin) \|\| $updraftplus->current_resumption > $useful_checkin) $updraftplus->jobdata_set('useful_checkin', $updraftplus->current_resumption);
68	}
69
70	$updraftplus->something_useful_happened = true;
71
72	$clone_job = $updraftplus->jobdata_get('clone_job');
73
74	if (!empty($clone_job)) {
75	static $last_call = false;
76
77	// Check we haven't yet made a call or that 15 minutes has passed before we make another call
78	if (!$last_call \|\| time() - $last_call > 900) {
79	$last_call = time();
80	$clone_id = $updraftplus->jobdata_get('clone_id');
81	$secret_token = $updraftplus->jobdata_get('secret_token');
82	$log_data = $updraftplus->get_last_log_chunk($updraftplus->file_nonce);
83	$log_contents = isset($log_data['log_contents']) ? $log_data['log_contents'] : '';
84	$first_byte = isset($log_data['first_byte']) ? $log_data['first_byte'] : 0;
85	$response = $updraftplus->get_updraftplus_clone()->clone_checkin(array('clone_id' => $clone_id, 'secret_token' => $secret_token, 'first_byte' => $first_byte, 'log_contents' => $log_contents));
86	if (!isset($response['status']) \|\| 'success' != $response['status']) {
87	$updraftplus->log("UpdraftClone backup check-in failed.");
88	} else {
89	$updraftplus->log("UpdraftClone backup check-in made successfully.");
90	}
91	}
92	}
93
94	$updraft_dir = $updraftplus->backups_dir_location();
95	if (file_exists($updraft_dir.'/deleteflag-'.$updraftplus->nonce.'.txt')) {
96	$updraftplus->log("User request for abort: backup job will be immediately halted");
97	@unlink($updraft_dir.'/deleteflag-'.$updraftplus->nonce.'.txt');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged
98	$updraftplus->backup_finish(true, true, true);
99	die;
100	}
101
102	if ($updraftplus->current_resumption >= 9 && false == $updraftplus->newresumption_scheduled) {
103	$updraftplus->log("This is resumption ".$updraftplus->current_resumption.", but meaningful activity is still taking place; so a new one will be scheduled");
104	// We just use max here to make sure we get a number at all
105	$resume_interval = max($updraftplus->jobdata_get('resume_interval'), 75);
106	// Don't consult the minimum here
107	// if (!is_numeric($resume_interval) \|\| $resume_interval<300) { $resume_interval = 300; }
108	$schedule_for = time()+$resume_interval;
109	$updraftplus->newresumption_scheduled = $schedule_for;
110	wp_schedule_single_event($schedule_for, 'updraft_backup_resume', array($updraftplus->current_resumption + 1, $updraftplus->nonce));
111	} else {
112	self::reschedule_if_needed();
113	}
114	}
115
116	/**
117	* Reschedule the next resumption for the specified amount of time in the future
118	*
119	* @uses wp_schedule_single_event()
120	*
121	* @param Integer $how_far_ahead - a number of seconds
122	*/
123	public static function reschedule($how_far_ahead) {
124
125	global $updraftplus;
126
127	// Reschedule - remove presently scheduled event
128	$next_resumption = $updraftplus->current_resumption + 1;
129	wp_clear_scheduled_hook('updraft_backup_resume', array($next_resumption, $updraftplus->nonce));
130	// Add new event
131	// This next line may be too cautious; but until 14-Aug-2014, it was 300.
132	// Update 20-Mar-2015 - lowered from 180 to 120
133	// Update 03-Aug-2018 - lowered from 120 to 100
134	if ($how_far_ahead < 100) $how_far_ahead = 100;
135	$schedule_for = time() + $how_far_ahead;
136	$updraftplus->log("Rescheduling resumption $next_resumption: moving to $how_far_ahead seconds from now ($schedule_for)");
137	wp_schedule_single_event($schedule_for, 'updraft_backup_resume', array($next_resumption, $updraftplus->nonce));
138	$updraftplus->newresumption_scheduled = $schedule_for;
139	}
140
141	/**
142	* Terminate a backup run because other activity on the backup has been detected
143	*
144	* @uses die()
145	*
146	* @param String $file - Indicate the file whose recent modification is indicative of activity
147	* @param Integer $time_now - The epoch time at which the detection took place
148	* @param Integer $time_mod - The epoch time at which the file was modified
149	* @param Boolean $increase_resumption - Whether or not to increase the resumption interval
150	*/
151	public static function terminate_due_to_activity($file, $time_now, $time_mod, $increase_resumption = true) {
152
153	global $updraftplus;
154
155	// We check-in, to avoid 'no check in last time!' detectors firing.
156	self::record_still_alive();
157
158	// Log
159	$file_size = file_exists($file) ? round(filesize($file)/1024, 1). 'KB' : 'n/a';
160	$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.");
161
162	$increase_by = $increase_resumption ? 120 : 0;
163	self::increase_resume_and_reschedule($increase_by, true);
164
165	// Die, unless there was a deliberate over-ride (for development purposes)
166	if (!defined('UPDRAFTPLUS_ALLOW_RECENT_ACTIVITY') \|\| !UPDRAFTPLUS_ALLOW_RECENT_ACTIVITY) die;
167	}
168
169	/**
170	* Increase the resumption interval and reschedule the next resumption
171	*
172	* @uses self::reschedule()
173	*
174	* @param Integer $howmuch - how much to add to the existing resumption interval
175	* @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
176	*/
177	private static function increase_resume_and_reschedule($howmuch = 120, $due_to_overlap = false) {
178
179	global $updraftplus;
180
181	$resume_interval = max(intval($updraftplus->jobdata_get('resume_interval')), (0 === $howmuch) ? 120 : 300);
182
183	if (empty($updraftplus->newresumption_scheduled) && $due_to_overlap) {
184	$updraftplus->log('A new resumption will be scheduled to prevent the job ending');
185	}
186
187	$new_resume = $resume_interval + $howmuch;
188	// 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
189	if ($updraftplus->opened_log_time > 100 && microtime(true)-$updraftplus->opened_log_time > $new_resume) {
190	$new_resume = ceil(microtime(true)-$updraftplus->opened_log_time)+45;
191	$howmuch = $new_resume-$resume_interval;
192	}
193
194	// 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.
195	// Actually, let's not try this yet. I think it is safe, but think there is a more conservative solution available.
196	// $how_far_ahead = min($new_resume, 600);
197	// 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
198	$how_far_ahead = $due_to_overlap ? min($new_resume, 900) : $new_resume;
199
200	// If it is very long-running, then that would normally be known soon.
201	// 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.
202	if ($updraftplus->current_resumption <= 1 && $new_resume > 720) $how_far_ahead = 600;
203
204	if (!empty($updraftplus->newresumption_scheduled) \|\| $due_to_overlap) self::reschedule($how_far_ahead);
205
206	$updraftplus->jobdata_set('resume_interval', $new_resume);
207
208	$updraftplus->log("To decrease the likelihood of overlaps, increasing resumption interval to: $resume_interval + $howmuch = $new_resume");
209	}
210	}
211