<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* WP Async Request

[2] Fix | Delete

*

[3] Fix | Delete

* @package WP-Background-Processing

[4] Fix | Delete

*/

[5] Fix | Delete

[6] Fix | Delete

defined( 'ABSPATH' ) || exit;

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* Abstract WP_Async_Request class.

[10] Fix | Delete

*/

[11] Fix | Delete

abstract class WP_Async_Request {

[12] Fix | Delete

[13] Fix | Delete

/**

[14] Fix | Delete

* Prefix

[15] Fix | Delete

*

[16] Fix | Delete

* (default value: 'wp')

[17] Fix | Delete

*

[18] Fix | Delete

* @var string

[19] Fix | Delete

* @access protected

[20] Fix | Delete

*/

[21] Fix | Delete

protected $prefix = 'wp';

[22] Fix | Delete

[23] Fix | Delete

/**

[24] Fix | Delete

* Action

[25] Fix | Delete

*

[26] Fix | Delete

* (default value: 'async_request')

[27] Fix | Delete

*

[28] Fix | Delete

* @var string

[29] Fix | Delete

* @access protected

[30] Fix | Delete

*/

[31] Fix | Delete

protected $action = 'async_request';

[32] Fix | Delete

[33] Fix | Delete

/**

[34] Fix | Delete

* Identifier

[35] Fix | Delete

*

[36] Fix | Delete

* @var mixed

[37] Fix | Delete

* @access protected

[38] Fix | Delete

*/

[39] Fix | Delete

protected $identifier;

[40] Fix | Delete

[41] Fix | Delete

/**

[42] Fix | Delete

* Data

[43] Fix | Delete

*

[44] Fix | Delete

* (default value: array())

[45] Fix | Delete

*

[46] Fix | Delete

* @var array

[47] Fix | Delete

* @access protected

[48] Fix | Delete

*/

[49] Fix | Delete

protected $data = array();

[50] Fix | Delete

[51] Fix | Delete

/**

[52] Fix | Delete

* Initiate new async request

[53] Fix | Delete

*/

[54] Fix | Delete

public function __construct() {

[55] Fix | Delete

$this->identifier = $this->prefix . '_' . $this->action;

[56] Fix | Delete

[57] Fix | Delete

add_action( 'wp_ajax_' . $this->identifier, array( $this, 'maybe_handle' ) );

[58] Fix | Delete

add_action( 'wp_ajax_nopriv_' . $this->identifier, array( $this, 'maybe_handle' ) );

[59] Fix | Delete

}

[60] Fix | Delete

[61] Fix | Delete

/**

[62] Fix | Delete

* Set data used during the request

[63] Fix | Delete

*

[64] Fix | Delete

* @param array $data Data.

[65] Fix | Delete

*

[66] Fix | Delete

* @return $this

[67] Fix | Delete

*/

[68] Fix | Delete

public function data( $data ) {

[69] Fix | Delete

$this->data = $data;

[70] Fix | Delete

[71] Fix | Delete

return $this;

[72] Fix | Delete

}

[73] Fix | Delete

[74] Fix | Delete

/**

[75] Fix | Delete

* Dispatch the async request

[76] Fix | Delete

*

[77] Fix | Delete

* @return array|WP_Error

[78] Fix | Delete

*/

[79] Fix | Delete

public function dispatch() {

[80] Fix | Delete

$url = add_query_arg( $this->get_query_args(), $this->get_query_url() );

[81] Fix | Delete

$args = $this->get_post_args();

[82] Fix | Delete

[83] Fix | Delete

return wp_remote_post( esc_url_raw( $url ), $args );

[84] Fix | Delete

}

[85] Fix | Delete

[86] Fix | Delete

/**

[87] Fix | Delete

* Get query args

[88] Fix | Delete

*

[89] Fix | Delete

* @return array

[90] Fix | Delete

*/

[91] Fix | Delete

protected function get_query_args() {

[92] Fix | Delete

if ( property_exists( $this, 'query_args' ) ) {

[93] Fix | Delete

return $this->query_args;

[94] Fix | Delete

}

[95] Fix | Delete

[96] Fix | Delete

return array(

[97] Fix | Delete

'action' => $this->identifier,

[98] Fix | Delete

'nonce' => wp_create_nonce( $this->identifier ),

[99] Fix | Delete

);

[100] Fix | Delete

}

[101] Fix | Delete

[102] Fix | Delete

/**

[103] Fix | Delete

* Get query URL

[104] Fix | Delete

*

[105] Fix | Delete

* @return string

[106] Fix | Delete

*/

[107] Fix | Delete

protected function get_query_url() {

[108] Fix | Delete

if ( property_exists( $this, 'query_url' ) ) {

[109] Fix | Delete

return $this->query_url;

[110] Fix | Delete

}

[111] Fix | Delete

[112] Fix | Delete

return admin_url( 'admin-ajax.php' );

[113] Fix | Delete

}

[114] Fix | Delete

[115] Fix | Delete

/**

[116] Fix | Delete

* Get post args

[117] Fix | Delete

*

[118] Fix | Delete

* @return array

[119] Fix | Delete

*/

[120] Fix | Delete

protected function get_post_args() {

[121] Fix | Delete

if ( property_exists( $this, 'post_args' ) ) {

[122] Fix | Delete

return $this->post_args;

[123] Fix | Delete

}

[124] Fix | Delete

[125] Fix | Delete

return array(

[126] Fix | Delete

'timeout' => 0.01,

[127] Fix | Delete

'blocking' => false,

[128] Fix | Delete

'body' => $this->data,

[129] Fix | Delete

'cookies' => $_COOKIE,

[130] Fix | Delete

'sslverify' => apply_filters( 'https_local_ssl_verify', false ),

[131] Fix | Delete

);

[132] Fix | Delete

}

[133] Fix | Delete

[134] Fix | Delete

/**

[135] Fix | Delete

* Maybe handle

[136] Fix | Delete

*

[137] Fix | Delete

* Check for correct nonce and pass to handler.

[138] Fix | Delete

*/

[139] Fix | Delete

public function maybe_handle() {

[140] Fix | Delete

// Don't lock up other requests while processing

[141] Fix | Delete

session_write_close();

[142] Fix | Delete

[143] Fix | Delete

check_ajax_referer( $this->identifier, 'nonce' );

[144] Fix | Delete

[145] Fix | Delete

$this->handle();

[146] Fix | Delete

[147] Fix | Delete

wp_die();

[148] Fix | Delete

}

[149] Fix | Delete

[150] Fix | Delete

/**

[151] Fix | Delete

* Handle

[152] Fix | Delete

*

[153] Fix | Delete

* Override this method to perform any actions required

[154] Fix | Delete

* during the async request.

[155] Fix | Delete

*/

[156] Fix | Delete

abstract protected function handle();

[157] Fix | Delete

[158] Fix | Delete

}

[159] Fix | Delete

[160] Fix | Delete