WordPressデータベースの限界を超える：`wp_comments`の階層構造をフラット化し、クエリ負荷を極限まで削減する設計手法
コードレビューをしていて、最も背筋が凍る瞬間のひとつがこれだ。
// 絶対にやってはいけない典型的なアンチパターン
$comments = get_comments(array(‘post_id’ => $post_id));
// これをテンプレート側で再帰関数（wp_list_commentsなど）にぶち込み、
// さらに子コメントの取得でループ内にクエリを発生させる
大規模なメディアサイトや活発なコミュニティプラットフォームにおいて、標準の `wp_comments` テーブルが抱える最大のボトルネックは、その隣接リストモデル（Adjacency List Model）による親子関係の保持にある。
親ID（`comment_parent`）を頼りにツリー構造を構築しようとすると、コメント数が増大した瞬間にクエリ数が爆発するか、PHPのメモリ上で重い再帰処理を回す羽目になる。階層が深くなればなるほど、データベースは悲鳴を上げ、CPU使用率は跳ね上がる。
今回は、WordPressコアの制約をスマートにバイパスし、数万件規模の階層型コメントであっても一発のクエリ（O(1)に近いコスト）で高速かつ安全に処理するための「パス列挙モデル（Path Enumeration）」を用いたデータベース設計と、プロダクション環境で即座に使える実装コードを伝授する。
—
なぜ標準の `wp_comments` はスケールしないのか
標準の `wp_comments` テーブル構造を見てみよう。
- `comment_ID` (BIGINT)
- `comment_post_ID` (BIGINT)
- `comment_parent` (BIGINT)
親を特定するために `comment_parent` を見るこの構造は、一見シンプルで美しい。しかし、これを使って「特定のコメントの全子孫」や「スレッド全体のツリー構造」をSQLだけで取得しようとすると、MySQLのバージョンによっては再帰共通テーブル式（CTE: `WITH RECURSIVE`）を書く必要があり、インデックスが効きにくく、高負荷なクエリになりがちだ。
WordPressの標準関数群（`wp_list_comments` や `get_comments`）も、デフォルトでは全コメントを一度メモリにロードし、PHP側でツリーを再構築する。数千件のコメントがある記事では、これだけで数MBのメモリと数百ミリ秒のレイテンシーを消費する。
この問題を根本から解決するには、データベースの物理構造レベルで階層をフラット化しなければならない。
—
解決策：パス列挙モデル（Path Enumeration）の導入
今回提案するのは、カスタムテーブル（または `wp_commentmeta` の活用）を用いて、コメントの祖先から自身に至るまでのパスをスラッシュ区切りなどで保持する設計手法だ。
例えば、ID `1` のコメントの返信（ID `5`）、さらにその返信（ID `12`）がある場合、パスは以下のように表現される。
- コメント1: パス `/1/`
- コメント5: パス `/1/5/`
- コメント12: パス `/1/5/12/`
この構造を採用すれば、「コメント5の全ての子孫」を取得したい場合のSQLは以下のようになる。
SELECT FROM wp_custom_comment_paths WHERE comment_path LIKE ‘/1/5/%’;
これなら、インデックス（Prefix Index）を完全に効かせた超高速な検索が可能になる。
—
プロダクション実装：堅牢なカスタムテーブル設計とフック統合
ここからは、実務の現場でそのまま投入できるコードベースを解説する。
ここでは、コメント投稿時に自動でパスを生成・管理するカスタムテーブル `wp_comment_paths` を定義し、WordPressのライフサイクルに完全に統合する。
1. テーブルのマイグレーション
プラグイン有効化時などに、次のようなスキーマを生成する。InnoDBのB-treeインデックスを最大限に活かすため、`comment_path` にはインデックスを貼る。
global $wpdb;
$table_name = $wpdb->prefix . ‘comment_paths’;
$charset_collate = $wpdb->get_charset_collate();
$sql = “CREATE TABLE $table_name (
comment_id bigint(20) unsigned NOT NULL,
comment_post_id bigint(20) unsigned NOT NULL,
comment_path varchar(255) NOT NULL,
depth int(unsigned) NOT NULL DEFAULT 1,
PRIMARY KEY (comment_id),
KEY comment_post_id (comment_post_id),
KEY comment_path (comment_path(191))
) $charset_collate;”;
require_once( ABSPATH . ‘wp-admin/includes/upgrade.php’ );
dbDelta( $sql );
2. コメント挿入時のパス自動生成ロジック
新しいコメントが挿入された際、親のパスを参照し、自身のパスを構築してカスタムテーブルに書き込む。WordPressの `wp_insert_comment` アクションフックを利用する。
/
- コメントが挿入された際に、パス列挙モデル用のデータを生成・保存する
- @param int $comment_id コメントID
- @param WP_Comment $comment コメントオブジェクト
/
function my_handle_comment_path_insertion( $comment_id, $comment ) {
global $wpdb;
$table_name = $wpdb->prefix . ‘comment_paths’;
$parent_id = (int) $comment->comment_parent;
$path = ‘/’ . $comment_id . ‘/’;
$depth = 1;
if ( $parent_id > 0 ) {
// 親のパスと階層深度を取得
$parent_data = $wpdb->get_row( $wpdb->prepare(
“SELECT comment_path, depth FROM $table_name WHERE comment_id = %d”,
$parent_id
) );
if ( $parent_data ) {
$path = $parent_data->comment_path . $comment_id . ‘/’;
$depth = (int) $parent_data->depth + 1;
}
}
// データの挿入（重複時は更新）
$wpdb->replace(
$table_name,
array(
‘comment_id’ => $comment_id,
‘comment_post_id’ => (int) $comment->comment_post_ID,
‘comment_path’ => $path,
‘depth’ => $depth,
),
array( ‘%d’, ‘%d’, ‘%s’, ‘%d’ )
);
}
add_action( ‘wp_insert_comment’, ‘my_handle_comment_path_insertion’, 10, 2 );
3. 圧倒的なパフォーマンスを発揮するフラット・ツリー取得クエリ
ツリー構造を構築するためのボイラープレートコードだ。このアプローチでは、データベースから一度に全コメントのパス情報を取得し、PHP側でメモリ上のポインタ（参照）を使ってO(N)の計算量でツリーを構築する。再帰クエリは一切発生しない。
/
- 指定された投稿のコメントツリーを1回のクエリでフラットに取得し、構造化する
- @param int $post_id 投稿ID
- @return array 階層化されたコメントツリー
/
function my_get_flattened_comment_tree( $post_id ) {
global $wpdb;
$paths_table = $wpdb->prefix . ‘comment_paths’;
$comments_table = $wpdb->comments;
// 1. パス情報と実際のコメントデータを結合して一括取得
// ORDER BY comment_path により、自然とトポロジカルソートされた状態になる
$results = $wpdb->get_results( $wpdb->prepare(
“SELECT c., p.comment_path, p.depth
FROM $comments_table c
INNER JOIN $paths_table p ON c.comment_ID = p.comment_id
WHERE c.comment_post_ID = %d AND c.comment_approved = ‘1’
ORDER BY p.comment_path ASC”,
$post_id
) );
if ( empty( $results ) ) {
return array();
}
$tree = array();
$references = array();
foreach ( $results as $comment ) {
$comment->children = array();
$references[$comment->comment_ID] = $comment;
if ( (int) $comment->comment_parent === 0 ) {
// トップレベルコメント
$tree[$comment->comment_ID] = $comment;
} else {
// 子コメントの場合、参照を使って親の children 配列に紐付ける
if ( isset( $references[$comment->comment_parent] ) ) {
$references[$comment->comment_parent]->children[$comment->comment_ID] = $comment;
}
}
}
return $tree;
}
—
テクニカルリードからの実践的アドバイス
1. キャッシュ戦略との組み合わせ
上記 `my_get_flattened_comment_tree` の結果は、トランザクション安全性を考慮しつつ `wp_cache_set` / `wp_cache_get` を用いてオブジェクトキャッシュ（Redis/Memcached）にストアすべきだ。コメントが追加・削除・承認されたタイミング（`wp_insert_comment`, `edit_comment`, `delete_comment`）でキャッシュグループをパージ（`wp_cache_delete`）するフックを忘れずに実装すること。
2. データ整合性の担保（バグを防ぐために）
既存のデータベースに後からこの仕組みを導入する場合、過去のコメントに対して一括でパスを生成するマイグレーションスクリプト（WP-CLIコマンドとして実装するのがベスト）を必ず用意すること。親が存在しない孤立コメントや、無限ループを引き起こす不正な参照データがないかをバリデーションするロジックも組み込むこと。
3. なぜこの設計がスケールするのか
従来のWordPress標準コードは「データベースに負荷をかけ、PHPで組み立てる」か「都度クエリを投げる」という最悪のトレードオフを強いられていた。パス列挙モデルによって「データベース側でインデックスを使った高速な範囲検索（`LIKE` またはツリー順ソート）」を行い、「PHP側では参照渡しによるO(N)のマージ」を行うことで、システム全体のスループットが劇的に向上する。
大規模トラフィックに耐えうる堅牢なWordPressアーキテクチャは、こうしたコアデータ構造の最適化の積み重ねによってのみ築かれる。安易なプラグイン依存や標準関数の誤用を断ち切り、データベースの特性を掌握した設計を心がけてほしい。