PHPで親子関係のデータをネスト表示する方法｜再帰とフラット配列からのツリー化

カテゴリーや階層メニューのように、親子関係を持つデータをネスト表示する処理はWeb開発でよくあります。ポイントは再帰で各階層を処理することと、データベースから来るフラットな配列（parent_id付き）をツリー構造に変換することです。この記事では両方を、そのまま動くコードで解説します。

この記事の結論：入れ子データの表示は再帰関数で行います（子があれば自分自身を呼び出す）。DBから取得したデータは多くがフラットな配列（parent_id 付き）なので、まずツリー構造に変換してから表示します。表示時は htmlspecialchars() でXSS対策を忘れずに。

入れ子になったサンプルデータ
再帰関数でネスト表示する
フラットな配列をツリーに変換する（実務の本番）
注意点：無限ループと深さ
よくある質問（FAQ）
まとめ

入れ子になったサンプルデータ

まず、すでに入れ子になっているデータ構造です。各要素が name と children（子要素の配列）を持ちます。

入れ子データ

<?php
$tree = [
    [
        'name' => '果物',
        'children' => [
            ['name' => 'りんご'],
            [
                'name' => '柑橘類',
                'children' => [
                    ['name' => 'みかん'],
                    ['name' => 'レモン'],
                ],
            ],
        ],
    ],
    ['name' => '野菜'],
];

再帰関数でネスト表示する

各ノードをループで処理し、子要素があれば同じ関数を再帰呼び出しします。出力する名前は htmlspecialchars() でエスケープしてXSSを防ぎます。

ツリーをHTMLリストで表示

<?php
function displayTree(array $tree): void {
    echo '<ul>';
    foreach ($tree as $node) {
        // XSS対策: 出力は必ずエスケープ
        echo '<li>' . htmlspecialchars($node['name'], ENT_QUOTES, 'UTF-8');
        if (!empty($node['children'])) {
            displayTree($node['children']); // 再帰
        }
        echo '</li>';
    }
    echo '</ul>';
}

displayTree($tree);

名前などの値は htmlspecialchars() でエスケープして出力してください。ユーザー入力やDBの値をそのまま echo すると、<script> などが埋め込まれてXSS（クロスサイトスクリプティング）の原因になります。

フラットな配列をツリーに変換する（実務の本番）

実際にはデータベースから取得する時点では、各行が id と parent_id を持つフラットな配列であることがほとんどです。これを表示用の入れ子構造に変換するのが本題です。再帰で parent_id をたどってツリーを組み立てます。

フラット配列 → ツリー構造

<?php
// DBから取得したようなフラットなデータ
$rows = [
    ['id' => 1, 'parent_id' => null, 'name' => '果物'],
    ['id' => 2, 'parent_id' => 1,    'name' => 'りんご'],
    ['id' => 3, 'parent_id' => 1,    'name' => '柑橘類'],
    ['id' => 4, 'parent_id' => 3,    'name' => 'みかん'],
    ['id' => 5, 'parent_id' => null, 'name' => '野菜'],
];

function buildTree(array $rows, $parentId = null): array {
    $branch = [];
    foreach ($rows as $row) {
        if ($row['parent_id'] === $parentId) {
            $children = buildTree($rows, $row['id']); // 子を再帰で取得
            if ($children) {
                $row['children'] = $children;
            }
            $branch[] = $row;
        }
    }
    return $branch;
}

$tree = buildTree($rows);
displayTree($tree); // 上の表示関数で出力

上の buildTree はシンプルですが、行数が多いと処理量が増えます。大量データなら、parent_id をキーにした連想配列（参照渡し）で1回のループで組み立てる方法もあります。ループ処理の基本はforeachで配列を順番に操作する方法を参照してください。