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

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

Чтение больших файлов по частям (буферизация)

Для обработки файлов, размер которых превышает доступную память, используется fread с указанием размера блока.

$handle = fopen('large_file.txt', 'r');
$bufferSize = 4096; // 4 КБ
while (!feof($handle)) {
    $chunk = fread($handle, $bufferSize);
    // обработка куска
    echo 'Прочитано ' . strlen($chunk) . ' байт
';
}
fclose($handle);

Прочитано 4096 байт
Прочитано 4096 байт
...
Прочитано 1234 байт

Функция feof проверяет конец файла. Важно учитывать, что последний блок может быть меньше указанного размера.

Запись с эксклюзивной блокировкой и освобождением ресурсов

В многопоточных скриптах (например, при использовании очередей) блокировка файла предотвращает повреждение данных.

$file = 'counter.log';
$handle = fopen($file, 'a');
if ($handle) {
    try {
        if (!flock($handle, LOCK_EX)) {
            throw new Exception('Не удалось получить блокировку');
        }
        fwrite($handle, 'Запись с блокировкой: ' . date('Y-m-d H:i:s') . PHP_EOL);
        flock($handle, LOCK_UN);
    } finally {
        fclose($handle);
    }
} else {
    echo 'Ошибка открытия файла';
}

// Файл counter.log пополняется строками без пересечения

Конструкция try...finally гарантирует закрытие файла даже при возникновении исключения.

Создание временного файла

Для хранения промежуточных данных удобно использовать tmpfile - создаёт временный файл, который автоматически удаляется при закрытии.

$tempHandle = tmpfile();
fwrite($tempHandle, 'Временные данные');
// Делаем что-то с файлом (например, передаём его в другой обработчик)
rewind($tempHandle);
$content = stream_get_contents($tempHandle);
echo $content;
fclose($tempHandle); // файл удаляется

Временные данные

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

Рекурсивное создание директорий

При сохранении файлов во вложенные каталоги может потребоваться создать все уровни папок. Параметр recursive у mkdir позволяет это сделать.

$path = 'uploads/2024/12/25';
if (!is_dir($path)) {
    mkdir($path, 0755, true);
    echo 'Директория создана';
}
$file = $path . '/log.txt';
file_put_contents($file, 'Содержимое');

Директория создана

Если каталог уже существует, is_dir вернёт true, и создание не выполнится. Права доступа 0755 - стандартные для веб-сервера.

Использование потоковых обёрток (php://input, php://output)

PHP поддерживает потоки для работы с вводом-выводом напрямую. Например, чтение тела POST-запроса через php://input.

$input = fopen('php://input', 'r');
$rawData = stream_get_contents($input);
fclose($input);
echo 'Получено ' . strlen($rawData) . ' байт данных';

Получено 1024 байт данных

Аналогично для прямого вывода в ответ сервера можно использовать php://output:

$out = fopen('php://output', 'w');
fwrite($out, 'Генерируемый контент');
fclose($out);

Такой подход полезен при создании динамических изображений, PDF или прямого вывода больших объёмов данных.

Копирование и перемещение файлов с проверкой

Функция copy и rename с предварительной проверкой успешности.

$source = 'source.txt';
$dest = 'backup/source_backup.txt';
if (!file_exists(dirname($dest))) {
    mkdir(dirname($dest), 0755, true);
}
if (copy($source, $dest)) {
    echo 'Файл скопирован';
} else {
    echo 'Ошибка копирования';
}
// Перемещение (переименование)
if (rename($dest, 'archive/backup.txt')) {
    echo 'Файл перемещён';
}

Файл скопирован
Файл перемещён

При перемещении между разными разделами диска rename может не сработать - в таких случаях требуется copy + unlink.

Чтение и запись бинарных файлов

Режимы 'wb' и 'rb' гарантируют корректную работу с бинарными данными без преобразования символов новой строки.

$src = fopen('image.jpg', 'rb');
$dst = fopen('copy.jpg', 'wb');
while (!feof($src)) {
    $chunk = fread($src, 8192);
    if ($chunk !== false) {
        fwrite($dst, $chunk);
    }
}
fclose($src);
fclose($dst);
echo 'Бинарное копирование завершено';

Бинарное копирование завершено

Использование режима 'b' особенно важно на Windows, где в текстовом режиме символы перевода строки могут искажаться.