Работа с файлами: способы изменения содержимого в PHP

Расширенные примеры обновления файлов в PHP

Пример 1. Замена строки по номеру с сохранением окончаний строк (PHP_EOL)

<?php
$file = 'users.csv';
$recordNumber = 3; // нумерация с 0
$newRecord = "Иван,Иванов,25";

$handle = fopen($file, 'c+');
$currentLine = 0;
$buffer = '';

while (($line = fgets($handle)) !== false) {
    if ($currentLine == $recordNumber) {
        // заменяем строку (сохраняем её длину – но это не обязательно, так как мы будем перезаписывать весь файл)
        $buffer .= $newRecord . PHP_EOL;
    } else {
        $buffer .= $line;
    }
    $currentLine++;
}

rewind($handle);
ftruncate($handle, 0);
fwrite($handle, $buffer);
fclose($handle);
?>

Результат: в файле users.csv третья строка (индекс 3) заменена на "Иван,Иванов,25".

Пример 2. Безопасное обновление с блокировкой и проверкой ошибок

<?php
$file = 'state.json';
$dataToWrite = [
    'status' => 'active',
    'updated' => time()
];
$json = json_encode($dataToWrite, JSON_PRETTY_PRINT);

$tempFile = $file . '.tmp';
if (file_put_contents($tempFile, $json, LOCK_EX) === false) {
    throw new Exception('Не удалось записать временный файл');
}
// Атомарная замена
if (!rename($tempFile, $file)) {
    unlink($tempFile);
    throw new Exception('Не удалось переименовать временный файл');
}
?>

Результат: файл state.json обновлён атомарно. Даже если скрипт прервётся во время записи, оригинальный файл останется целым.

Пример 3. Обновление только первой строки (замена заголовка)

<?php
$file = 'report.csv';
// Читаем все строки, заменяем первую
$lines = file($file, FILE_IGNORE_NEW_LINES);
if (!empty($lines)) {
    $lines[0] = 'id,name,date'; // новый заголовок
}
file_put_contents($file, implode(PHP_EOL, $lines), LOCK_EX);
?>

Результат: первая строка файла report.csv стала 'id,name,date', остальные строки без изменений.

Пример 4. Многократное обновление с помощью потоков и фильтров (php://filter)

<?php
$file = 'text.txt';
// Заменить все вхождения "foo" на "bar" без загрузки в память
// Используем php://filter с read=convert.base64-encode? но лучше stream_filter_append
$in = fopen($file, 'r');
$out = fopen('php://temp', 'w+');
stream_filter_append($out, 'convert.base64-encode'); // пример фильтра

while (($line = fgets($in)) !== false) {
    fwrite($out, str_replace('foo', 'bar', $line));
}
rewind($out);
$newContent = stream_get_contents($out);
fclose($in);
fclose($out);
// Далее можно записать $newContent обратно, но для больших файлов лучше использовать временный файл
?>

Этот пример демонстрирует использование потоков для трансформации данных. В реальности для замены строк проще применить str_replace.

Результат: все вхождения "foo" заменены на "bar" (но текст внутри примера не показан из-за работы с php://temp).

Пример 5. Обновление сериализованных данных (например, файла сессий)

<?php
$file = 'session_data.txt';
// Чтение сериализованной структуры
$content = file_get_contents($file);
$data = unserialize($content);
// Изменяем данные
$data['counter'] = isset($data['counter']) ? $data['counter'] + 1 : 1;
// Записываем обратно
$newContent = serialize($data);
file_put_contents($file, $newContent, LOCK_EX);
?>

Результат: счётчик в данных увеличился на 1, файл обновлён. Важно: несериализованные данные могут стать причиной ошибок.