概要

CSV (Comma-Separated Values) は「カンマで区切ったテキスト形式」のシンプルな表形式データ。エクセルや分析ツールなどデータ交換のデファクト。だが「カンマで explode すれば OK」と自前実装すると、値にカンマが含まれる ("山田, 太郎") ケースや、ダブルクォートで囲まれた値で必ず破綻する。エスケープ仕様が地味に複雑、というのが落とし穴。

そこで PHP の fgetcsv() / fputcsv() を使う。ダブルクォート囲み・カンマエスケープを きちんと処理 してくれる正解関数。fgetcsv($fp) は 1 行読んで 数値添字の配列 ([0] => id, [1] => name, ...) を返す。連想配列ではないので、列の順番を頭で覚えておく必要がある。書き込みは fputcsv($fp, ['1', '太郎', '20']) のように配列を渡すだけ。

PHP 8.4 以降、fgetcsv / fputcsv の $escape 引数の挙動が変わり、明示的に '' を指定しないと deprecation 警告 が出る。歴史的なバックスラッシュ・エスケープが標準 CSV 仕様と違っていた混乱を正す変更で、現代の PHP では fgetcsv($fp, 0, ',', '"', '') と 第 5 引数を空文字で明示 するのが推奨形。本コースの解答例もこの形。

学習目標

• fgetcsv() で CSV を 行 × 列の配列 として読める
• fputcsv() で 配列を CSV の 1 行 として書ける
• CSV のヘッダ行 (id,name,age) を切り離して、データ行だけを処理できる
• 書き込みは 一時ファイル で完結させ、読み返して検算できる

ドリル

確認のコツ

• fgetcsv は 数値添字の配列 を返す (連想配列ではない)。[0] = id, [1] = name, [2] = age のように 列の順番 で取り出す
• ヘッダ行は 最初の 1 回だけ別扱い にして、本体ループに混ぜない
• 書き込みは fputcsv($fp, ['1', '太郎', '20']) のように 配列を 1 行ずつ 渡す

問題

__DIR__ . '/tests/data/users.csv' を読み、各データ行を "id: name (age歳)" の形式で出力してください。

データファイル (tests/data/users.csv):

id,name,age
1,太郎,20
2,花子,25
3,次郎,30

期待される出力:

1: 太郎 (20歳)
2: 花子 (25歳)
3: 次郎 (30歳)

(1 行目のヘッダ id,name,age は出力に含めない)

ヒント

$fp = fopen(__DIR__ . '/tests/data/users.csv', 'r');
$header = fgetcsv($fp, 0, ',', '"', '');   // 1 行目を読み捨てる
while (($row = fgetcsv($fp, 0, ',', '"', '')) !== false) {
    [$id, $name, $age] = $row;
    echo "{$id}: {$name} ({$age}歳)\n";
}
fclose($fp);

• fgetcsv は 1 行を配列で返す (数値添字)。[0]=id, [1]=name, [2]=age
• ヘッダ行は ループに入る前に 1 回だけ読み捨てる
• 配列の分配代入 [$a, $b, $c] = $row; で列を変数に取り出せる (PHP 7.1+)
• 第 2〜5 引数 (length, separator, enclosure, escape) を明示 — PHP 8.4 以降 で警告が出るのを防ぐ

つまづいたら

• 出力の 1 行目が "id: name (age歳)" になる → ヘッダ行を 読み捨てていない。ループに入る前に fgetcsv($fp) を 1 回呼ぶ
• age が "20歳" ではなく "20.0歳" になる → (float) キャストや number_format を使っている。fgetcsv の値は 文字列のまま で OK

問題

次の配列を 一時 CSV ファイル に書き出し、その CSV を 読み返して 各行を " | " で結合して 1 行ずつ出力してください。最後に一時ファイルを unlink で消します。

書き出す配列:

$rows = [
    ['id', 'name', 'score'],
    [1, '太郎', 80],
    [2, '花子', 95],
    [3, '次郎', 60],
];

期待される出力 (書き出した CSV を読み返した結果):

id | name | score
1 | 太郎 | 80
2 | 花子 | 95
3 | 次郎 | 60

ヒント

$tmp = tempnam(sys_get_temp_dir(), 'dojo_csv_');

// 書く
$fp = fopen($tmp, 'w');
foreach ($rows as $row) {
    fputcsv($fp, $row, ',', '"', '');
}
fclose($fp);

// 読み返す
$fp = fopen($tmp, 'r');
while (($row = fgetcsv($fp, 0, ',', '"', '')) !== false) {
    echo implode(' | ', $row) . "\n";
}
fclose($fp);

unlink($tmp);

• fputcsv($fp, $row, ',', '"', '') で 配列を 1 行の CSV にして書く
• 読み返しは fgetcsv で 行ごとの配列に戻る → implode(' | ', $row) で表示用に結合
• 書き込みは sys_get_temp_dir() 配下、最後に unlink で消す

つまづいたら

• 出力が id | name | score ではなく id|name|score (空白なし) になる → implode(' | ', $row) のセパレータが '|' になっている。前後に空白付きの " | " にする
• Deprecated 警告が出る → fgetcsv / fputcsv の引数を省略している。第 2〜5 引数を明示 (fgetcsv($fp, 0, ',', '"', '') / fputcsv($fp, $row, ',', '"', ''))
• 1 行多い・少ない → 「書いた配列」と「読み返した結果」は本来一致する。fputcsv を呼び忘れた / fclose を忘れて flush されていない