心跳 API

Heartbeat API 是一个内置于 WordPress 的简单服务器轮询 API，允许近乎实时的前端更新。

怎么运行的

当页面加载时，客户端心跳代码设置一个间隔（称为“tick”）每 15-120 秒运行一次。当它运行时，heartbeat 收集数据以通过 jQuery 事件发送，然后将其发送到服务器并等待响应。在服务器上，admin-ajax 处理程序获取传递的数据、准备响应、过滤响应，然后以 JSON 格式返回数据。客户端收到此数据并触发最终的 jQuery 事件以指示已收到数据。

自定义心跳事件的基本流程是：

1. 向要发送的数据添加附加字段（JSheartbeat-send事件）
2. 检测 PHP 中的发送字段，并添加额外的响应字段（heartbeat_received过滤器）
3. heartbeat-tick在 JS (JS )中处理返回的数据

（您可以选择仅使用这些事件中的一个或两个，具体取决于您需要的功能。）

使用 API

使用心跳 API 需要两个独立的功能：在 JavaScript 中发送和接收回调，以及在 PHP 中处理传递的数据的服务器端过滤器。

向服务器发送数据

当 Heartbeat 向服务器发送数据时，您可以包含自定义数据。这可以是您要发送到服务器的任何数据，也可以是一个简单的真值来指示您需要数据。

jQuery( document ).on( 'heartbeat-send', function ( event, data ) {
	// Add additional data to Heartbeat data.
	data.myplugin_customfield = 'some_data';
});

在服务器上接收和响应

在服务器端，您可以检测此数据，并将其他数据添加到响应中。

/**
 * Receive Heartbeat data and respond.
 *
 * Processes data received via a Heartbeat request, and returns additional data to pass back to the front end.
 *
 * @param array $response Heartbeat response data to pass back to front end.
 * @param array $data     Data received from the front end (unslashed).
 *
 * @return array
 */
function myplugin_receive_heartbeat( array $response, array $data ) {
	// If we didn't receive our data, don't send any back.
	if ( empty( $data['myplugin_customfield'] ) ) {
		return $response;
	}

	// Calculate our data and pass it back. For this example, we'll hash it.
	$received_data = $data['myplugin_customfield'];

	$response['myplugin_customfield_hashed'] = sha1( $received_data );
	return $response;
}
add_filter( 'heartbeat_received', 'myplugin_receive_heartbeat', 10, 2 );

处理响应

回到前端，您可以处理接收回的数据。

jQuery( document ).on( 'heartbeat-tick', function ( event, data ) {
	// Check for our data, and use it.
	if ( ! data.myplugin_customfield_hashed ) {
		return;
	}
	alert( 'The hash is ' + data.myplugin_customfield_hashed );
});

并非每个功能都需要所有这三个步骤。例如，如果您不需要向服务器发送任何数据，则可以只使用后两个步骤。