Применение try-catch для надёжного управления файлами в PHP

Расширенные примеры использования try-catch с файлами

1. Вложенные блоки try-catch для транзакционного обновления файла

Может потребоваться атомарная операция: прочитать старый файл, обработать данные, записать новый. Если на любом этапе ошибка – откат.

$oldFile = 'data.json';
$backupFile = 'data.json.bak';

try {
    // Сначала читаем существующий файл
    try {
        $json = file_get_contents($oldFile);
        $data = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
    } catch (JsonException $e) {
        throw new Exception('Неверный формат JSON: ' . $e->getMessage());
    }

    // Изменяем данные
    $data['updated'] = time();

    // Создаём резервную копию
    if (!copy($oldFile, $backupFile)) {
        throw new Exception('Не удалось создать резервную копию');
    }

    // Записываем новые данные во временный файл
    $tmpFile = $oldFile . '.tmp';
    $bytesWritten = file_put_contents($tmpFile, json_encode($data, JSON_PRETTY_PRINT));
    if ($bytesWritten === false) {
        throw new Exception('Ошибка записи во временный файл');
    }

    // Атомарное переименование
    if (!rename($tmpFile, $oldFile)) {
        throw new Exception('Не удалось заменить исходный файл');
    }

    echo 'Файл успешно обновлён.';
} catch (Exception $e) {
    // Откат: восстанавливаем резервную копию, если она была создана
    if (file_exists($backupFile)) {
        rename($backupFile, $oldFile);
    }
    echo 'Ошибка обновления: ' . $e->getMessage();
} finally {
    // Удаляем временный файл, если остался
    if (isset($tmpFile) && file_exists($tmpFile)) {
        unlink($tmpFile);
    }
}

При успешном выполнении:
Файл успешно обновлён.
При ошибке копирования:
Ошибка обновления: Не удалось создать резервную копию

2. Работа с потоками (streams) и исключениями

Файловые операции могут использовать обёртки потоков (php://input, ftp:// и т.п.). Исключения помогут обрабатывать сетевые сбои.

try {
    $stream = fopen('https://example.com/data.csv', 'r');
    if (!$stream) {
        throw new RuntimeException('Не удалось открыть поток');
    }
    stream_set_timeout($stream, 5);
    $line = fgets($stream);
    if ($line === false) {
        throw new RuntimeException('Ошибка чтения строки из потока');
    }
    echo 'Первая строка: ' . htmlspecialchars($line);
} catch (RuntimeException $e) {
    echo 'Проблема с потоком: ' . $e->getMessage();
} finally {
    if (isset($stream) && is_resource($stream)) {
        fclose($stream);
    }
}

При недоступности сервера:
Проблема с потоком: Не удалось открыть поток

3. Комбинация типов исключений при использовании SPL-классов для работы с файлами

Классы SplFileObject, SplFileInfo и подобные могут выбрасывать RuntimeException и LogicException. Пример.

try {
    $fileInfo = new SplFileInfo('/etc/passwd');
    if (!$fileInfo->isReadable()) {
        throw new RuntimeException('Файл недоступен для чтения');
    }
    $fileObj = $fileInfo->openFile('r');
    while (!$fileObj->eof()) {
        echo $fileObj->fgets();
    }
} catch (RuntimeException $e) {
    echo 'Ошибка при работе с файлом: ' . $e->getMessage();
} catch (LogicException $e) {
    echo 'Логическая ошибка в пути: ' . $e->getMessage();
}

При недостаточных правах:
Ошибка при работе с файлом: Файл недоступен для чтения

4. Использование finally для логирования

В блоке finally можно записывать информацию о выполненных операциях, не влияя на исключение.

$logger = function($message) {
    file_put_contents('app.log', $message . PHP_EOL, FILE_APPEND);
};

try {
    // открываем файл
    $fh = fopen('report.txt', 'a');
    fwrite($fh, 'Запись от ' . date('Y-m-d H:i:s') . PHP_EOL);
} catch (Exception $e) {
    $logger('Ошибка записи: ' . $e->getMessage());
    throw $e; // пробрасываем дальше
} finally {
    if (isset($fh) && is_resource($fh)) {
        fclose($fh);
        $logger('Файл report.txt закрыт');
    }
}

В app.log:
Файл report.txt закрыт