導入
開発現場において、外部APIから取得したJSONデータや、複雑な設定ファイルを処理する際、配列がどれくらいの階層構造になっているかを動的に把握したい場面があります。特に、再帰的なデータ構造を扱う際や、バリデーションロジックを組む際に、配列の深さを正確に知ることは不可欠です。今回は、PHPで多次元配列の最も深い階層を特定するためのスマートな実装方法を解説します。
基礎知識
PHPにおける「多次元配列の深さ」とは、配列が入れ子になっている最大階層数を指します。例えば、単一の配列（array(1, 2)）であれば深さは1ですが、配列の中に配列が含まれる場合、その分だけ階層が深くなります。再帰処理（Recursive Function）を用いることで、この階層を末端まで探索し、最大の深さを算出することが可能です。
実装/解決策
配列の深さを求めるには、関数内で自分自身を呼び出す「再帰関数」が適しています。現在の階層を引数で持ち回り、各要素に対してループ処理を行いながら、深さを更新していきます。比較には max() 関数を利用することで、混在する階層の中でも「最も深い場所」を抽出するのがポイントです。
サンプルプログラム
以下は、多次元配列の深さを取得するための実用的な関数です。
- @param mixed $arr 調査対象の配列
- @param bool $blank 空の配列を深さとしてカウントするかどうか
- @param int $depth 現在の階層（内部用）
- @return int 最大階層数
/
function get_array_depth($arr, $blank = false, $depth = 0) {
// 配列でない場合は、現在の深さを返す
if (!is_array($arr)) {
return $depth;
}
// 階層を一つ深くする
$depth++;
// 空配列の扱いを決定（$blankがtrueなら現在の階層を保持）
$tmp = ($blank) ? [$depth] : [0];
// 各要素に対して再帰的に深さを調査
foreach ($arr as $value) {
$tmp[] = get_array_depth($value, $blank, $depth);
}
// 抽出された深さの中で最大値を返す
return max($tmp);
}
// 使用例
$data = [1, [2, [3, 4]], 5];
echo “配列の深さ: ” . get_array_depth($data); // 出力: 3
?>
応用・注意点
実務でこの関数を使用する際の注意点をいくつか挙げます。
1. パフォーマンスへの影響
非常に巨大な多次元配列に対して再帰処理を行うと、スタックオーバーフローやメモリ不足を招く恐れがあります。扱うデータのサイズが極端に大きい場合は、再帰ではなく、RecursiveIteratorIterator などのイテレータクラスを活用した実装を検討してください。
2. 空配列の扱い
要件によっては、空の配列（array()）を「深さ0」と見なすべきか、「1階層」と見なすべきかが分かれます。上記のサンプルでは $blank 引数で柔軟に切り替えられるようにしていますが、仕様書に合わせてこの挙動を明確にしておくことが、バグを減らす鍵となります。
3. 循環参照の回避
稀ですが、配列が自分自身を参照しているような循環構造を持つデータに対してこの関数を実行すると、無限ループに陥ります。外部からの入力データを取り扱う際は、事前に is_array() のチェックだけでなく、データの整合性や構造の深さを制限するガード句を入れることを推奨します。