ファイルを読む

ファイルを読む

Lesson 14 / Chapter 2

2 つの読み方を持っておく

<?php
// パターン A: 一発で全部
$text = file_get_contents(__DIR__ . '/tests/data/hello.txt');

// パターン B: 1 行ずつ
$fp = fopen(__DIR__ . '/tests/data/hello.txt', 'r');
while (($line = fgets($fp)) !== false) {
    echo $line;   // $line には末尾の \n も含まれる
}
fclose($fp);

「設定読み込みは A」「ログ走査は B」 くらいの肌感で使い分けると良い。

file_get_contents の挙動

$path = __DIR__ . '/tests/data/hello.txt';
$text = file_get_contents($path);

var_dump($text);
// string(36) "こんにちは
// ファイル読み込みのテスト
// "

• 成功すると ファイル全体を文字列で返す
• 失敗すると false を返す (パス間違い・権限なしなど)
• そのまま echo すれば中身がそのまま出る (末尾改行も含む)

→ 「末尾に \n が含まれてる前提」 で出力を組み立てる。echo $text . "\n" のように追加で改行を足すと 空行が増える 罠あり。

fopen / fgets / fclose の作法

<?php
$fp = fopen(__DIR__ . '/tests/data/hello.txt', 'r');
if ($fp === false) {
    fwrite(STDERR, "open failed\n");
    exit(1);
}

while (($line = fgets($fp)) !== false) {
    // $line には末尾の改行 (\n / \r\n) が含まれる
    echo rtrim($line) . "\n";
}

fclose($fp);

fclose を忘れても PHP 終了時に解放されるが、「開いたら閉じる」 を癖にする。

なぜ fgets のループは while (($line = fgets($fp)) !== false) なのか

// ❌ よくある罠: feof で書くと最後の行を 1 個多く読む
while (!feof($fp)) {
    $line = fgets($fp);   // EOF 直前で fgets が false を返すが、ループは 1 回余分に回る
    echo $line;
}

// ✅ 安全: fgets の戻り値を直接判定
while (($line = fgets($fp)) !== false) {
    echo $line;
}

• feof は 直前の読み取りで EOF を踏んだ後 に true になる → 「false が来てから初めて気づく」
• 戻り値で判定すれば EOF を踏んだ瞬間に抜ける

→ 「fgets の戻り値で判定」を defalut 形として覚える。

パスは __DIR__ から組む

// ❌ NG: cwd (現在ディレクトリ) に依存する
$text = file_get_contents('tests/data/hello.txt');

// ✅ OK: スクリプト自身のディレクトリ基準
$text = file_get_contents(__DIR__ . '/tests/data/hello.txt');

• 採点ランナー (php scripts/grade.php drill/01-read-all/) は リポジトリルートから起動 される
• cwd 相対パスだと、起動位置がズレた瞬間 false (= パス間違い) で落ちる
• __DIR__ を基準 にすれば、どこから呼ばれてもファイルを見つけられる

→ file-io トピックでは 「パスは必ず __DIR__ から組む」 が鉄則。

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

✅ file_get_contents で 1 発でテキストを読める

✅ fopen / fgets / fclose で 1 行ずつ読める

✅ fgets ループは 戻り値判定 (!== false) で書ける

✅ パスは __DIR__ 基準 で組める

✅ 読み込んだ文字列の 末尾改行 を意識して echo できる

→ ドリルへ