💡 忙しい人のための結論(3行まとめ)
  • Excelの文字化けは、ストリーム先頭に UTF-8 BOM("\xEF\xBB\xBF")を3バイト出力するだけで解決する(Shift_JIS変換は環境依存文字が消えるため非推奨)
  • 文字列連結(implode(',', $row))はカンマや改行を含む値で列崩れを起こすため、必ず fputcsv() を使う
  • PHP 8.4以降では fputcsv() の第5引数に escape: ''(空文字) を明示してRFC 4180準拠&非推奨警告(Deprecated)を回避する

1. 発生する症状・やりたいこと(前提条件)

管理画面から顧客リストや注文データをCSVダウンロードさせた際、Windows / Mac の Excel でそのままダブルクリックして開いても文字化けせず、かつ大量データでもメモリ不足(Allowed memory size exhausted)にならない出力処理を実装します。

  • 日本語(髙橋・﨑山などの旧字体や絵文字含む)が Excel で文字化けしないこと
  • 値の中にカンマ(,)や改行・ダブルクォートが含まれていても列が崩れないこと
  • PHP 8.3 / 8.4 / 8.5 で Deprecated 警告を出さずに php://output へ直接ストリーム出力すること
// 期待するCSV出力(先頭に3バイトのBOM + RFC 4180準拠クォート)
注文ID,顧客名,配送先メモ,金額
ORD-001,"髙橋 太郎","東京都港区1-2-3, A棟",12800
ORD-002,"佐藤 花子","不在時は""宅配BOX""へ",5400

2. ❌ やりがちなNGコード vs ⭕ 実務で使える正解コード

❌ やりがちなNGコード(バグ・警告の原因)Before
<?php
// NG1: 全行をメモリ上の文字列に溜め込むと数万件でメモリ上限エラーになる
$csv = "注文ID,顧客名,配送先メモ,金額\n";
foreach ($orders as $row) {
    // NG2: implode(',') だと値にカンマや改行が含まれた瞬間に列がズレる
    $csv .= implode(',', $row) . "\n";
}
// NG3: Shift_JIS変換は「髙」「﨑」や海外文字・絵文字が「?」に化ける
echo mb_convert_encoding($csv, 'SJIS-win', 'UTF-8');

implode(',', $row) による自作CSVは、住所や備考欄にカンマ・改行が1つ入っただけで列が崩壊します。また、SJIS-win への変換はUTF-8専用の文字が欠落するため、現代の実務ではBOM付きUTF-8が第一選択です。

⭕ コピペで動く実務の正解コード(PHP 8.3/8.4+対応)After
<?php
declare(strict_types=1);

$orders = [
    ['ORD-001', '髙橋 太郎', '東京都港区1-2-3, A棟', 12800],
    ['ORD-002', '佐藤 花子', '不在時は"宅配BOX"へ', 5400],
];

// Webリクエスト時はダウンロード用HTTPヘッダーを送出(CLI検証時はスキップ)
if (PHP_SAPI !== 'cli') {
    header('Content-Type: text/csv; charset=UTF-8');
    header('Content-Disposition: attachment; filename="orders_' . date('Ymd_His') . '.csv"');
    header('X-Content-Type-Options: nosniff');
}

$fp = fopen('php://output', 'wb');
if ($fp === false) {
    throw new RuntimeException('出力ストリームを開けませんでした。');
}

// 1. ExcelがUTF-8と自動認識するためのBOM(3バイト)を先頭に書き込む
fwrite($fp, "\xEF\xBB\xBF");

// 2. ヘッダー行とデータ行を1行ずつストリーム出力(escape: '' でRFC 4180完全準拠)
fputcsv($fp, ['注文ID', '顧客名', '配送先メモ', '金額'], ',', '"', escape: '');

foreach ($orders as $row) {
    fputcsv($fp, $row, ',', '"', escape: '');
}

fclose($fp);

3. 仕様・使い分けの比較早見表

方式 / エンコーディング Excelでの文字化け 旧字体・多言語・絵文字 メモリ消費(10万行時) 実務での推奨度
BOM付きUTF-8 + fputcsv(php://output) しない(自動判別) 完全保持(欠落なし) 最小(1行ずつ逐次出力) ⭕ 最推奨(標準)
Shift_JIS変換(SJIS-win) しない 範圍外の文字が ? に欠落 中〜大(変換バッファ発生) 🔺 レガシー基幹連携のみ
BOMなしUTF-8 Windows版Excelで文字化け 完全保持 最小 ❌ サーバー間API・DBインポート専用
implode(',', $row) 手動連結 BOM次第 カンマ・改行混入で列崩壊 特大(全件メモリ保持) 🚫 絶対禁止

4. 実務でハマりやすい3つの注意点

1PHP 8.4以降は fputcsv に escape: '' を必ず指定する

PHP 8.4から、fputcsv() と fgetcsv() のデフォルト引数($escape = "\\")に依存すると Deprecated 警告が発生します。またバックスラッシュが値の末尾にあるとクォートが壊れるため、名前付き引数で escape: '' を明示して RFC 4180 標準のエスケープ("")に統一してください。

2BOM(\xEF\xBB\xBF)は必ず1行目の前・1回だけ出力する

BOMをループ内で毎回出力したり、header() の前にスペースや改行が出力されていたりすると、CSVの先頭行が壊れたり Cannot modify header information - headers already sent エラーになります。大規模出力時は直前に if (ob_get_level() > 0) { ob_end_clean(); } で出力バッファをクリアすると安全です。

3CSVインジェクション(数式実行)と先頭ゼロ落ちに注意する

ユーザー入力値の先頭が =, +, -, @ で始まる場合、Excelで開いた瞬間に数式として解釈される危険(CSVインジェクション)があります。不特定多数の入力を出力する際は、先頭がこれらの記号ならシングルクォート(')を前置するサニタイズを入れると堅牢です。

5. よくある質問(FAQ)

Q. BOM付きUTF-8のCSVを別のPHPプログラム(fgetcsv)で読み込むとどうなりますか?

1行目・1列目の先頭に目に見えない3バイト(\xEF\xBB\xBF)が付いた状態で読み込まれるため、カラム名比較($header[0] === '注文ID')が false になります。読み込む側は preg_replace('/^\xEF\xBB\xBF/', '', $firstCell) で先頭BOMを除去してから処理してください。

Q. 電話番号(09012345678)や郵便番号の先頭の「0」がExcelで消えるのを防ぐには?

Excelは数字のみのセルを自動的に数値型に変換するため、先頭の 0 が消えます。データ自体にハイフン(090-1234-5678)を入れて文字列として認識させるか、Excelの「データ > テキストまたはCSVから」機能で列のデータ型を「テキスト」に指定して開く案内を添えるのが最も安全です。

Q. Laravelのコントローラーから同様にストリームCSVダウンロードを返すには?

Laravelでは return response()->streamDownload(function () use ($orders) { ... }, 'orders.csv', ['Content-Type' => 'text/csv; charset=UTF-8']); を使い、コールバック関数の中で上記と同じ fopen('php://output', 'wb') と fwrite($fp, "\xEF\xBB\xBF") を実行すれば、メモリを消費せずにそのままダウンロードレスポンスを返せます。