PHP fopen(): открыть, прочитать и записать файл, режимы

fopen('data.txt', 'r') открывает файл и возвращает дескриптор, ресурс потока, который остальные функции для работы с файлами принимают первым аргументом. Читайте через 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 до использования дескриптора. Чтобы прочитать или записать небольшой файл целиком одним вызовом, короче 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 печатает уведомление об устаревании, если аргумент 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+ можно записать файл и прочитать его обратно через тот же дескриптор:

<?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), как во всех остальных примерах на этой странице.