Completed
Push — update/sync-endpoints ( ab68b2 )
by
unknown
11:27
created

Jetpack_Sync_Actions   C

Complexity

Total Complexity 73

Size/Duplication

Total Lines 426
Duplicated Lines 0 %

Coupling/Cohesion

Components 2
Dependencies 9

Importance

Changes 0
Metric Value
dl 0
loc 426
rs 5.5447
c 0
b 0
f 0
wmc 73
lcom 2
cbo 9

26 Methods

Rating   Name   Duplication   Size   Complexity  
A initialize_listener() 0 4 1
A initialize_sender() 0 7 1
B init() 0 44 5
B add_sender_shutdown() 0 29 6
B sync_allowed() 0 5 5
A sync_via_cron_allowed() 0 4 1
A prevent_publicize_blacklisted_posts() 0 8 2
A set_is_importing_true() 0 4 1
A add_wp_super_cache_sync_module() 0 5 1
A sanitize_filtered_sync_cron_schedule() 0 11 2
A get_start_time_offset() 0 22 2
A maybe_schedule_sync_cron() 0 16 4
A clear_sync_cron_jobs() 0 4 1
B init_sync_cron_jobs() 0 26 1
B cleanup_on_upgrade() 0 14 5
C send_data() 0 75 8
A do_initial_sync() 0 15 3
A do_full_sync() 0 10 2
A jetpack_cron_schedule() 0 12 2
A do_cron_sync() 0 3 1
A do_cron_full_sync() 0 3 1
C do_cron_sync_by_type() 0 25 11
A initialize_woocommerce() 0 6 2
A add_woocommerce_sync_module() 0 5 1
A initialize_wp_super_cache() 0 6 2
B get_sync_status() 0 24 2

How to fix   Complexity   

Complex Class

Complex classes like Jetpack_Sync_Actions often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.

Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.

While breaking up the class, it is a good idea to analyze how other classes use Jetpack_Sync_Actions, and based on these observations, apply Extract Interface, too.

1
<?php
2
3
/**
4
 * The role of this class is to hook the Sync subsystem into WordPress - when to listen for actions,
5
 * when to send, when to perform a full sync, etc.
6
 *
7
 * It also binds the action to send data to WPCOM to Jetpack's XMLRPC client object.
8
 */
9
class Jetpack_Sync_Actions {
10
	static $sender = null;
0 ignored issues
show
Coding Style introduced by
The visibility should be declared for property $sender.

The PSR-2 coding standard requires that all properties in a class have their visibility explicitly declared. If you declare a property using

class A {
    var $property;
}

the property is implicitly global.

To learn more about the PSR-2, please see the PHP-FIG site on the PSR-2.

Loading history...
11
	static $listener = null;
0 ignored issues
show
Coding Style introduced by
The visibility should be declared for property $listener.

The PSR-2 coding standard requires that all properties in a class have their visibility explicitly declared. If you declare a property using

class A {
    var $property;
}

the property is implicitly global.

To learn more about the PSR-2, please see the PHP-FIG site on the PSR-2.

Loading history...
12
	const DEFAULT_SYNC_CRON_INTERVAL_NAME = 'jetpack_sync_interval';
13
	const DEFAULT_SYNC_CRON_INTERVAL_VALUE = 300; // 5 * MINUTE_IN_SECONDS;
14
15
	static function init() {
16
17
		// everything below this point should only happen if we're a valid sync site
18
		if ( ! self::sync_allowed() ) {
19
			return;
20
		}
21
22
		if ( self::sync_via_cron_allowed() ) {
23
			self::init_sync_cron_jobs();
24
		} else if ( wp_next_scheduled( 'jetpack_sync_cron' ) ) {
25
			self::clear_sync_cron_jobs();
26
		}
27
28
		// On jetpack authorization, schedule a full sync
29
		add_action( 'jetpack_client_authorized', array( __CLASS__, 'do_full_sync' ), 10, 0 );
30
31
		// When importing via cron, do not sync
32
		add_action( 'wp_cron_importer_hook', array( __CLASS__, 'set_is_importing_true' ), 1 );
33
34
		// Sync connected user role changes to .com
35
		require_once dirname( __FILE__ ) . '/class.jetpack-sync-users.php';
36
37
		// publicize filter to prevent publicizing blacklisted post types
38
		add_filter( 'publicize_should_publicize_published_post', array( __CLASS__, 'prevent_publicize_blacklisted_posts' ), 10, 2 );
39
40
		/**
41
		 * Fires on every request before default loading sync listener code.
42
		 * Return false to not load sync listener code that monitors common
43
		 * WP actions to be serialized.
44
		 *
45
		 * By default this returns true for cron jobs, non-GET-requests, or requests where the
46
		 * user is logged-in.
47
		 *
48
		 * @since 4.2.0
49
		 *
50
		 * @param bool should we load sync listener code for this request
51
		 */
52
		if ( apply_filters( 'jetpack_sync_listener_should_load', true ) ) {
53
			self::initialize_listener();
54
		}
55
56
		add_action( 'init', array( __CLASS__, 'add_sender_shutdown' ), 90 );
57
58
	}
59
60
	static function add_sender_shutdown() {
61
		/**
62
		 * Fires on every request before default loading sync sender code.
63
		 * Return false to not load sync sender code that serializes pending
64
		 * data and sends it to WPCOM for processing.
65
		 *
66
		 * By default this returns true for cron jobs, POST requests, admin requests, or requests
67
		 * by users who can manage_options.
68
		 *
69
		 * @since 4.2.0
70
		 *
71
		 * @param bool should we load sync sender code for this request
72
		 */
73
		if ( apply_filters( 'jetpack_sync_sender_should_load',
74
			(
75
				( isset( $_SERVER["REQUEST_METHOD"] ) && 'POST' === $_SERVER['REQUEST_METHOD'] )
76
				||
77
				current_user_can( 'manage_options' )
78
				||
79
				is_admin()
80
				||
81
				defined( 'PHPUNIT_JETPACK_TESTSUITE' )
82
			)
83
		) ) {
84
			self::initialize_sender();
85
			add_action( 'shutdown', array( self::$sender, 'do_sync' ) );
86
			add_action( 'shutdown', array( self::$sender, 'do_full_sync' ) );
87
		}
88
	}
89
90
	static function sync_allowed() {
91
		require_once dirname( __FILE__ ) . '/class.jetpack-sync-settings.php';
92
		return ( ! Jetpack_Sync_Settings::get_setting( 'disable' ) && Jetpack::is_active() && ! ( Jetpack::is_development_mode() || Jetpack::is_staging_site() ) )
93
			   || defined( 'PHPUNIT_JETPACK_TESTSUITE' );
94
	}
95
96
	static function sync_via_cron_allowed() {
97
		require_once dirname( __FILE__ ) . '/class.jetpack-sync-settings.php';
98
		return ( Jetpack_Sync_Settings::get_setting( 'sync_via_cron' ) );
99
	}
100
101
	static function prevent_publicize_blacklisted_posts( $should_publicize, $post ) {
102
		require_once dirname( __FILE__ ) . '/class.jetpack-sync-settings.php';
103
		if ( in_array( $post->post_type, Jetpack_Sync_Settings::get_setting( 'post_types_blacklist' ) ) ) {
104
			return false;
105
		}
106
107
		return $should_publicize;
108
	}
109
110
	static function set_is_importing_true() {
111
		require_once dirname( __FILE__ ) . '/class.jetpack-sync-settings.php';
112
		Jetpack_Sync_Settings::set_importing( true );
113
	}
114
115
	static function send_data( $data, $codec_name, $sent_timestamp, $queue_id, $checkout_duration, $preprocess_duration ) {
116
		require_once dirname( __FILE__ ) . '/class.jetpack-sync-functions.php';
117
		Jetpack::load_xml_rpc_client();
118
119
		$query_args = array(
120
			'sync'      => '1',             // add an extra parameter to the URL so we can tell it's a sync action
121
			'codec'     => $codec_name,     // send the name of the codec used to encode the data
122
			'timestamp' => $sent_timestamp, // send current server time so we can compensate for clock differences
123
			'queue'     => $queue_id,       // sync or full_sync
124
			'home'      => Jetpack_Sync_Functions::home_url(),  // Send home url option to check for Identity Crisis server-side
125
			'siteurl'   => Jetpack_Sync_Functions::site_url(),  // Send siteurl option to check for Identity Crisis server-side
126
			'cd'        => sprintf( '%.4f', $checkout_duration),   // Time spent retrieving queue items from the DB
127
			'pd'        => sprintf( '%.4f', $preprocess_duration), // Time spent converting queue items into data to send
128
		);
129
130
		// Has the site opted in to IDC mitigation?
131
		if ( Jetpack::sync_idc_optin() ) {
132
			$query_args['idc'] = true;
133
		}
134
135
		if ( Jetpack_Options::get_option( 'migrate_for_idc', false ) ) {
136
			$query_args['migrate_for_idc'] = true;
137
		}
138
139
		$query_args['timeout'] = Jetpack_Sync_Settings::is_doing_cron() ? 30 : 15;
140
141
		/**
142
		 * Filters query parameters appended to the Sync request URL sent to WordPress.com.
143
		 *
144
		 * @since 4.7.0
145
		 *
146
		 * @param array $query_args associative array of query parameters.
147
		 */
148
		$query_args = apply_filters( 'jetpack_sync_send_data_query_args', $query_args );
149
150
		$url = add_query_arg( $query_args, Jetpack::xmlrpc_api_url() );
151
152
		$rpc = new Jetpack_IXR_Client( array(
153
			'url'     => $url,
154
			'user_id' => JETPACK_MASTER_USER,
155
			'timeout' => $query_args['timeout'],
156
		) );
157
158
		$result = $rpc->query( 'jetpack.syncActions', $data );
159
160
		if ( ! $result ) {
161
			return $rpc->get_jetpack_error();
162
		}
163
164
		$response = $rpc->getResponse();
165
166
		// Check if WordPress.com IDC mitigation blocked the sync request
167
		if ( is_array( $response ) && isset( $response['error_code'] ) ) {
168
			$error_code = $response['error_code'];
169
			$allowed_idc_error_codes = array(
170
				'jetpack_url_mismatch',
171
				'jetpack_home_url_mismatch',
172
				'jetpack_site_url_mismatch'
173
			);
174
175
			if ( in_array( $error_code, $allowed_idc_error_codes ) ) {
176
				Jetpack_Options::update_option(
177
					'sync_error_idc',
178
					Jetpack::get_sync_error_idc_option( $response )
179
				);
180
			}
181
182
			return new WP_Error(
183
				'sync_error_idc',
184
				esc_html__( 'Sync has been blocked from WordPress.com because it would cause an identity crisis', 'jetpack' )
185
			);
186
		}
187
188
		return $response;
189
	}
190
191
	static function do_initial_sync( $new_version = null, $old_version = null ) {
192
		if ( ! empty( $old_version ) && version_compare( $old_version, '4.2', '>=' ) ) {
193
			return;
194
		}
195
196
		$initial_sync_config = array(
197
			'options'         => true,
198
			'network_options' => true,
199
			'functions'       => true,
200
			'constants'       => true,
201
			'users'           => 'initial',
202
		);
203
204
		self::do_full_sync( $initial_sync_config );
205
	}
206
207
	static function do_full_sync( $modules = null ) {
208
		if ( ! self::sync_allowed() ) {
209
			return false;
210
		}
211
212
		self::initialize_listener();
213
		Jetpack_Sync_Modules::get_module( 'full-sync' )->start( $modules );
214
215
		return true;
216
	}
217
218
	static function jetpack_cron_schedule( $schedules ) {
219
		if ( ! isset( $schedules[ self::DEFAULT_SYNC_CRON_INTERVAL_NAME ] ) ) {
220
			$schedules[ self::DEFAULT_SYNC_CRON_INTERVAL_NAME ] = array(
221
				'interval' => self::DEFAULT_SYNC_CRON_INTERVAL_VALUE,
222
				'display' => sprintf(
223
					esc_html( _n( 'Every minute', 'Every %d minutes', intval( self::DEFAULT_SYNC_CRON_INTERVAL_VALUE / 60 ), 'jetpack' ) ),
224
					intval( self::DEFAULT_SYNC_CRON_INTERVAL_VALUE / 60 )
225
				)
226
			);
227
		}
228
		return $schedules;
229
	}
230
231
	static function do_cron_sync() {
232
		self::do_cron_sync_by_type( 'sync' );
233
	}
234
235
	static function do_cron_full_sync() {
236
		self::do_cron_sync_by_type( 'full_sync' );
237
	}
238
239
	/**
240
	 * Try to send actions until we run out of things to send,
241
	 * or have to wait more than 15s before sending again,
242
	 * or we hit a lock or some other sending issue
243
	 *
244
	 * @param string $type Sync type. Can be `sync` or `full_sync`.
245
	 */
246
	static function do_cron_sync_by_type( $type ) {
247
		if ( ! self::sync_allowed() || ( 'sync' !== $type && 'full_sync' !== $type ) ) {
248
			return;
249
		}
250
251
		self::initialize_sender();
252
253
		$time_limit = Jetpack_Sync_Settings::get_setting( 'cron_sync_time_limit' );
254
		$start_time = time();
255
256
		do {
257
			$next_sync_time = self::$sender->get_next_sync_time( $type );
258
259
			if ( $next_sync_time ) {
260
				$delay = $next_sync_time - time() + 1;
261
				if ( $delay > 15 ) {
262
					break;
263
				} elseif ( $delay > 0 ) {
264
					sleep( $delay );
265
				}
266
			}
267
268
			$result = 'full_sync' === $type ? self::$sender->do_full_sync() : self::$sender->do_sync();
269
		} while ( $result && ! is_wp_error( $result ) && ( $start_time + $time_limit ) > time() );
270
	}
271
272
	static function initialize_listener() {
273
		require_once dirname( __FILE__ ) . '/class.jetpack-sync-listener.php';
274
		self::$listener = Jetpack_Sync_Listener::get_instance();
275
	}
276
277
	static function initialize_sender() {
278
		require_once dirname( __FILE__ ) . '/class.jetpack-sync-sender.php';
279
		self::$sender = Jetpack_Sync_Sender::get_instance();
280
281
		// bind the sending process
282
		add_filter( 'jetpack_sync_send_data', array( __CLASS__, 'send_data' ), 10, 6 );
283
	}
284
285
	static function initialize_woocommerce() {
286
		if ( false === class_exists( 'WooCommerce' ) ) {
287
			return;
288
		}
289
		add_filter( 'jetpack_sync_modules', array( 'Jetpack_Sync_Actions', 'add_woocommerce_sync_module' ) );
290
	}
291
292
	static function add_woocommerce_sync_module( $sync_modules ) {
293
		require_once dirname( __FILE__ ) . '/class.jetpack-sync-module-woocommerce.php';
294
		$sync_modules[] = 'Jetpack_Sync_Module_WooCommerce';
295
		return $sync_modules;
296
	}
297
298
	static function initialize_wp_super_cache() {
299
		if ( false === function_exists( 'wp_cache_is_enabled' ) ) {
300
			return;
301
		}
302
		add_filter( 'jetpack_sync_modules', array( 'Jetpack_Sync_Actions', 'add_wp_super_cache_sync_module' ) );
303
	}
304
305
	static function add_wp_super_cache_sync_module( $sync_modules ) {
306
		require_once dirname( __FILE__ ) . '/class.jetpack-sync-module-wp-super-cache.php';
307
		$sync_modules[] = 'Jetpack_Sync_Module_WP_Super_Cache';
308
		return $sync_modules;
309
	}
310
311
	static function sanitize_filtered_sync_cron_schedule( $schedule ) {
312
		$schedule = sanitize_key( $schedule );
313
		$schedules = wp_get_schedules();
314
315
		// Make sure that the schedule has actually been registered using the `cron_intervals` filter.
316
		if ( isset( $schedules[ $schedule ] ) ) {
317
			return $schedule;
318
		}
319
320
		return self::DEFAULT_SYNC_CRON_INTERVAL_NAME;
321
	}
322
323
	static function get_start_time_offset( $schedule = '', $hook = '' ) {
324
		$start_time_offset =  is_multisite()
325
			? mt_rand( 0, ( 2 * self::DEFAULT_SYNC_CRON_INTERVAL_VALUE ) )
326
			: 0;
327
328
		/**
329
		 * Allows overriding the offset that the sync cron jobs will first run. This can be useful when scheduling
330
		 * cron jobs across multiple sites in a network.
331
		 *
332
		 * @since 4.5
333
		 *
334
		 * @param int    $start_time_offset
335
		 * @param string $hook
336
		 * @param string $schedule
337
		 */
338
		return intval( apply_filters(
339
			'jetpack_sync_cron_start_time_offset',
340
			$start_time_offset,
341
			$hook,
342
			$schedule
343
		) );
344
	}
345
346
	static function maybe_schedule_sync_cron( $schedule, $hook ) {
347
		if ( ! $hook ) {
348
			return;
349
		}
350
		$schedule = self::sanitize_filtered_sync_cron_schedule( $schedule );
351
352
		$start_time = time() + self::get_start_time_offset( $schedule, $hook );
353
		if ( ! wp_next_scheduled( $hook ) ) {
354
			// Schedule a job to send pending queue items once a minute
355
			wp_schedule_event( $start_time, $schedule, $hook );
356
		} else if ( $schedule != wp_get_schedule( $hook ) ) {
357
			// If the schedule has changed, update the schedule
358
			wp_clear_scheduled_hook( $hook );
359
			wp_schedule_event( $start_time, $schedule, $hook );
360
		}
361
	}
362
363
	static function clear_sync_cron_jobs() {
364
		wp_clear_scheduled_hook( 'jetpack_sync_cron' );
365
		wp_clear_scheduled_hook( 'jetpack_sync_full_cron' );
366
	}
367
368
	static function init_sync_cron_jobs() {
369
		add_filter( 'cron_schedules', array( __CLASS__, 'jetpack_cron_schedule' ) );
370
371
		add_action( 'jetpack_sync_cron', array( __CLASS__, 'do_cron_sync' ) );
372
		add_action( 'jetpack_sync_full_cron', array( __CLASS__, 'do_cron_full_sync' ) );
373
374
		/**
375
		 * Allows overriding of the default incremental sync cron schedule which defaults to once every 5 minutes.
376
		 *
377
		 * @since 4.3.2
378
		 *
379
		 * @param string self::DEFAULT_SYNC_CRON_INTERVAL_NAME
380
		 */
381
		$incremental_sync_cron_schedule = apply_filters( 'jetpack_sync_incremental_sync_interval', self::DEFAULT_SYNC_CRON_INTERVAL_NAME );
382
		self::maybe_schedule_sync_cron( $incremental_sync_cron_schedule, 'jetpack_sync_cron' );
383
384
		/**
385
		 * Allows overriding of the full sync cron schedule which defaults to once every 5 minutes.
386
		 *
387
		 * @since 4.3.2
388
		 *
389
		 * @param string self::DEFAULT_SYNC_CRON_INTERVAL_NAME
390
		 */
391
		$full_sync_cron_schedule = apply_filters( 'jetpack_sync_full_sync_interval', self::DEFAULT_SYNC_CRON_INTERVAL_NAME );
392
		self::maybe_schedule_sync_cron( $full_sync_cron_schedule, 'jetpack_sync_full_cron' );
393
	}
394
395
	static function cleanup_on_upgrade( $new_version = null, $old_version = null ) {
396
		if ( wp_next_scheduled( 'jetpack_sync_send_db_checksum' ) ) {
397
			wp_clear_scheduled_hook( 'jetpack_sync_send_db_checksum' );
398
		}
399
400
		$is_new_sync_upgrade = version_compare( $old_version, '4.2', '>=' );
401
		if ( ! empty( $old_version ) && $is_new_sync_upgrade && version_compare( $old_version, '4.5', '<' ) ) {
402
			require_once dirname( __FILE__ ) . '/class.jetpack-sync-settings.php';
403
			self::clear_sync_cron_jobs();
404
			Jetpack_Sync_Settings::update_settings( array(
405
				'render_filtered_content' => Jetpack_Sync_Defaults::$default_render_filtered_content
0 ignored issues
show
Bug introduced by
The property default_render_filtered_content cannot be accessed from this context as it is declared private in class Jetpack_Sync_Defaults.

This check looks for access to properties that are not accessible from the current context.

If you need to make a property accessible to another context you can either raise its visibility level or provide an accessible getter in the defining class.

Loading history...
406
			) );
407
		}
408
	}
409
410
	static function get_sync_status() {
411
		self::initialize_sender();
412
413
		$sync_module = Jetpack_Sync_Modules::get_module( 'full-sync' );
414
		$queue       = self::$sender->get_sync_queue();
415
		$full_queue  = self::$sender->get_full_sync_queue();
416
		$cron_timestamps = array_keys( _get_cron_array() );
417
		$next_cron = $cron_timestamps[0] - time();
418
419
		$full_sync_status = ( $sync_module ) ? $sync_module->get_status() : array();
420
		return array_merge(
421
			$full_sync_status,
422
			array(
423
				'cron_size'             => count( $cron_timestamps ),
424
				'next_cron'             => $next_cron,
425
				'queue_size'            => $queue->size(),
426
				'queue_lag'             => $queue->lag(),
427
				'queue_next_sync'       => ( self::$sender->get_next_sync_time( 'sync' ) - microtime( true ) ),
428
				'full_queue_size'       => $full_queue->size(),
429
				'full_queue_lag'        => $full_queue->lag(),
430
				'full_queue_next_sync'  => ( self::$sender->get_next_sync_time( 'full_sync' ) - microtime( true ) ),
431
			)
432
		);
433
	}
434
}
435
436
// Check for WooCommerce support
437
add_action( 'plugins_loaded', array( 'Jetpack_Sync_Actions', 'initialize_woocommerce' ), 5 );
438
439
// Check for WP Super Cache
440
add_action( 'plugins_loaded', array( 'Jetpack_Sync_Actions', 'initialize_wp_super_cache' ), 5 );
441
442
/*
443
 * Init after plugins loaded and before the `init` action. This helps with issues where plugins init
444
 * with a high priority or sites that use alternate cron.
445
 */
446
add_action( 'plugins_loaded', array( 'Jetpack_Sync_Actions', 'init' ), 90 );
447
448
449
450
// We need to define this here so that it's hooked before `updating_jetpack_version` is called
451
add_action( 'updating_jetpack_version', array( 'Jetpack_Sync_Actions', 'do_initial_sync' ), 10, 2 );
452
add_action( 'updating_jetpack_version', array( 'Jetpack_Sync_Actions', 'cleanup_on_upgrade' ), 10, 2 );
453