fopen() w PHP: otwieranie, odczyt i zapis plików (tryby)

fopen('data.txt', 'r') otwiera plik i zwraca uchwyt, czyli zasób strumienia, który pozostałe funkcje plikowe przyjmują jako pierwszy argument. Czytaj przez fgets() (jedna linia) albo fread() (określona liczba bajtów), zapisuj przez fwrite(), a zamykaj przez fclose(). Drugi argument to tryb: 'r' do odczytu, 'w' do zapisu, 'a' do dopisywania.

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

Wynik:

Got: apple
Got: banana
Got: cherry

fopen() zwraca false, gdy nie może otworzyć pliku (nie istnieje w trybie r, brakuje folderu, brak uprawnień), a PHP wypisuje ostrzeżenie, na przykład:

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

Dlatego przed użyciem uchwytu sprawdź, czy nie jest false. Do odczytu lub zapisu całego małego pliku jednym wywołaniem krótsze są file_get_contents() i file_put_contents(); fopen() służy do plików czytanych po kawałku albo trzymanych otwartych.

Tryby fopen

Dwa wiersze zaskakują. r+ nadpisuje istniejące bajty w miejscu, bez wstawiania, a a+ zawsze zapisuje na końcu, nawet po przesunięciu wskaźnika przez fseek() (przesunięcie wpływa tylko na odczyt):

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

Wynik:

Xbc
Xbc
Xbc
end

W Windows możesz zobaczyć 'rb' albo 'wb': flaga b oznacza tryb binarny i powstrzymuje Windows przed tłumaczeniem końców linii. W Linuksie i macOS nic nie robi, więc jej dodanie jest nieszkodliwe i przenośne.

Odczyt pliku linia po linii przez fgets()

fgets() zwraca następną linię razem z jej \n, a na końcu pliku false. Ponieważ w pamięci jest naraz tylko jedna linia, ta pętla obsłuży plik logu dowolnego rozmiaru, a przez break możesz zakończyć wcześniej:

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

Wynik:

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

Porównuj z false przez !==, a nie zwykłym while ($line = fgets($fh)): linia zawierająca tylko "0" bez znaku nowej linii (taka może być ostatnia linia pliku) jest traktowana jak fałsz i zakończyłaby pętlę przedwcześnie.

Zapis i dopisywanie przez fwrite()

fwrite() zapisuje string w bieżącej pozycji i zwraca liczbę zapisanych bajtów albo false przy błędzie. fputs() to ta sama funkcja pod inną nazwą. Otwórz z 'a', aby dopisywać na końcu pliku bez ruszania tego, co już w nim jest:

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

Wynik:

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

PHP_EOL to znak końca linii systemu, na którym działa PHP (\n w Linuksie i macOS, \r\n w Windows). W plikach czytanych przez inne programy wybierz jeden jawnie, zwykle "\n".

Odczyt i zapis plików CSV przez fgetcsv() i fputcsv()

fputcsv() zapisuje tablicę jako jeden wiersz CSV i otacza cudzysłowami pola zawierające przecinki, cudzysłowy lub znaki nowej linii. fgetcsv() odczytuje jeden wiersz z powrotem jako tablicę. Przekazuj jawnie separator, znak otaczający i pusty znak ucieczki: daje to standardowy CSV, a PHP 8.4 wypisuje komunikat o przestarzałym użyciu, gdy argument ucieczki zostanie pominięty.

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

Wynik:

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

Dzielenie linii przez explode(',', $line) psuje się, gdy tylko pole zawiera przecinek; fgetcsv() obsługuje cudzysłowy za ciebie. Dla pliku rozdzielanego średnikami (częstego w eksportach z Excela w Europie, także w Polsce) przekaż ';' jako separator.

Poruszanie się po pliku przez fseek(), ftell() i rewind()

Otwarty plik ma pozycję. Odczyty i zapisy zaczynają się w niej i przesuwają ją do przodu. ftell() mówi, gdzie jest, fseek() przesuwa ją do przesunięcia w bajtach, a rewind() wraca na początek. Z w+ możesz zapisać plik i odczytać go przez ten sam uchwyt:

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

Wynik:

11
world
hello world

Blokowanie pliku przez flock()

Dwa żądania, które w tej samej chwili odczytują licznik, dodają jeden i zapisują go z powrotem, mogą oba odczytać 41 i oba zapisać 42. flock() z LOCK_EX każe drugiemu czekać, aż pierwsze zwolni blokadę. Właściwy jest tu tryb c+: tworzy plik w razie potrzeby i, w przeciwieństwie do w+, nie opróżnia go, zanim założysz blokadę.

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

Wynik:

Visitor number 1
Visitor number 2
Visitor number 3

Blokady są doradcze: zatrzymują tylko inny kod, który też wywołuje flock(). Do dopisania jednej linii file_put_contents($path, $line, FILE_APPEND | LOCK_EX) robi to samo jednym wywołaniem.

Częsty błąd: while (!feof($fh))

Wiele starych poradników używa pętli z feof(). Zwraca ono true dopiero wtedy, gdy odczyt już trafił na koniec, więc pętla wykonuje się o jeden raz więcej, niż jest linii, a ostatnie fgets() zwraca 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";

Wynik:

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

To dodatkowe false staje się pustym wierszem w raporcie albo pustym elementem w tablicy. Steruj pętlą samym odczytem, while (($line = fgets($fh)) !== false), jak robi każdy inny przykład na tej stronie.