なぜCSVか？ —— Excelを超える軽量エクスポートの本質
大規模データのエクスポートにおいて、PHPExcelやPhpSpreadsheetは柔軟性に優れていますが、数百万行の出力ではパフォーマンスが急激に低下します。Excelの行制限（1,048,576行）や、セルごとのスタイル・フォーマット処理によるオーバーヘッドが原因です。一方、CSVは純粋なテキスト形式であり、エンコーディングと区切り文字のルールのみに従えば、メモリ使用量を最小限に抑え、秒単位での生成が可能です。
CSVの仕様と実装上の要点
基本構造と改行コード
CSVはカンマ（,）で列を区切り、\r\n（CRLF）で行を区切るプレーンテキストです。Windows系アプリケーション（特にMicrosoft Excel）との互換性を確保するため、改行には必ずCRLFを使用します。Unix系環境でも、多くのCSVパーサーはこれを正しく解釈します。
エスケープ規則
フィールド内に区切り文字（カンマ）、引用符（"）、または改行が含まれる場合、そのフィールド全体をダブルクォートで囲みます。さらに、フィールド内の"は""（二重クォート）に置換されます。PHPのfputcsv()はこのルールを自動で適用します。
BOM（Byte Order Mark）の役割と注意点
UTF-8エンコーディングのCSVファイルをExcelで正しく読み込むには、先頭にBOMシーケンス \xEF\xBB\xBF を付与する必要があります。これはUTF-8であることを明示し、文字化けを防ぎます。ただし、BOMは純粋なUTF-8仕様上必須ではなく、一部のCLIツールやAPIでは不具合を引き起こす可能性があります。したがって、用途に応じて明示的に挿入または除外する判断が必要です。
PHPにおける出力制御の基礎
出力バッファリングの仕組み
PHPのob_*関数群は、スクリプト実行中の出力を一時的にメモリに蓄積し、必要に応じて送信タイミングを制御します。これにより、ヘッダー送出後の出力エラー回避、中間処理（例：圧縮・暗号化）、および大規模データのストリーミング配信が可能になります。
php://output と php://memory の違い
php://output：HTTPレスポンスボディへの直接書き込み。一時ファイルを作成せず、即時ストリーミング可能。php://memory：RAM上に仮想ファイルを作成。読み書き両用で、fseek()やrewind()が利用可能。キャッシュ用途に適しています。
実践的なCSVエクスポート手法（9パターン）
パターン1：シンプルなストリーミング（中小規模データ向け）
最も直感的で、ほとんどのケースで推奨される方法です。
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="report.csv"');
$handle = fopen('php://output', 'w');
fwrite($handle, "\xEF\xBB\xBF"); // BOM
$rows = [
['氏名', '年齢', 'メール'],
['山田 太郎', '32', 'taro@example.com'],
['佐藤 花子', '28', 'hanako@example.com']
];
foreach ($rows as $row) {
fputcsv($handle, $row, ',', '"', '\\');
}
fclose($handle);
exit;パターン2：バッファ制御付きストリーミング（中～大規模データ向け）
1,000行ごとにバッファをフラッシュし、メモリ使用量とネットワーク遅延をバランスさせます。
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="bulk.csv"');
ob_end_clean();
ob_start();
$handle = fopen('php://output', 'w');
fwrite($handle, "\xEF\xBB\xBF");
$counter = 0;
foreach ($largeDataset as $record) {
fputcsv($handle, $record);
$counter++;
if ($counter % 1000 === 0) {
ob_flush();
flush();
}
}
ob_end_flush();
fclose($handle);
exit;パターン3：一時ファイル経由（大規模・再利用前提）
ファイルシステムに一時保存し、readfile()で配信。複数回ダウンロードされる場合や、バックグラウンドジョブとの連携に有効です。
$tempFile = sys_get_temp_dir() . '/export_' . uniqid() . '.csv';
$handle = fopen($tempFile, 'w');
foreach ($data as $row) {
fputcsv($handle, $row);
}
fclose($handle);
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="export.csv"');
header('Content-Length: ' . filesize($tempFile));
readfile($tempFile);
unlink($tempFile);
exit;パターン4：ジェネレータベースのストリーミング（メモリ極限対応）
データソース（DBカーソル、APIストリームなど）から逐次読み取り、即座にCSVへ変換。配列全体を保持しません。
function streamCsvFromIterator(Iterator $source, string $filename): void {
header('Content-Type: text/csv; charset=utf-8');
header("Content-Disposition: attachment; filename=\"{$filename}\"");
$handle = fopen('php://output', 'w');
fwrite($handle, "\xEF\xBB\xBF");
foreach ($source as $row) {
fputcsv($handle, $row);
// メモリ解放のため、不要な参照を明示的に解除
unset($row);
}
fclose($handle);
}
// 使用例：PDOStatementをイテレータとして流用
$stmt = $pdo->query("SELECT name, age, email FROM users");
streamCsvFromIterator(new IteratorIterator($stmt), 'users.csv');パターン5：APCuキャッシュ活用型（高頻度アクセス向け）
生成コストが高いが更新頻度が低いCSVを、APCuで1時間キャッシュ。初回以降は即時配信可能です。
$cacheKey = 'cached_csv_v2024';
if ($cached = apcu_fetch($cacheKey)) {
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="cached.csv"');
echo $cached;
exit;
}
$handle = fopen('php://memory', 'w');
fwrite($handle, "\xEF\xBB\xBF");
foreach ($staticData as $row) {
fputcsv($handle, $row);
}
rewind($handle);
$content = stream_get_contents($handle);
fclose($handle);
apcu_store($cacheKey, $content, 3600);
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="cached.csv"');
echo $content;
exit;パターン6：ANSI（Windows-1252）エンコーディング（英数字主体・軽量要求）
日本語・中国語を含まない場合、Windows-1252でエンコードするとファイルサイズが約30%削減され、Excelとの相性も良好です。
header('Content-Type: text/csv; charset=Windows-1252');
header('Content-Disposition: attachment; filename="ansi.csv"');
$handle = fopen('php://output', 'w');
foreach ($asciiOnlyData as $row) {
$converted = array_map(
fn($v) => iconv('UTF-8', 'Windows-1252//TRANSLIT', $v),
$row
);
fputcsv($handle, $converted);
}
fclose($handle);
exit;パターン7：SplFileObjectによるOOP実装（学習・拡張性重視）
オブジェクト指向でファイル操作を抽象化。カスタムCSVフォーマッタやログ機能を容易に追加できます。
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="oop.csv"');
$file = new SplFileObject('php://output', 'w');
$file->fwrite("\xEF\xBB\xBF");
foreach ($data as $row) {
$file->fputcsv($row);
}
exit;パターン8：手動フォーマット（教育・特殊フォーマット用）
fputcsv()を使わず、自前でエスケープ・連結を行う方法。特定の区切り文字（例：セミコロン）や、非標準のクォート戦略が必要な場合に使用します。
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="manual.csv"');
$handle = fopen('php://output', 'w');
fwrite($handle, "\xEF\xBB\xBF");
foreach ($data as $row) {
$escaped = array_map(function($cell) {
if (str_contains($cell, ',') || str_contains($cell, '"') || str_contains($cell, "\n")) {
return '"' . str_replace('"', '""', $cell) . '"';
}
return $cell;
}, $row);
fwrite($handle, implode(',', $escaped) . "\r\n");
}
fclose($handle);
exit;パターン9：コンポジションによるハイブリッド設計
上記の要素を組み合わせたカスタムクラス。例：「BOM付き＋APCuキャッシュ＋ジェネレータ＋区切り文字可変」を1クラスで統合。
class CsvExporter
{
private string $delimiter;
private bool $withBom;
public function __construct(string $delimiter = ',', bool $withBom = true)
{
$this->delimiter = $delimiter;
$this->withBom = $withBom;
}
public function stream(Iterator $source, string $filename): void
{
header('Content-Type: text/csv; charset=utf-8');
header("Content-Disposition: attachment; filename=\"{$filename}\"");
$handle = fopen('php://output', 'w');
if ($this->withBom) {
fwrite($handle, "\xEF\xBB\xBF");
}
foreach ($source as $row) {
fputcsv($handle, $row, $this->delimiter);
}
fclose($handle);
}
}
// 利用
$exporter = new CsvExporter(';'); // セミコロン区切り
$exporter->stream($dbCursor, 'semicolon.csv');