デカルト積問題って知っとるか〜？　気軽にJOINでメモリ爆発するアレのヤバさ実測すぞ！

#!/usr/bin/env php
<?php

// JOIN結果が「アプリサーバーのメモリに乗るまで」を段階分離して実測する。
// memory_get_usage(false)（＝生きてる実バイト、free で減る）で各段の増分を測る。
// 推測ではなく実数を出すのが目的。
//
//   docker compose run --rm app php bin/mem-breakdown.php [chain|sibling]
//     chain   : users → posts → comments   （和 = 分布不変）
//     sibling : posts ← users → files       （積の和 = デカルト積・分布敏感）
//
// 測る段：
//   ①-a MySQLバッファ … executeQuery した直後（まだfetchしていない）。mysqlndが持つ生バイト列。
//   ①-b PHP配列展開   … fetchAllNumeric でPHPの配列(zval)に展開した増分。ここで膨らむ。
//   ②   解放          … unset+GC で①が戻るか確認。
//   ③   UoWグラフ     … Doctrineがエンティティにハイドレーションして残す量。

use App\Entity\User;

$em       = require __DIR__ . '/../bootstrap.php';
$conn     = $em->getConnection();
$scenario = $argv[1] ?? 'sibling';

$mb = static fn (int $b): string => number_format($b / 1024 / 1024, 2) . ' MB';

// scenario → [ハイドレーション用DQL, 生の結果を全取得する生SQL（fetch-joinと同じ列）]
$map = [
    'chain' => [
        'SELECT u, p, c FROM App\Entity\User u JOIN u.posts p JOIN p.comments c',
        'SELECT u.*, p.*, c.* FROM users u JOIN posts p ON p.author_id = u.id JOIN comments c ON c.post_id = p.id',
    ],
    'sibling' => [
        'SELECT u, p, f FROM App\Entity\User u JOIN u.posts p JOIN u.files f',
        'SELECT u.*, p.*, f.* FROM users u JOIN posts p ON p.author_id = u.id JOIN files f ON f.user_id = u.id',
    ],
];

if (!isset($map[$scenario])) {
    fwrite(STDERR, "scenario は chain | sibling のいずれか\n");
    exit(1);
}
[$dql, $rawSql] = $map[$scenario];

gc_collect_cycles();
$m0 = memory_get_usage(false);

// ①-a MySQLから来た生バイト列（mysqlndの内部バッファ）。
//     PDOは既定でバッファドクエリなので、executeQuery した時点で全行がここに乗る。
//     まだ fetch していない = PHPの配列にはなっていない。
$stmt = $conn->executeQuery($rawSql);
$m1   = memory_get_usage(false);

// ①-b PHPの配列(zval)に展開。バッファは $stmt 側にまだ残るので、この増分は「配列化ぶん」だけ。
$rows    = $stmt->fetchAllNumeric();
$m2      = memory_get_usage(false);
$rawRows = count($rows);

// ② 解放して戻るか確認（バッファも配列も捨てる）
unset($rows, $stmt);
gc_collect_cycles();
$m3 = memory_get_usage(false);

// ここまでのピーク（①-b の配列展開を含む足場ぶん）を控えておく。
// ※ false(=生きてるemallocバイト)で測る。true(OSプール)は借りたら返さずstickyに残るので、
//    このあと③のピークをリセット計測する際に前段のプールが混ざって使えない。
$peakWithArray = memory_get_peak_usage(false);

// ピークの高水位をリセット（PHP 8.2+）。生セットは②で解放済み(false基準でbaselineに復帰)なので、
// ここから③だけを走らせれば「配列展開を通らないDoctrine経路の素のピーク」が測れる。
memory_reset_peak_usage();

// ③ オブジェクトにハイドレーション（UoWに載る）
$objs = $em->createQuery($dql)->getResult();
$m4   = memory_get_usage(false);

$peakHydrate = memory_get_peak_usage(false);

echo "scenario                 : {$scenario}\n";
echo "生の結果行数             : " . number_format($rawRows) . "\n";
echo "①-a MySQLバッファ実測    : " . $mb($m1 - $m0) . "   ← mysqlndが持つ生バイト列（コンパクト）\n";
echo "①-b PHP配列展開の増分    : " . $mb($m2 - $m1) . "   ← fetchAllNumericでzvalに膨張\n";
echo "②  unset+GC後の残り      : " . $mb($m3 - $m0) . "   ← ~0 なら生セットは解放済み\n";
echo "③  UoWグラフ実測         : " . $mb($m4 - $m3) . "   ← ハイドレーション後に残るエンティティ群\n";
echo "    エンティティ数       : " . number_format($em->getUnitOfWork()->size()) . "\n";
echo "ピーク: 配列展開込み(false): " . $mb($peakWithArray) . "   ← ①-b(fetchAllNumeric)の足場を含む\n";
echo "ピーク: ③のみ(false)     : " . $mb($peakHydrate) . "   ← 配列展開を通らないgetResult()だけのピーク\n";