Типичные неполадки при файловом вводе-выводе и методы их решения

Расширенные примеры работы с файлами и обработки ошибок

Пример 1. Чтение удалённого файла через cURL с обработкой ошибок

$url = 'https://example.com/data.json';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

$response = curl_exec($ch);
$error = curl_error($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($error) {
    echo 'cURL ошибка: ' . $error;
} elseif ($httpCode !== 200) {
    echo 'HTTP ошибка: код ' . $httpCode;
} else {
    $data = json_decode($response, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        echo 'Ошибка разбора JSON: ' . json_last_error_msg();
    } else {
        echo 'Успешно получено ' . count($data) . ' записей';
    }
}

Успешно получено 150 записей

Пояснение: cURL даёт полный контроль над HTTP-запросами и позволяет отдельно обработать ошибки соединения, HTTP-статусы и ошибки формата. Этот подход предпочтительнее file_get_contents для удалённых файлов, так как не требует включения директивы allow_url_fopen.

Пример 2. Безопасное чтение большого CSV-файла с использованием генератора

function readCsvGenerator($filename) {
    if (!is_readable($filename)) {
        throw new InvalidArgumentException("Файл недоступен для чтения: $filename");
    }
    $handle = fopen($filename, 'r');
    if ($handle === false) {
        throw new RuntimeException("Не удалось открыть файл: $filename");
    }
    try {
        while (($row = fgetcsv($handle)) !== false) {
            yield $row;
        }
    } finally {
        fclose($handle);
    }
}

try {
    foreach (readCsvGenerator(__DIR__ . '/data.csv') as $index => $row) {
        // Обрабатываем строку, не храня все данные в памяти
        if ($index >= 1000) break; // только первые 1000 записей
        echo implode(', ', $row) . "\n";
    }
} catch (Throwable $e) {
    echo 'Ошибка: ' . $e->getMessage();
}

1, Иванов, Москва
2, Петров, Санкт-Петербург
...

Пояснение: Генератор yield позволяет обрабатывать CSV-файл любого размера без загрузки всего файла в память. Конструкция try/finally гарантирует закрытие дескриптора даже при исключении.

Пример 3. Работа с блокировками flock для безопасной записи

$file = __DIR__ . '/counter.txt';
$handle = fopen($file, 'c+');
if ($handle === false) {
    throw new RuntimeException('Не удалось открыть файл');
}
// Получение эксклюзивной блокировки
if (flock($handle, LOCK_EX)) {
    // Чтение текущего значения
    $current = (int) fgets($handle);
    $newValue = $current + 1;
    // Очистка и запись
    ftruncate($handle, 0);
    rewind($handle);
    fwrite($handle, $newValue);
    fflush($handle);
    // Снятие блокировки
    flock($handle, LOCK_UN);
    echo 'Новое значение счётчика: ' . $newValue;
} else {
    echo 'Не удалось получить блокировку';
}
fclose($handle);

Новое значение счётчика: 42

Пояснение: flock препятствует одновременной записи в файл из нескольких процессов. Режим LOCK_EX даёт эксклюзивный доступ. Всегда нужно снимать блокировку и закрывать файл.

Пример 4. Рекурсивный обход директории с игнорированием недоступных папок

$iterator = new RecursiveDirectoryIterator(
    __DIR__ . '/app',
    RecursiveDirectoryIterator::SKIP_DOTS | RecursiveDirectoryIterator::CURRENT_AS_FILEINFO
);
$filter = new RecursiveCallbackFilterIterator($iterator, function (SplFileInfo $file) {
    // Пропускаем директории, к которым нет доступа
    if ($file->isDir() && !$file->isReadable()) {
        return false;
    }
    return true;
});
$files = new RecursiveIteratorIterator($filter);
foreach ($files as $file) {
    if ($file->isFile() && $file->getExtension() === 'php') {
        echo $file->getPathname() . "\n";
    }
}

/home/user/app/index.php
/home/user/app/src/Controller.php
...

Пояснение: Использование RecursiveCallbackFilterIterator позволяет динамически пропускать элементы, которые могут вызывать ошибки (например, папки без прав на чтение). Это предотвращает неожиданные исключения при обходе.

Пример 5. Использование SplFileObject для объектно-ориентированной работы

try {
    $file = new SplFileObject(__DIR__ . '/info.txt', 'r');
    $file->setFlags(SplFileObject::DROP_NEW_LINE | SplFileObject::SKIP_EMPTY);
    foreach ($file as $lineNumber => $line) {
        if ($lineNumber === 0) {
            // Пропускаем заголовок
            continue;
        }
        echo "Строка $lineNumber: $line\n";
    }
} catch (RuntimeException $e) {
    echo 'Ошибка открытия файла: ' . $e->getMessage();
}

Строка 1: Данные первой строки
Строка 2: Вторая строка

Пояснение: SplFileObject предоставляет встроенные методы для навигации по файлу, поддержку итерации, флаги для фильтрации пустых строк. Исключения при неудаче открытия наследуются от RuntimeException.

Пример 6. Проверка возвращаемого значения file_put_contents и логирование

$data = "Лог-запись: " . date('Y-m-d H:i:s') . "\n";
$result = @file_put_contents(__DIR__ . '/logs/event.log', $data, FILE_APPEND | LOCK_EX);
if ($result === false) {
    $error = error_get_last();
    error_log('Не удалось записать в лог: ' . ($error['message'] ?? 'неизвестная ошибка'));
    // Альтернатива: использовать syslog
    syslog(LOG_ERR, 'Не удалось записать в лог');
} else {
    echo "Записано $result байт";
}

Записано 28 байт

Пояснение: Возвращаемое значение file_put_contents - количество записанных байт или false. Флаг FILE_APPEND добавляет данные в конец, LOCK_EX - блокирует файл. При неудаче error_get_last() даёт детали последней ошибки.