PHP fopen(): Dateien öffnen, lesen, schreiben (Modi)

fopen('data.txt', 'r') öffnet eine Datei und liefert ein Handle, eine Stream-Ressource, die die anderen Dateifunktionen als erstes Argument nehmen. Du liest mit fgets() (eine Zeile) oder fread() (eine Anzahl Bytes), schreibst mit fwrite() und schließt mit fclose(). Das zweite Argument ist der Modus: 'r' zum Lesen, 'w' zum Schreiben, 'a' zum Anhängen.

<?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);

Ausgabe:

Got: apple
Got: banana
Got: cherry

fopen() liefert false, wenn es die Datei nicht öffnen kann (sie existiert im Modus r nicht, ein Ordner fehlt, keine Berechtigung), und PHP gibt eine Warnung aus wie:

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

Prüfe also auf false, bevor du das Handle verwendest. Um eine ganze kleine Datei mit einem Aufruf zu lesen oder zu schreiben, sind file_get_contents() und file_put_contents() kürzer; fopen() ist für Dateien, die du stückweise liest oder offen hältst.

fopen-Modi

Zwei Zeilen überraschen. r+ überschreibt die vorhandenen Bytes an Ort und Stelle, ohne einzufügen, und a+ schreibt immer ans Ende, auch nachdem du den Zeiger mit fseek() bewegt hast (das Verschieben wirkt nur aufs Lesen):

<?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');

Ausgabe:

Xbc
Xbc
Xbc
end

Unter Windows siehst du vielleicht 'rb' oder 'wb': Das Flag b bedeutet binär und verhindert, dass Windows Zeilenenden übersetzt. Unter Linux und macOS bewirkt es nichts, es hinzuzufügen ist also harmlos und portabel.

Eine Datei mit fgets() Zeile für Zeile lesen

fgets() liefert die nächste Zeile einschließlich ihres \n und am Dateiende false. Weil immer nur eine Zeile im Speicher liegt, kommt diese Schleife mit einer Logdatei jeder Größe zurecht, und du kannst mit break früh aufhören:

<?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";

Ausgabe:

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

Vergleiche mit !== auf false, nicht mit einem einfachen while ($line = fgets($fh)): Eine Zeile, die nur "0" ohne Zeilenumbruch enthält (die letzte Zeile einer Datei kann so eine sein), ist falsy und würde die Schleife zu früh beenden.

Mit fwrite() schreiben und anhängen

fwrite() schreibt einen String an der aktuellen Position und liefert die Anzahl der geschriebenen Bytes oder false bei einem Fehler. fputs() ist dieselbe Funktion unter anderem Namen. Öffne mit 'a', um ans Ende einer Datei anzuhängen, ohne anzurühren, was dort steht:

<?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');

Ausgabe:

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

PHP_EOL ist das Zeilenende des Systems, auf dem PHP läuft (\n unter Linux und macOS, \r\n unter Windows). Für Dateien, die andere Programme lesen, wählst du eines ausdrücklich, meist "\n".

CSV-Dateien mit fgetcsv() und fputcsv() lesen und schreiben

fputcsv() schreibt ein Array als eine CSV-Zeile und setzt Felder mit Kommas, Anführungszeichen oder Zeilenumbrüchen in Anführungszeichen. fgetcsv() liest eine Zeile als Array zurück. Übergib Trennzeichen, Einschlusszeichen und ein leeres Escape-Zeichen ausdrücklich: Das ergibt Standard-CSV, und PHP 8.4 gibt einen Deprecation-Hinweis aus, wenn das Escape-Argument fehlt.

<?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);

Ausgabe:

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

Zeilen mit explode(',', $line) aufzuteilen, scheitert, sobald ein Feld ein Komma enthält; fgetcsv() erledigt die Anführungszeichen für dich. Für eine Datei mit Semikolon als Trennzeichen (in Europa üblich bei Excel-Exporten) übergibst du ';' als Trennzeichen.

Mit fseek(), ftell() und rewind() in einer Datei bewegen

Eine geöffnete Datei hat eine Position. Lese- und Schreibvorgänge beginnen dort und schieben sie weiter. ftell() sagt dir, wo sie steht, fseek() verschiebt sie zu einem Byte-Offset, und rewind() geht zurück an den Anfang. Mit w+ kannst du eine Datei schreiben und über dasselbe Handle zurücklesen:

<?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);

Ausgabe:

11
world
hello world

Eine Datei mit flock() sperren

Zwei Anfragen, die gleichzeitig einen Zähler lesen, eins addieren und zurückschreiben, können beide 41 lesen und beide 42 schreiben. flock() mit LOCK_EX lässt die zweite warten, bis die erste die Sperre freigibt. Der Modus c+ ist hier der richtige: Er legt die Datei bei Bedarf an und leert sie, anders als w+, nicht, bevor du die Sperre hältst.

<?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";
}

Ausgabe:

Visitor number 1
Visitor number 2
Visitor number 3

Sperren sind nur beratend: Sie halten nur anderen Code auf, der ebenfalls flock() aufruft. Um eine Zeile anzuhängen, macht file_put_contents($path, $line, FILE_APPEND | LOCK_EX) dasselbe in einem Aufruf.

Typischer Fehler: while (!feof($fh))

Viele alte Tutorials laufen mit feof() in einer Schleife. Es liefert erst true, nachdem ein Lesevorgang schon auf das Ende gestoßen ist, also läuft die Schleife einmal öfter, als es Zeilen gibt, und das letzte fgets() liefert 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";

Ausgabe:

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

Dieses zusätzliche false wird zu einer leeren Zeile in einem Bericht oder einem leeren Element in einem Array. Steuere die Schleife über den Lesevorgang selbst, while (($line = fgets($fh)) !== false), wie es jedes andere Beispiel auf dieser Seite tut.