Работа с файлами в веб-разработке: основные операции и продвинутые примеры

Чтение большого файла с помощью генератора

Позволяет обрабатывать файлы, не загружая их целиком в память.

function readLinesGenerator($filename) {
    $handle = fopen($filename, 'r');
    while (($line = fgets($handle)) !== false) {
        yield rtrim($line, "\n\r");
    }
    fclose($handle);
}

$lines = readLinesGenerator('large.log');
foreach ($lines as $line) {
    echo $line . PHP_EOL;
}

Вывод первых строк файла large.log (если файл существует).
Пример вывода:
[2025-03-15 10:00:01] INFO Старт приложения
[2025-03-15 10:00:02] DEBUG Параметры загружены
...

Объектно-ориентированный подход с SplFileObject

Итератор для удобной работы с CSV или текстовыми файлами.

$file = new SplFileObject('data.csv');
$file->setFlags(SplFileObject::READ_CSV | SplFileObject::SKIP_EMPTY);
foreach ($file as $row) {
    if ($row !== []) {
        echo implode(' | ', $row) . "\n";
    }
}

Результат:
Имя | Возраст | Город
Иван | 28 | Москва
Мария | 32 | Санкт-Петербург

Потоки и контексты: чтение через HTTP с авторизацией

Использование stream_context_create() для удалённой загрузки файла.

$context = stream_context_create([
    'http' => [
        'header' => "Authorization: Basic " . base64_encode('user:pass'),
        'timeout' => 30
    ]
]);
$content = file_get_contents('https://api.example.com/data.json', false, $context);
if ($content !== false) {
    echo 'Загружено ' . strlen($content) . ' байт';
}

Вывод: Загружено 2048 байт (при успешном запросе).

Рекурсивный обход директории и поиск файлов по расширению

Обход папки и обработка всех файлов с заданным расширением.

function findFiles($dir, $extension) {
    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS)
    );
    foreach ($iterator as $file) {
        if (strtolower($file->getExtension()) === $extension) {
            yield $file->getPathname();
        }
    }
}

foreach (findFiles('/var/www/logs', 'log') as $path) {
    echo $path . "\n";
}

/var/www/logs/app.log
/var/www/logs/error.log
/var/www/logs/subdir/debug.log

Блокировка файла для предотвращения одновременной записи

Использование flock() для исключительной блокировки.

$handle = fopen('counter.txt', 'c+');
if (flock($handle, LOCK_EX)) {
    $count = (int) fread($handle, 1024);
    $count++;
    rewind($handle);
    fwrite($handle, (string)$count);
    flock($handle, LOCK_UN);
} else {
    echo 'Не удалось заблокировать файл';
}
fclose($handle);

Файл counter.txt будет содержать увеличенное значение (например, 5).

Загрузка файла на сервер с проверками

Полный пример с валидацией MIME-типа, размера и перемещением.

$allowedTypes = ['image/jpeg', 'image/png'];
$maxSize = 2 * 1024 * 1024; // 2MB

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['upload'])) {
    $file = $_FILES['upload'];
    if ($file['error'] !== UPLOAD_ERR_OK) {
        die('Ошибка загрузки: ' . $file['error']);
    }
    if (!in_array($file['type'], $allowedTypes)) {
        die('Недопустимый тип файла');
    }
    if ($file['size'] > $maxSize) {
        die('Файл слишком большой');
    }
    $dest = 'uploads/' . uniqid() . '_' . basename($file['name']);
    if (move_uploaded_file($file['tmp_name'], $dest)) {
        echo 'Файл сохранён: ' . $dest;
    } else {
        echo 'Ошибка перемещения';
    }
}

При успешной загрузке: Файл сохранён: uploads/63f1a2b3c4d5_photo.jpg

Чтение и запись бинарного файла (изображения) с проверкой

Копирование изображения с использованием fread и fwrite.

$src = fopen('source.png', 'rb');
$dst = fopen('dest.png', 'wb');
if ($src && $dst) {
    while (!feof($src)) {
        $chunk = fread($src, 8192);
        if ($chunk !== false) {
            fwrite($dst, $chunk);
        }
    }
    fclose($src);
    fclose($dst);
    echo 'Копирование успешно';
} else {
    echo 'Ошибка открытия файлов';
}

Вывод: Копирование успешно (размер dest.png совпадает с source.png).

Временные файлы через tmpfile()

Создание временного файла, который удаляется автоматически после закрытия.

$handle = tmpfile();
fwrite($handle, 'Временные данные');
rewind($handle);
echo fread($handle, 1024);
fclose($handle);  // файл удалён

Вывод: Временные данные

Атомарная запись с LOCK_EX через file_put_contents

Флаг LOCK_EX обеспечивает эксклюзивную блокировку.

$data = 'Важные данные' . PHP_EOL;
$result = file_put_contents('lockfile.txt', $data, LOCK_EX);
if ($result !== false) {
    echo 'Записано ' . $result . ' байт';
}

Вывод: Записано 14 байт