Completed
Push — update/story-block-loading-med... ( e6e62b...d81748 )
by
unknown
28:46 queued 18:45
created

Actions::do_initial_sync()   B

Complexity

Conditions 6
Paths 4

Size

Total Lines 25

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 6
nc 4
nop 0
dl 0
loc 25
rs 8.8977
c 0
b 0
f 0
1
<?php
2
/**
3
 * A class that defines syncable actions for Jetpack.
4
 *
5
 * @package automattic/jetpack-sync
6
 */
7
8
namespace Automattic\Jetpack\Sync;
9
10
use Automattic\Jetpack\Connection\Manager as Jetpack_Connection;
11
use Automattic\Jetpack\Constants;
12
use Automattic\Jetpack\Status;
13
use Automattic\Jetpack\Sync\Health;
14
use Automattic\Jetpack\Sync\Modules;
15
16
/**
17
 * The role of this class is to hook the Sync subsystem into WordPress - when to listen for actions,
18
 * when to send, when to perform a full sync, etc.
19
 *
20
 * It also binds the action to send data to WPCOM to Jetpack's XMLRPC client object.
21
 */
22
class Actions {
23
	/**
24
	 * A variable to hold a sync sender object.
25
	 *
26
	 * @access public
27
	 * @static
28
	 *
29
	 * @var Automattic\Jetpack\Sync\Sender
30
	 */
31
	public static $sender = null;
32
33
	/**
34
	 * A variable to hold a sync listener object.
35
	 *
36
	 * @access public
37
	 * @static
38
	 *
39
	 * @var Automattic\Jetpack\Sync\Listener
40
	 */
41
	public static $listener = null;
42
43
	/**
44
	 * Name of the sync cron schedule.
45
	 *
46
	 * @access public
47
	 *
48
	 * @var string
49
	 */
50
	const DEFAULT_SYNC_CRON_INTERVAL_NAME = 'jetpack_sync_interval';
51
52
	/**
53
	 * Interval between the last and the next sync cron action.
54
	 *
55
	 * @access public
56
	 *
57
	 * @var int
58
	 */
59
	const DEFAULT_SYNC_CRON_INTERVAL_VALUE = 300; // 5 * MINUTE_IN_SECONDS;
60
61
	/**
62
	 * Initialize Sync for cron jobs, set up listeners for WordPress Actions,
63
	 * and set up a shut-down action for sending actions to WordPress.com
64
	 *
65
	 * @access public
66
	 * @static
67
	 */
68
	public static function init() {
69
		// Everything below this point should only happen if we're a valid sync site.
70
		if ( ! self::sync_allowed() ) {
71
			return;
72
		}
73
74
		if ( self::sync_via_cron_allowed() ) {
75
			self::init_sync_cron_jobs();
76
		} elseif ( wp_next_scheduled( 'jetpack_sync_cron' ) ) {
77
			self::clear_sync_cron_jobs();
78
		}
79
		// When importing via cron, do not sync.
80
		add_action( 'wp_cron_importer_hook', array( __CLASS__, 'set_is_importing_true' ), 1 );
81
82
		// Sync connected user role changes to WordPress.com.
83
		Users::init();
84
85
		// Publicize filter to prevent publicizing blacklisted post types.
86
		add_filter( 'publicize_should_publicize_published_post', array( __CLASS__, 'prevent_publicize_blacklisted_posts' ), 10, 2 );
87
88
		/**
89
		 * Fires on every request before default loading sync listener code.
90
		 * Return false to not load sync listener code that monitors common
91
		 * WP actions to be serialized.
92
		 *
93
		 * By default this returns true for cron jobs, non-GET-requests, or requests where the
94
		 * user is logged-in.
95
		 *
96
		 * @since 4.2.0
97
		 *
98
		 * @param bool should we load sync listener code for this request
99
		 */
100
		if ( apply_filters( 'jetpack_sync_listener_should_load', true ) ) {
101
			self::initialize_listener();
102
		}
103
104
		add_action( 'init', array( __CLASS__, 'add_sender_shutdown' ), 90 );
105
	}
106
107
	/**
108
	 * Prepares sync to send actions on shutdown for the current request.
109
	 *
110
	 * @access public
111
	 * @static
112
	 */
113
	public static function add_sender_shutdown() {
114
		/**
115
		 * Fires on every request before default loading sync sender code.
116
		 * Return false to not load sync sender code that serializes pending
117
		 * data and sends it to WPCOM for processing.
118
		 *
119
		 * By default this returns true for cron jobs, POST requests, admin requests, or requests
120
		 * by users who can manage_options.
121
		 *
122
		 * @since 4.2.0
123
		 *
124
		 * @param bool should we load sync sender code for this request
125
		 */
126
		if ( apply_filters(
127
			'jetpack_sync_sender_should_load',
128
			self::should_initialize_sender()
129
		) ) {
130
			self::initialize_sender();
131
			add_action( 'shutdown', array( self::$sender, 'do_sync' ) );
132
			add_action( 'shutdown', array( self::$sender, 'do_full_sync' ), 9999 );
133
		}
134
	}
135
136
	/**
137
	 * Decides if the sender should run on shutdown for this request.
138
	 *
139
	 * @access public
140
	 * @static
141
	 *
142
	 * @return bool
143
	 */
144
	public static function should_initialize_sender() {
145
		if ( Constants::is_true( 'DOING_CRON' ) ) {
146
			return self::sync_via_cron_allowed();
147
		}
148
149
		if ( isset( $_SERVER['REQUEST_METHOD'] ) && 'POST' === $_SERVER['REQUEST_METHOD'] ) {
150
			return true;
151
		}
152
153
		if ( current_user_can( 'manage_options' ) ) {
154
			return true;
155
		}
156
157
		if ( is_admin() ) {
158
			return true;
159
		}
160
161
		if ( defined( 'PHPUNIT_JETPACK_TESTSUITE' ) ) {
162
			return true;
163
		}
164
165
		if ( Constants::get_constant( 'WP_CLI' ) ) {
166
			return true;
167
		}
168
169
		return false;
170
	}
171
172
	/**
173
	 * Decides if the sender should run on shutdown when actions are queued.
174
	 *
175
	 * @access public
176
	 * @static
177
	 *
178
	 * @return bool
179
	 */
180
	public static function should_initialize_sender_enqueue() {
181
		if ( Constants::is_true( 'DOING_CRON' ) ) {
182
			return self::sync_via_cron_allowed();
183
		}
184
185
		return true;
186
	}
187
188
	/**
189
	 * Decides if sync should run at all during this request.
190
	 *
191
	 * @access public
192
	 * @static
193
	 *
194
	 * @return bool
195
	 */
196
	public static function sync_allowed() {
197
		if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {
198
			return false;
199
		}
200
201
		if ( defined( 'PHPUNIT_JETPACK_TESTSUITE' ) ) {
202
			return true;
203
		}
204
205
		if ( ! Settings::is_sync_enabled() ) {
206
			return false;
207
		}
208
209
		if ( ( new Status() )->is_offline_mode() ) {
210
			return false;
211
		}
212
213
		if ( ( new Status() )->is_staging_site() ) {
214
			return false;
215
		}
216
217
		$connection = new Jetpack_Connection();
218
		if ( ! $connection->is_active() ) {
219
			if ( ! doing_action( 'jetpack_user_authorized' ) ) {
220
				return false;
221
			}
222
		}
223
224
		return true;
225
	}
226
227
	/**
228
	 * Determines if syncing during a cron job is allowed.
229
	 *
230
	 * @access public
231
	 * @static
232
	 *
233
	 * @return bool|int
234
	 */
235
	public static function sync_via_cron_allowed() {
236
		return ( Settings::get_setting( 'sync_via_cron' ) );
237
	}
238
239
	/**
240
	 * Decides if the given post should be Publicized based on its type.
241
	 *
242
	 * @access public
243
	 * @static
244
	 *
245
	 * @param bool     $should_publicize  Publicize status prior to this filter running.
246
	 * @param \WP_Post $post              The post to test for Publicizability.
247
	 * @return bool
248
	 */
249
	public static function prevent_publicize_blacklisted_posts( $should_publicize, $post ) {
250
		if ( in_array( $post->post_type, Settings::get_setting( 'post_types_blacklist' ), true ) ) {
251
			return false;
252
		}
253
254
		return $should_publicize;
255
	}
256
257
	/**
258
	 * Set an importing flag to `true` in sync settings.
259
	 *
260
	 * @access public
261
	 * @static
262
	 */
263
	public static function set_is_importing_true() {
264
		Settings::set_importing( true );
265
	}
266
267
	/**
268
	 * Sends data to WordPress.com via an XMLRPC request.
269
	 *
270
	 * @access public
271
	 * @static
272
	 *
273
	 * @param object $data                   Data relating to a sync action.
274
	 * @param string $codec_name             The name of the codec that encodes the data.
275
	 * @param float  $sent_timestamp         Current server time so we can compensate for clock differences.
276
	 * @param string $queue_id               The queue the action belongs to, sync or full_sync.
277
	 * @param float  $checkout_duration      Time spent retrieving queue items from the DB.
278
	 * @param float  $preprocess_duration    Time spent converting queue items into data to send.
279
	 * @param int    $queue_size             The size of the sync queue at the time of processing.
0 ignored issues
show
Documentation introduced by
Should the type for parameter $queue_size not be integer|null?

This check looks for @param annotations where the type inferred by our type inference engine differs from the declared type.

It makes a suggestion as to what type it considers more descriptive.

Most often this is a case of a parameter that can be null in addition to its declared types.

Loading history...
280
	 * @param string $buffer_id              The ID of the Queue buffer checked out for processing.
0 ignored issues
show
Documentation introduced by
Should the type for parameter $buffer_id not be string|null?

This check looks for @param annotations where the type inferred by our type inference engine differs from the declared type.

It makes a suggestion as to what type it considers more descriptive.

Most often this is a case of a parameter that can be null in addition to its declared types.

Loading history...
281
	 * @return Jetpack_Error|mixed|WP_Error  The result of the sending request.
282
	 */
283
	public static function send_data( $data, $codec_name, $sent_timestamp, $queue_id, $checkout_duration, $preprocess_duration, $queue_size = null, $buffer_id = null ) {
284
		$query_args = array(
285
			'sync'       => '1',             // Add an extra parameter to the URL so we can tell it's a sync action.
286
			'codec'      => $codec_name,
287
			'timestamp'  => $sent_timestamp,
288
			'queue'      => $queue_id,
289
			'home'       => Functions::home_url(),  // Send home url option to check for Identity Crisis server-side.
290
			'siteurl'    => Functions::site_url(),  // Send siteurl option to check for Identity Crisis server-side.
291
			'cd'         => sprintf( '%.4f', $checkout_duration ),
292
			'pd'         => sprintf( '%.4f', $preprocess_duration ),
293
			'queue_size' => $queue_size,
294
			'buffer_id'  => $buffer_id,
295
		);
296
297
		// Has the site opted in to IDC mitigation?
298
		if ( \Jetpack::sync_idc_optin() ) {
299
			$query_args['idc'] = true;
300
		}
301
302
		if ( \Jetpack_Options::get_option( 'migrate_for_idc', false ) ) {
303
			$query_args['migrate_for_idc'] = true;
304
		}
305
306
		$query_args['timeout'] = Settings::is_doing_cron() ? 30 : 15;
307
308
		/**
309
		 * Filters query parameters appended to the Sync request URL sent to WordPress.com.
310
		 *
311
		 * @since 4.7.0
312
		 *
313
		 * @param array $query_args associative array of query parameters.
314
		 */
315
		$query_args = apply_filters( 'jetpack_sync_send_data_query_args', $query_args );
316
317
		$connection = new Jetpack_Connection();
318
		$url        = add_query_arg( $query_args, $connection->xmlrpc_api_url() );
319
320
		// If we're currently updating to Jetpack 7.7, the IXR client may be missing briefly
321
		// because since 7.7 it's being autoloaded with Composer.
322
		if ( ! class_exists( '\\Jetpack_IXR_Client' ) ) {
323
			return new \WP_Error(
324
				'ixr_client_missing',
0 ignored issues
show
Unused Code introduced by
The call to WP_Error::__construct() has too many arguments starting with 'ixr_client_missing'.

This check compares calls to functions or methods with their respective definitions. If the call has more arguments than are defined, it raises an issue.

If a function is defined several times with a different number of parameters, the check may pick up the wrong definition and report false positives. One codebase where this has been known to happen is Wordpress.

In this case you can add the @ignore PhpDoc annotation to the duplicate definition and it will be ignored.

Loading history...
325
				esc_html__( 'Sync has been aborted because the IXR client is missing.', 'jetpack' )
326
			);
327
		}
328
329
		$rpc = new \Jetpack_IXR_Client(
330
			array(
331
				'url'     => $url,
332
				'timeout' => $query_args['timeout'],
333
			)
334
		);
335
336
		$result = $rpc->query( 'jetpack.syncActions', $data );
337
338
		if ( ! $result ) {
339
			return $rpc->get_jetpack_error();
340
		}
341
342
		$response = $rpc->getResponse();
343
344
		// Check if WordPress.com IDC mitigation blocked the sync request.
345
		if ( is_array( $response ) && isset( $response['error_code'] ) ) {
346
			$error_code              = $response['error_code'];
347
			$allowed_idc_error_codes = array(
348
				'jetpack_url_mismatch',
349
				'jetpack_home_url_mismatch',
350
				'jetpack_site_url_mismatch',
351
			);
352
353
			if ( in_array( $error_code, $allowed_idc_error_codes, true ) ) {
354
				\Jetpack_Options::update_option(
355
					'sync_error_idc',
356
					\Jetpack::get_sync_error_idc_option( $response )
357
				);
358
			}
359
360
			return new \WP_Error(
361
				'sync_error_idc',
0 ignored issues
show
Unused Code introduced by
The call to WP_Error::__construct() has too many arguments starting with 'sync_error_idc'.

This check compares calls to functions or methods with their respective definitions. If the call has more arguments than are defined, it raises an issue.

If a function is defined several times with a different number of parameters, the check may pick up the wrong definition and report false positives. One codebase where this has been known to happen is Wordpress.

In this case you can add the @ignore PhpDoc annotation to the duplicate definition and it will be ignored.

Loading history...
362
				esc_html__( 'Sync has been blocked from WordPress.com because it would cause an identity crisis', 'jetpack' )
363
			);
364
		}
365
366
		return $response;
367
	}
368
369
	/**
370
	 * Kicks off the initial sync.
371
	 *
372
	 * @access public
373
	 * @static
374
	 *
375
	 * @return bool|null False if sync is not allowed.
376
	 */
377
	public static function do_initial_sync() {
378
		// Lets not sync if we are not suppose to.
379
		if ( ! self::sync_allowed() ) {
380
			return false;
381
		}
382
383
		// Don't start new sync if a full sync is in process.
384
		$full_sync_module = Modules::get_module( 'full-sync' );
385
		if ( $full_sync_module && $full_sync_module->is_started() && ! $full_sync_module->is_finished() ) {
386
			return false;
387
		}
388
389
		$initial_sync_config = array(
390
			'options'   => true,
391
			'functions' => true,
392
			'constants' => true,
393
			'users'     => array( get_current_user_id() ),
394
		);
395
396
		if ( is_multisite() ) {
397
			$initial_sync_config['network_options'] = true;
398
		}
399
400
		self::do_full_sync( $initial_sync_config );
401
	}
402
403
	/**
404
	 * Kicks off a full sync.
405
	 *
406
	 * @access public
407
	 * @static
408
	 *
409
	 * @param array $modules  The sync modules should be included in this full sync. All will be included if null.
0 ignored issues
show
Documentation introduced by
Should the type for parameter $modules not be array|null?

This check looks for @param annotations where the type inferred by our type inference engine differs from the declared type.

It makes a suggestion as to what type it considers more descriptive.

Most often this is a case of a parameter that can be null in addition to its declared types.

Loading history...
410
	 * @return bool           True if full sync was successfully started.
411
	 */
412
	public static function do_full_sync( $modules = null ) {
413
		if ( ! self::sync_allowed() ) {
414
			return false;
415
		}
416
417
		$full_sync_module = Modules::get_module( 'full-sync' );
418
419
		if ( ! $full_sync_module ) {
420
			return false;
421
		}
422
423
		self::initialize_listener();
424
425
		$full_sync_module->start( $modules );
426
427
		return true;
428
	}
429
430
	/**
431
	 * Adds a cron schedule for regular syncing via cron, unless the schedule already exists.
432
	 *
433
	 * @access public
434
	 * @static
435
	 *
436
	 * @param array $schedules  The list of WordPress cron schedules prior to this filter.
437
	 * @return array            A list of WordPress cron schedules with the Jetpack sync interval added.
438
	 */
439
	public static function jetpack_cron_schedule( $schedules ) {
440
		if ( ! isset( $schedules[ self::DEFAULT_SYNC_CRON_INTERVAL_NAME ] ) ) {
441
			$minutes = intval( self::DEFAULT_SYNC_CRON_INTERVAL_VALUE / 60 );
442
			$display = ( 1 === $minutes ) ?
443
				__( 'Every minute', 'jetpack' ) :
444
				/* translators: %d is an integer indicating the number of minutes. */
445
				sprintf( __( 'Every %d minutes', 'jetpack' ), $minutes );
446
			$schedules[ self::DEFAULT_SYNC_CRON_INTERVAL_NAME ] = array(
447
				'interval' => self::DEFAULT_SYNC_CRON_INTERVAL_VALUE,
448
				'display'  => $display,
449
			);
450
		}
451
		return $schedules;
452
	}
453
454
	/**
455
	 * Starts an incremental sync via cron.
456
	 *
457
	 * @access public
458
	 * @static
459
	 */
460
	public static function do_cron_sync() {
461
		self::do_cron_sync_by_type( 'sync' );
462
	}
463
464
	/**
465
	 * Starts a full sync via cron.
466
	 *
467
	 * @access public
468
	 * @static
469
	 */
470
	public static function do_cron_full_sync() {
471
		self::do_cron_sync_by_type( 'full_sync' );
472
	}
473
474
	/**
475
	 * Try to send actions until we run out of things to send,
476
	 * or have to wait more than 15s before sending again,
477
	 * or we hit a lock or some other sending issue
478
	 *
479
	 * @access public
480
	 * @static
481
	 *
482
	 * @param string $type Sync type. Can be `sync` or `full_sync`.
483
	 */
484
	public static function do_cron_sync_by_type( $type ) {
485
		if ( ! self::sync_allowed() || ( 'sync' !== $type && 'full_sync' !== $type ) ) {
486
			return;
487
		}
488
489
		self::initialize_sender();
490
491
		$time_limit = Settings::get_setting( 'cron_sync_time_limit' );
492
		$start_time = time();
493
		$executions = 0;
494
495
		do {
496
			$next_sync_time = self::$sender->get_next_sync_time( $type );
497
498
			if ( $next_sync_time ) {
499
				$delay = $next_sync_time - time() + 1;
500
				if ( $delay > 15 ) {
501
					break;
502
				} elseif ( $delay > 0 ) {
503
					sleep( $delay );
504
				}
505
			}
506
507
			// Explicitly only allow 1 do_full_sync call until issue with Immediate Full Sync is resolved.
508
			// For more context see p1HpG7-9pe-p2.
509
			if ( 'full_sync' === $type && $executions >= 1 ) {
510
				break;
511
			}
512
513
			$result = 'full_sync' === $type ? self::$sender->do_full_sync() : self::$sender->do_sync();
514
515
			// # of send actions performed.
516
			$executions ++;
517
518
		} while ( $result && ! is_wp_error( $result ) && ( $start_time + $time_limit ) > time() );
519
520
		return $executions;
521
	}
522
523
	/**
524
	 * Initialize the sync listener.
525
	 *
526
	 * @access public
527
	 * @static
528
	 */
529
	public static function initialize_listener() {
530
		self::$listener = Listener::get_instance();
0 ignored issues
show
Documentation Bug introduced by
It seems like \Automattic\Jetpack\Sync\Listener::get_instance() of type object<Automattic\Jetpack\Sync\Listener> is incompatible with the declared type object<Automattic\Jetpac...\Jetpack\Sync\Listener> of property $listener.

Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property.

Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property..

Loading history...
531
	}
532
533
	/**
534
	 * Initializes the sync sender.
535
	 *
536
	 * @access public
537
	 * @static
538
	 */
539
	public static function initialize_sender() {
540
		self::$sender = Sender::get_instance();
0 ignored issues
show
Documentation Bug introduced by
It seems like \Automattic\Jetpack\Sync\Sender::get_instance() of type object<Automattic\Jetpack\Sync\Sender> is incompatible with the declared type object<Automattic\Jetpac...ic\Jetpack\Sync\Sender> of property $sender.

Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property.

Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property..

Loading history...
541
		add_filter( 'jetpack_sync_send_data', array( __CLASS__, 'send_data' ), 10, 8 );
542
	}
543
544
	/**
545
	 * Initializes sync for WooCommerce.
546
	 *
547
	 * @access public
548
	 * @static
549
	 */
550
	public static function initialize_woocommerce() {
551
		if ( false === class_exists( 'WooCommerce' ) ) {
552
			return;
553
		}
554
		add_filter( 'jetpack_sync_modules', array( __CLASS__, 'add_woocommerce_sync_module' ) );
555
	}
556
557
	/**
558
	 * Adds Woo's sync modules to existing modules for sending.
559
	 *
560
	 * @access public
561
	 * @static
562
	 *
563
	 * @param array $sync_modules The list of sync modules declared prior to this filter.
564
	 * @return array A list of sync modules that now includes Woo's modules.
565
	 */
566
	public static function add_woocommerce_sync_module( $sync_modules ) {
567
		$sync_modules[] = 'Automattic\\Jetpack\\Sync\\Modules\\WooCommerce';
568
		return $sync_modules;
569
	}
570
571
	/**
572
	 * Initializes sync for WP Super Cache.
573
	 *
574
	 * @access public
575
	 * @static
576
	 */
577
	public static function initialize_wp_super_cache() {
578
		if ( false === function_exists( 'wp_cache_is_enabled' ) ) {
579
			return;
580
		}
581
		add_filter( 'jetpack_sync_modules', array( __CLASS__, 'add_wp_super_cache_sync_module' ) );
582
	}
583
584
	/**
585
	 * Adds WP Super Cache's sync modules to existing modules for sending.
586
	 *
587
	 * @access public
588
	 * @static
589
	 *
590
	 * @param array $sync_modules The list of sync modules declared prior to this filer.
591
	 * @return array A list of sync modules that now includes WP Super Cache's modules.
592
	 */
593
	public static function add_wp_super_cache_sync_module( $sync_modules ) {
594
		$sync_modules[] = 'Automattic\\Jetpack\\Sync\\Modules\\WP_Super_Cache';
595
		return $sync_modules;
596
	}
597
598
	/**
599
	 * Sanitizes the name of sync's cron schedule.
600
	 *
601
	 * @access public
602
	 * @static
603
	 *
604
	 * @param string $schedule The name of a WordPress cron schedule.
605
	 * @return string The sanitized name of sync's cron schedule.
606
	 */
607
	public static function sanitize_filtered_sync_cron_schedule( $schedule ) {
608
		$schedule  = sanitize_key( $schedule );
609
		$schedules = wp_get_schedules();
610
611
		// Make sure that the schedule has actually been registered using the `cron_intervals` filter.
612
		if ( isset( $schedules[ $schedule ] ) ) {
613
			return $schedule;
614
		}
615
616
		return self::DEFAULT_SYNC_CRON_INTERVAL_NAME;
617
	}
618
619
	/**
620
	 * Allows offsetting of start times for sync cron jobs.
621
	 *
622
	 * @access public
623
	 * @static
624
	 *
625
	 * @param string $schedule The name of a cron schedule.
626
	 * @param string $hook     The hook that this method is responding to.
627
	 * @return int The offset for the sync cron schedule.
628
	 */
629
	public static function get_start_time_offset( $schedule = '', $hook = '' ) {
630
		$start_time_offset = is_multisite()
631
			? wp_rand( 0, ( 2 * self::DEFAULT_SYNC_CRON_INTERVAL_VALUE ) )
632
			: 0;
633
634
		/**
635
		 * Allows overriding the offset that the sync cron jobs will first run. This can be useful when scheduling
636
		 * cron jobs across multiple sites in a network.
637
		 *
638
		 * @since 4.5.0
639
		 *
640
		 * @param int    $start_time_offset
641
		 * @param string $hook
642
		 * @param string $schedule
643
		 */
644
		return intval(
645
			apply_filters(
646
				'jetpack_sync_cron_start_time_offset',
647
				$start_time_offset,
648
				$hook,
0 ignored issues
show
Unused Code introduced by
The call to apply_filters() has too many arguments starting with $hook.

This check compares calls to functions or methods with their respective definitions. If the call has more arguments than are defined, it raises an issue.

If a function is defined several times with a different number of parameters, the check may pick up the wrong definition and report false positives. One codebase where this has been known to happen is Wordpress.

In this case you can add the @ignore PhpDoc annotation to the duplicate definition and it will be ignored.

Loading history...
649
				$schedule
650
			)
651
		);
652
	}
653
654
	/**
655
	 * Decides if a sync cron should be scheduled.
656
	 *
657
	 * @access public
658
	 * @static
659
	 *
660
	 * @param string $schedule The name of a cron schedule.
661
	 * @param string $hook     The hook that this method is responding to.
662
	 */
663
	public static function maybe_schedule_sync_cron( $schedule, $hook ) {
664
		if ( ! $hook ) {
665
			return;
666
		}
667
		$schedule = self::sanitize_filtered_sync_cron_schedule( $schedule );
668
669
		$start_time = time() + self::get_start_time_offset( $schedule, $hook );
670
		if ( ! wp_next_scheduled( $hook ) ) {
671
			// Schedule a job to send pending queue items once a minute.
672
			wp_schedule_event( $start_time, $schedule, $hook );
673
		} elseif ( wp_get_schedule( $hook ) !== $schedule ) {
674
			// If the schedule has changed, update the schedule.
675
			wp_clear_scheduled_hook( $hook );
676
			wp_schedule_event( $start_time, $schedule, $hook );
677
		}
678
	}
679
680
	/**
681
	 * Clears Jetpack sync cron jobs.
682
	 *
683
	 * @access public
684
	 * @static
685
	 */
686
	public static function clear_sync_cron_jobs() {
687
		wp_clear_scheduled_hook( 'jetpack_sync_cron' );
688
		wp_clear_scheduled_hook( 'jetpack_sync_full_cron' );
689
	}
690
691
	/**
692
	 * Initializes Jetpack sync cron jobs.
693
	 *
694
	 * @access public
695
	 * @static
696
	 */
697
	public static function init_sync_cron_jobs() {
698
		add_filter( 'cron_schedules', array( __CLASS__, 'jetpack_cron_schedule' ) ); // phpcs:ignore WordPress.WP.CronInterval.ChangeDetected
699
700
		add_action( 'jetpack_sync_cron', array( __CLASS__, 'do_cron_sync' ) );
701
		add_action( 'jetpack_sync_full_cron', array( __CLASS__, 'do_cron_full_sync' ) );
702
703
		/**
704
		 * Allows overriding of the default incremental sync cron schedule which defaults to once every 5 minutes.
705
		 *
706
		 * @since 4.3.2
707
		 *
708
		 * @param string self::DEFAULT_SYNC_CRON_INTERVAL_NAME
709
		 */
710
		$incremental_sync_cron_schedule = apply_filters( 'jetpack_sync_incremental_sync_interval', self::DEFAULT_SYNC_CRON_INTERVAL_NAME );
711
		self::maybe_schedule_sync_cron( $incremental_sync_cron_schedule, 'jetpack_sync_cron' );
712
713
		/**
714
		 * Allows overriding of the full sync cron schedule which defaults to once every 5 minutes.
715
		 *
716
		 * @since 4.3.2
717
		 *
718
		 * @param string self::DEFAULT_SYNC_CRON_INTERVAL_NAME
719
		 */
720
		$full_sync_cron_schedule = apply_filters( 'jetpack_sync_full_sync_interval', self::DEFAULT_SYNC_CRON_INTERVAL_NAME );
721
		self::maybe_schedule_sync_cron( $full_sync_cron_schedule, 'jetpack_sync_full_cron' );
722
	}
723
724
	/**
725
	 * Perform maintenance when a plugin upgrade occurs.
726
	 *
727
	 * @access public
728
	 * @static
729
	 *
730
	 * @param string $new_version New version of the plugin.
0 ignored issues
show
Documentation introduced by
Should the type for parameter $new_version not be string|null?

This check looks for @param annotations where the type inferred by our type inference engine differs from the declared type.

It makes a suggestion as to what type it considers more descriptive.

Most often this is a case of a parameter that can be null in addition to its declared types.

Loading history...
731
	 * @param string $old_version Old version of the plugin.
0 ignored issues
show
Documentation introduced by
Should the type for parameter $old_version not be string|null?

This check looks for @param annotations where the type inferred by our type inference engine differs from the declared type.

It makes a suggestion as to what type it considers more descriptive.

Most often this is a case of a parameter that can be null in addition to its declared types.

Loading history...
732
	 */
733
	public static function cleanup_on_upgrade( $new_version = null, $old_version = null ) {
734
		if ( wp_next_scheduled( 'jetpack_sync_send_db_checksum' ) ) {
735
			wp_clear_scheduled_hook( 'jetpack_sync_send_db_checksum' );
736
		}
737
738
		$is_new_sync_upgrade = version_compare( $old_version, '4.2', '>=' );
739
		if ( ! empty( $old_version ) && $is_new_sync_upgrade && version_compare( $old_version, '4.5', '<' ) ) {
740
			self::clear_sync_cron_jobs();
741
			Settings::update_settings(
742
				array(
743
					'render_filtered_content' => Defaults::$default_render_filtered_content,
744
				)
745
			);
746
		}
747
748
		Health::on_jetpack_upgraded();
749
	}
750
751
	/**
752
	 * Get syncing status for the given fields.
753
	 *
754
	 * @access public
755
	 * @static
756
	 *
757
	 * @param string|null $fields A comma-separated string of the fields to include in the array from the JSON response.
758
	 * @return array An associative array with the status report.
759
	 */
760
	public static function get_sync_status( $fields = null ) {
761
		self::initialize_sender();
762
763
		$sync_module = Modules::get_module( 'full-sync' );
764
		$queue       = self::$sender->get_sync_queue();
765
766
		// _get_cron_array can be false
767
		$cron_timestamps = ( _get_cron_array() ) ? array_keys( _get_cron_array() ) : array();
768
		$next_cron       = ( ! empty( $cron_timestamps ) ) ? $cron_timestamps[0] - time() : '';
769
770
		$checksums = array();
771
772
		if ( ! empty( $fields ) ) {
773
			$store         = new Replicastore();
774
			$fields_params = array_map( 'trim', explode( ',', $fields ) );
775
776
			if ( in_array( 'posts_checksum', $fields_params, true ) ) {
777
				$checksums['posts_checksum'] = $store->posts_checksum();
778
			}
779
			if ( in_array( 'comments_checksum', $fields_params, true ) ) {
780
				$checksums['comments_checksum'] = $store->comments_checksum();
781
			}
782
			if ( in_array( 'post_meta_checksum', $fields_params, true ) ) {
783
				$checksums['post_meta_checksum'] = $store->post_meta_checksum();
784
			}
785
			if ( in_array( 'comment_meta_checksum', $fields_params, true ) ) {
786
				$checksums['comment_meta_checksum'] = $store->comment_meta_checksum();
787
			}
788
		}
789
790
		$full_sync_status = ( $sync_module ) ? $sync_module->get_status() : array();
791
792
		$full_queue = self::$sender->get_full_sync_queue();
793
794
		$result = array_merge(
795
			$full_sync_status,
796
			$checksums,
797
			array(
798
				'cron_size'            => count( $cron_timestamps ),
799
				'next_cron'            => $next_cron,
800
				'queue_size'           => $queue->size(),
801
				'queue_lag'            => $queue->lag(),
802
				'queue_next_sync'      => ( self::$sender->get_next_sync_time( 'sync' ) - microtime( true ) ),
803
				'full_queue_next_sync' => ( self::$sender->get_next_sync_time( 'full_sync' ) - microtime( true ) ),
804
			)
805
		);
806
807
		// Verify $sync_module is not false.
808
		if ( ( $sync_module ) && false === strpos( get_class( $sync_module ), 'Full_Sync_Immediately' ) ) {
809
			$result['full_queue_size'] = $full_queue->size();
810
			$result['full_queue_lag']  = $full_queue->lag();
811
		}
812
		return $result;
813
	}
814
}
815