fopen() ב-PHP: פתיחה, קריאה וכתיבה של קבצים (המצבים)

fopen('data.txt', 'r') פותחת קובץ ומחזירה handle, משאב stream שפונקציות הקבצים האחרות מקבלות כארגומנט הראשון שלהן. קוראים עם fgets() (שורה אחת) או fread() (מספר בתים), כותבים עם fwrite(), וסוגרים עם fclose(). הארגומנט השני הוא המצב: 'r' לקריאה, 'w' לכתיבה, 'a' להוספה.

<?php
$fh = fopen('fruits.txt', 'w');          // create or empty the file
fwrite($fh, "apple\n");
fwrite($fh, "banana\n");
fwrite($fh, "cherry\n");
fclose($fh);

$fh = fopen('fruits.txt', 'r');
if ($fh === false) {
    exit("Cannot open fruits.txt\n");
}

while (($line = fgets($fh)) !== false) {
    echo 'Got: ', rtrim($line), "\n";
}
fclose($fh);

פלט:

Got: apple
Got: banana
Got: cherry

fopen() מחזירה false כשהיא לא יכולה לפתוח את הקובץ (הוא לא קיים במצב r, תיקייה חסרה, אין הרשאה), ו-PHP מדפיסה אזהרה כמו:

Warning: fopen(missing.txt): Failed to open stream: No such file or directory in /home/index.php on line 2

לכן בדקו false לפני שמשתמשים ב-handle. לקריאה או כתיבה של קובץ קטן שלם בקריאה אחת, file_get_contents() ו-file_put_contents() קצרות יותר; fopen() נועדה לקבצים שקוראים חלק אחר חלק או משאירים פתוחים.

מצבי fopen

שתי שורות מפתיעות אנשים. r+ כותב על הבתים הקיימים במקומם, בלי להכניס, ו-a+ תמיד כותב בסוף, גם אחרי שמזיזים את המצביע עם fseek() (ההזזה משפיעה רק על קריאות):

<?php
file_put_contents('letters.txt', "abc\n");

$fh = fopen('letters.txt', 'r+');
fwrite($fh, 'X');                  // overwrites the "a"
fclose($fh);
echo file_get_contents('letters.txt');

$fh = fopen('letters.txt', 'a+');
fseek($fh, 0);                     // back to the start...
fwrite($fh, "end\n");              // ...but the write still goes to the end
rewind($fh);
echo fgets($fh);                   // reads do start at the beginning
fclose($fh);
echo file_get_contents('letters.txt');

פלט:

Xbc
Xbc
Xbc
end

ב-Windows אפשר לראות 'rb' או 'wb': הדגל b פירושו בינארי ומונע מ-Windows לתרגם סופי שורות. הוא לא עושה כלום ב-Linux וב-macOS, ולכן הוספה שלו לא מזיקה וניידת.

קריאת קובץ שורה אחר שורה עם fgets()

fgets() מחזירה את השורה הבאה כולל ה-\n שלה, ו-false בסוף הקובץ. כיוון שרק שורה אחת נמצאת בזיכרון בכל רגע, הלולאה הזו מטפלת בקובץ לוג בכל גודל, ואפשר לעצור מוקדם עם break:

<?php
file_put_contents('app.log', <<<LOG
2026-03-14 09:00:01 INFO  server started
2026-03-14 09:00:05 ERROR database timeout
2026-03-14 09:01:12 INFO  request /home
2026-03-14 09:02:40 ERROR disk full
2026-03-14 09:03:00 INFO  request /about
LOG);

$fh = fopen('app.log', 'r');
$number = 0;
$errors = [];

while (($line = fgets($fh)) !== false) {
    $number++;
    if (str_contains($line, 'ERROR')) {
        $errors[] = "line $number: " . trim(substr($line, 26));
    }
}
fclose($fh);

echo count($errors), " errors in $number lines\n";
echo implode("\n", $errors), "\n";

פלט:

2 errors in 5 lines
line 2: database timeout
line 4: disk full

השוו ל-false עם !==, לא עם while ($line = fgets($fh)) פשוט: שורה שמכילה רק "0" בלי ירידת שורה (השורה האחרונה של קובץ יכולה להיות כזו) היא שקרית והייתה מסיימת את הלולאה מוקדם.

כתיבה והוספה עם fwrite()

fwrite() כותבת מחרוזת במיקום הנוכחי ומחזירה את מספר הבתים שנכתבו, או false בכישלון. fputs() היא אותה פונקציה בשם אחר. פתחו עם 'a' כדי להוסיף לסוף קובץ בלי לגעת במה שכבר שם:

<?php
$fh = fopen('visits.log', 'a');
foreach (['/home', '/about', '/contact'] as $page) {
    $bytes = fwrite($fh, "visit $page" . PHP_EOL);
    echo "wrote $bytes bytes\n";
}
fclose($fh);

$fh = fopen('visits.log', 'a');      // open again: the old lines stay
fwrite($fh, 'visit /home' . PHP_EOL);
fclose($fh);

echo file_get_contents('visits.log');

פלט:

wrote 12 bytes
wrote 13 bytes
wrote 15 bytes
visit /home
visit /about
visit /contact
visit /home

PHP_EOL הוא סוף השורה של המערכת ש-PHP רצה עליה (\n ב-Linux וב-macOS, \r\n ב-Windows). לקבצים שתוכנות אחרות קוראות, בחרו אחד במפורש, בדרך כלל "\n".

קריאה וכתיבה של קובצי CSV עם fgetcsv() ו-fputcsv()

fputcsv() כותבת מערך כשורת CSV אחת ועוטפת במירכאות שדות שמכילים פסיקים, מירכאות או ירידות שורה. fgetcsv() קוראת שורה אחת בחזרה כמערך. העבירו את המפריד, את תו העטיפה ותו escape ריק במפורש: זה נותן CSV סטנדרטי, ו-PHP 8.4 מדפיסה הודעת deprecation כשמשמיטים את ארגומנט ה-escape.

<?php
$rows = [
    ['name', 'city', 'note'],
    ['Ada', 'London', 'likes "math", a lot'],
    ['Linus', 'Helsinki', 'kernel'],
];

$fh = fopen('people.csv', 'w');
foreach ($rows as $row) {
    fputcsv($fh, $row, ',', '"', '');
}
fclose($fh);
echo file_get_contents('people.csv'), "\n";

// Read it back, using the first row as keys
$fh = fopen('people.csv', 'r');
$header = fgetcsv($fh, null, ',', '"', '');
while (($fields = fgetcsv($fh, null, ',', '"', '')) !== false) {
    $person = array_combine($header, $fields);
    echo "{$person['name']} lives in {$person['city']}: {$person['note']}\n";
}
fclose($fh);

פלט:

name,city,note
Ada,London,"likes ""math"", a lot"
Linus,Helsinki,kernel

Ada lives in London: likes "math", a lot
Linus lives in Helsinki: kernel

פיצול שורות עם explode(',', $line) נשבר ברגע ששדה מכיל פסיק; fgetcsv() מטפלת בעטיפה בשבילכם. לקובץ מופרד בנקודה פסיק (נפוץ בייצוא מ-Excel באירופה), העבירו ';' כמפריד.

תנועה בתוך קובץ עם fseek(), ftell() ו-rewind()

לקובץ פתוח יש מיקום. קריאות וכתיבות מתחילות שם ומזיזות אותו קדימה. ftell() אומרת לכם איפה הוא, fseek() מזיזה אותו להיסט בבתים, ו-rewind() חוזרת להתחלה. עם w+ אפשר לכתוב קובץ ולקרוא אותו בחזרה דרך אותו handle:

<?php
$fh = fopen('message.txt', 'w+');
fwrite($fh, 'hello world');
echo ftell($fh), "\n";             // after the last byte written

fseek($fh, 6);
echo fread($fh, 5), "\n";          // 5 bytes from offset 6

rewind($fh);
echo stream_get_contents($fh), "\n";  // everything from the position to the end
fclose($fh);

פלט:

11
world
hello world

נעילת קובץ עם flock()

שתי בקשות שקוראות מונה, מוסיפות אחד וכותבות אותו בחזרה באותו זמן יכולות לקרוא שתיהן 41 ולכתוב שתיהן 42. flock() עם LOCK_EX גורמת לשנייה לחכות עד שהראשונה משחררת את הנעילה. המצב c+ הוא הנכון כאן: הוא יוצר את הקובץ אם צריך, ובניגוד ל-w+, לא מרוקן אותו לפני שמחזיקים בנעילה.

<?php
function increment(string $path): int
{
    $fh = fopen($path, 'c+');
    flock($fh, LOCK_EX);               // wait for exclusive access

    $count = (int) stream_get_contents($fh);
    $count++;

    ftruncate($fh, 0);                 // empty the file
    rewind($fh);
    fwrite($fh, (string) $count);
    fflush($fh);

    flock($fh, LOCK_UN);
    fclose($fh);
    return $count;
}

for ($i = 0; $i < 3; $i++) {
    echo 'Visitor number ', increment('counter.txt'), "\n";
}

פלט:

Visitor number 1
Visitor number 2
Visitor number 3

נעילות הן מייעצות: הן עוצרות רק קוד אחר שגם קורא ל-flock(). להוספת שורה אחת, file_put_contents($path, $line, FILE_APPEND | LOCK_EX) עושה את אותו הדבר בקריאה אחת.

טעות נפוצה: while (!feof($fh))

מדריכים ישנים רבים עוברים בלולאה עם feof(). היא מחזירה true רק אחרי שקריאה כבר הגיעה לסוף, ולכן הלולאה רצה פעם אחת יותר ממספר השורות וה-fgets() האחרון מחזיר false:

<?php
file_put_contents('abc.txt', "a\nb\nc\n");

$fh = fopen('abc.txt', 'r');
$rounds = 0;
while (!feof($fh)) {
    $line = fgets($fh);
    $rounds++;
    var_dump($line);
}
fclose($fh);
echo "$rounds rounds for 3 lines\n";

פלט:

string(2) "a
"
string(2) "b
"
string(2) "c
"
bool(false)
4 rounds for 3 lines

ה-false העודף הזה הופך לשורה ריקה בדוח או לאיבר ריק במערך. עברו בלולאה על הקריאה עצמה, while (($line = fgets($fh)) !== false), כמו שכל דוגמה אחרת בעמוד הזה עושה.