ファイルに書く

ファイルに書く

Lesson 14 / Chapter 3

書き込みも 2 系統

<?php
// パターン A: 一発で書く
$tmp = tempnam(sys_get_temp_dir(), 'dojo_');
file_put_contents($tmp, "Hello, File!\n");

// パターン B: fopen → fwrite → fclose
$fp = fopen($tmp, 'w');     // 'w' = 上書きモード
fwrite($fp, "line1\n");
fwrite($fp, "line2\n");
fclose($fp);

unlink($tmp);   // クリーンアップ

file-io トピックでは 大半が A で十分。B は慣れのため一度書く。

書き込み先は OS の一時ディレクトリへ

// ✅ OK: 一時ディレクトリ
$tmp = tempnam(sys_get_temp_dir(), 'dojo_');
file_put_contents($tmp, "hi\n");
unlink($tmp);

// ❌ NG: drill 内に書く (リポジトリが汚れる)
file_put_contents(__DIR__ . '/output.txt', "hi\n");

• sys_get_temp_dir() = OS の一時領域 (Mac/Linux なら /tmp)
• tempnam($dir, $prefix) = その中に 被らないファイル名 を作って返す (ゼロバイトの空ファイル付き)
• unlink($path) = ファイルを消す

→ 「採点が何度走っても、リポジトリの状態が変わらない」 のがゴール。

file_put_contents の典型形

<?php
$tmp = tempnam(sys_get_temp_dir(), 'dojo_');

// 上書き (デフォルト)
$bytes = file_put_contents($tmp, "Hello, File!\n");
echo "wrote {$bytes} bytes\n";   // wrote 13 bytes

// 読み返して確認
echo file_get_contents($tmp);    // Hello, File!

unlink($tmp);

• 戻り値は 書いたバイト数 (失敗時 false)
• ファイルが既にあれば デフォルトで上書き
• 第 3 引数で挙動を変えられる (FILE_APPEND / LOCK_EX など)

追記モード — FILE_APPEND

<?php
$tmp = tempnam(sys_get_temp_dir(), 'dojo_');

file_put_contents($tmp, "line1\n");                  // 中身: "line1\n"
file_put_contents($tmp, "line2\n", FILE_APPEND);     // 中身: "line1\nline2\n"
file_put_contents($tmp, "line3\n", FILE_APPEND);     // 中身: "line1\nline2\nline3\n"

echo file_get_contents($tmp);
// line1
// line2
// line3

unlink($tmp);

• FILE_APPEND を渡すと 末尾に追記 (元の中身を保つ)
• 渡さないと 上書き (前の中身は消える)

→ ログ書き込みは FILE_APPEND | LOCK_EX のセットが定番。

fopen のモード一覧 (主要なもの)

$fp = fopen($tmp, 'a');     // 追記モード
fwrite($fp, "extra line\n");
fclose($fp);

「w は中身を消す」 が一番の落とし穴。設定ファイルを 'w' で開いて空にしてしまう事故が定番。

書いたら必ず読み返して検算

<?php
$tmp = tempnam(sys_get_temp_dir(), 'dojo_');

// 書く
file_put_contents($tmp, "Hello, File!\n");

// 読む (= 書いた内容を検算)
echo file_get_contents($tmp);

// 後始末
unlink($tmp);

• 採点では 「書いたものを読み返した結果」 を expected.txt と比べる
• 「書いた」と「保存できた」は 別物。fclose / file_put_contents の戻り値で確認する癖を

→ ドリル 01 はこの 「書く → 読む → 消す」のラウンドトリップ を体験する形。

このチャプターでできるようになること

✅ file_put_contents でファイルに 1 発で書ける

✅ fopen('w') + fwrite + fclose で書ける

✅ FILE_APPEND / fopen('a') で追記できる

✅ 'w' モードは 既存の中身を消す ことを認識している

✅ 書き込み先は sys_get_temp_dir() 配下にして unlink で消す癖がついた

→ ドリルへ