Home/用語集/WordPress/ハートビートAPI

ハートビートAPI

May 21, 2025 Updated June 2, 2025

WordPress glossaryThe Heartbeat API keeps the browser and server in touch while someone works in the WordPress admin. It powers post locking, login checks, and live dashboard updates.

WordPressのHeartbeat APIは、ウェブサイトの脈拍のように機能します。ブラウザからサーバーへ、数秒ごとに「生きている」という小さな通知を送信します。この自動リクエスト/レスポンスサイクルにより、サイトのデータ、投稿、ダッシュボードが同期され、リアルタイムの更新と、エディター、プラグイン、管理者にとって重要な機能が提供されます。.

この用語集の記事では、WordPress Heartbeat API がどのように機能するか、なぜそれが重要なのか、ホスティングで高い CPU 需要が生じる場合にそれを監視、制御、または無効にする方法について詳しく説明します。.

WordPress Heartbeat API が重要な理由

Heartbeat APIは、ブラウザとサーバー間の継続的な通信を維持することで、WordPressのユーザーフレンドリーな機能の多くを支えています。Heartbeat APIがなければ、便利な自動保存、投稿の共同ロック、ダッシュボードのリアルタイム更新といった機能が利用できなくなります。.

  • 投稿エディターを安全に保ちます: WordPressエディターで投稿を作成または編集する際、Heartbeatは15~60秒ごとに変更内容を自動保存するため、ブラウザや接続が切断されても作業内容が失われることはありません。
  • ユーザーロックと通知: 2人の著者が同時に同じ投稿を編集しようとすると、Heartbeatは通知(「あなたのチームメンバーがこの投稿を編集しています」)を送信し、コンテンツの競合を防ぐためにロック機構を適用します。
  • リアルタイム ダッシュボード ウィジェット: WooCommerce などの電子商取引プラグインは、 API を使用して、ページ全体をリロードせずにダッシュボードの販売データを更新します。
  • セッション タイムアウト アラート: ログイン セッションの有効期限が切れると、Heartbeat から警告が出され、保存されていない編集内容が失われる前に再度ログインするように求められます。

Heartbeat API の仕組み: 基本

Heartbeatはサーバーへの小さなAJAX呼び出しを介して動作し、WordPressはページ全体を更新することなくデータを調整できます。これらの頻繁なpingにより、エディターが最新の情報を確認し、セッションが有効な状態を維持することで、機能とセキュリティが最適化されます。

  • ブラウザ送信 管理者-ajax.php リクエスト: Heartbeatのたびにブラウザは小さなAJAX呼び出しを送信します。 /wp-admin/admin-ajax.php.
  • サーバー プロセス リクエスト: WordPress はフックされた関数を実行し、新しいデータを取得して、それを JSON 応答として送り返します。
  • ブラウザが受信して処理する: ブラウザのJavaScriptイベントが応答を捕捉し、UIを更新(自動保存、ウィジェットの更新など)し、次の間隔に備えます。

js

// 例: フロントエンドで次のハートビートティックをリッスンする
jQuery(document).on('heartbeat-tick', function(event, data) {
console.log('ハートビート応答を受信しました:', data);
});

  • デフォルトの間隔:エディター画面(15秒)、ダッシュボードおよびその他の管理ページ(60秒)。

コアフックとコード例

開発者はHeartbeatの組み込みフックを活用して、カスタム機能を追加したり、動作を調整したりできます。これらのJavaScriptおよびPHPイベントを利用することで、必要なデータを交換するためのAPIをカスタマイズできます。.

JavaScriptフック

以下は、フロントエンド制御に結び付けることができる 2 つの主要な JS フックです。

  • ハートビート送信: 各リクエストの前にカスタム データを添付します。.
  • 心臓の鼓動: リクエストが完了したら、受信したデータに基づいて操作します。.

js

// ハートビート送信イベントごとに追加情報を添付する
jQuery(document).on('heartbeat-send', function(e, data) {
data.customValue = jQuery('#my-field').val();
});

PHPフック

サーバー側では、これらのフックを使用して、Heartbeat 呼び出しを変更したり、Heartbeat 呼び出しに反応したりできます。

  • ハートビート送信: サーバーから返されるデータを変更します。.
  • ハートビート受信: サーバーがティックを受け取ったときにアクションを実行します。.

php

add_filter('heartbeat_send', 'my_heartbeat_send', 10, 2);
function my_heartbeat_send($response, $screen_id) {
if ($screen_id === 'post') {
$response['server_time'] = time();
}
return $response;
}

WordPress Heartbeat APIの一般的な使用例

Heartbeatのリアルタイム機能は、WordPressの多くの日常的な機能を支えています。サーバーとブラウザを同期することで、手動でクリックしたり、完全にリロードしたりすることなく、ダッシュボードとエディターを最新の状態に保つことができます。.

  • 自動保存とリビジョン: Heartbeatは投稿エディター内でシームレスに動作し、15秒ごとにバックアップを作成するため、失われたコンテンツを復元できます。
  • リアルタイムの販売データ: 電子商取引プラグイン開発者は、Heartbeat を使用して最新の販売統計を取得し、即座に表示します。
  • セッション有効期限切れ通知: ログインセッションの有効期限が近づくと、Heartbeatは「ログイン状態を維持するにはここをクリックしてください」という通知を表示します。
  • コラボレーションアラート: 複数著者がいるサイトで、誰がどの投稿を編集しているかを確認できるため、上書きの競合を防ぐことができます。

パフォーマンスの考慮事項と高いCPU使用率

Heartbeatはリアルタイム更新には不可欠ですが、アクセスの多いサイトではCPUを大量に消費する可能性があります。admin-ajax.phpへの頻繁なAJAXリクエストは処理時間とメモリを消費するため、共有ホスティングアカウントのリソース制限を超えてしまう可能性があります。.

  • CPU負荷の上昇: 頻繁なHeartbeat API呼び出しは、特に共有ホスティングプランでは、サーバーのCPU使用率を大幅に増加させる可能性があります。これは、各ティックでPHPが AJAX リクエストを処理する必要があるためです。
  • ページ応答が遅くなる: サーバーがこれらのリクエストをより多く処理するにつれて、フロントエンドのページの読み込みと管理ダッシュボードのやり取りが著しく遅くなる可能性があります。
  • 停止のリスク: の量が 管理者-ajax.php リクエストによってサイトがホストの CPU 制限を超えると、使用量が許容レベルに戻るまでアカウントが制限または停止される可能性があります。.

ハートビート トラフィックを監視するにはどうすればよいでしょうか?

ハートビートアクティビティを観察することで、パフォーマンスのボトルネックを早期に診断できます。サーバーログとクライアント側ツールを使用して、リクエストの頻度と応答時​​間を追跡してください。.

  • サーバーログと統計: cPanelまたはホスティングダッシュボードでCPU使用率の急上昇をチェックし、 /wp-admin/admin-ajax.php エントリ。.
  • ブラウザ開発者ツール: ChromeまたはFirefoxの開発者ツール→ネットワークタブ→「admin-ajax.php」をフィルタリング→ティックの頻度と応答時​​間を監視します。
  • プラグイン ソリューション: パフォーマンス プラグイン (Query Monitor など) をインストールして、管理ダッシュボードで直接、Heartbeat 呼び出し、メモリ使用量、実行時間を確認します。

Heartbeat APIの制御と制限

Heartbeatのデフォルトのリズムがサーバーに過負荷をかけている場合は、Heartbeatを部分的に減速または無効化することができます。これにより、リアルタイム機能と最適なパフォーマンスおよびリソース制御のバランスをとることができます。.

  • プラグインを使用する場合: Heartbeat Controlをインストールするか、 WP Rocketの組み込み設定を使用して、間隔を調整したり、特定の画面でHeartbeatをオフにしたりできます。
  • コード経由

php

// ハートビートの頻度を60秒に1回に減らす
add_filter('heartbeat_settings', function($settings) {
$settings['interval'] = 60;
return $settings;
});
// フロントエンドで完全に無効にする
add_action('init', function() {
if (!is_admin()) wp_deregister_script('heartbeat');
}, 1);

Heartbeat API を無効にするリスク

Heartbeatを無効にするとCPU負荷は軽減されますが、いくつかの重要な機能が利用できなくなります。サイト全体で無効にする前に、ユーザーエクスペリエンスとセキュリティのトレードオフを理解してください。.

  • クラシック エディターには自動保存機能がありません → 変更ごとに手動で「下書きを保存」をクリックする必要があります。.
  • 公開/更新中にインターネット接続が切断された場合、データが失われる可能性があります。.
  • Heartbeat に依存するダッシュボード ウィジェットとプラグインは動作を停止し、リアルタイム レポートと機能が減少します。.

ベストプラクティスとトラブルシューティング

Heartbeatを完全に停止するのではなく、その動作を微調整する方が賢明です。Heartbeatを選択的にスロットリングしたりログに記録したりすることで、サーバーの健全性を維持しながらHeartbeatの利点を維持できます。.

  • スロットル操作で停止させない:完全に無効にするのではなく、間隔を15秒から30秒または60秒に延長します。
  • ステージングでのテスト: まず、ステージング環境で間隔の変更または登録解除を適用して、問題を検出します。
  • キャッシュと組み合わせる: オブジェクトまたはページのキャッシュを活用して、Heartbeat からの余分なサーバー負荷を相殺します。
  • ログを有効にする: フックイン ハートビート受信 ティックを記録し、予期しない動作をデバッグします。.

最終的な考え

WordPress Heartbeat API は、サイトの動作と同期を維持します。下書きの自動保存、リアルタイムデータの表示、編集の競合防止に役立ちます。リクエストが多すぎるとCPU使用率が上昇する可能性があります。必要に応じて速度を落としたり、無効化したりできます。まずはステージングサイトで変更をテストしてください。適切なバランスを保つことで、Heartbeat はパフォーマンスを損なうことなく機能性を向上させます。.

WordPress の用語と詳しい説明については、 Seahawk Media 用語集。

WP Services

WordPress services at revolutionary pricing.

Productized WordPress services, from builds to care, delivered by Seahawk and tracked in one app. For the WordPress lovers.