Работа с файлами в PHP: чтение, запись и file_get_contents на примерах

Читать файл целиком в PHP удобнее всего через file_get_contents(), записывать через file_put_contents(), а большие логи читать по строке через fopen() и fgets().

Разобрали девять примеров с реальным выводом PHP 8.3, режимы fopen и ошибки, из-за которых файл не читается или затирается.

Статью написал:
Ваня Буявец, продюсер, основатель Checkroi
Ваня Буявец
Основатель Checkroi, продюсер, эксперт в выборе онлайн-курсов
Все 3286 статей автора Подписаться на Телеграм-канал
Одобрено экспертом:
Наташа Буявец, основатель Checkroi, эксперт по онлайн-курсам
Наташа Буявец
Основательница Checkroi, продюсер Youtube-каналов, эксперт по онлайн-курсам
Все 3940 экспертных мнений Подписаться на Телеграм-канал
Обложка: Работа с файлами в PHP: чтение, запись и file_get_contents на примерах

Чтобы прочитать файл в PHP целиком, вызовите file_get_contents('путь'): функция вернёт содержимое строкой или false, если файл не открылся. Записать строку в файл помогает file_put_contents('путь', $данные). Чтобы дописать в конец и не стереть старое, добавьте к этому вызову флаг FILE_APPEND. Для больших файлов, например логов, подходит fopen() и чтение по строкам через fgets().

Ниже девять примеров, каждый мы запустили в PHP 8.3 и вставили вывод целиком. Если вы только знакомитесь с языком, начните с разбора синтаксиса PHP: переменные, условия и циклы там объяснены на таких же коротких примерах.

Как прочитать файл целиком через file_get_contents

Рой открывает текстовый файл из PHP-скрипта

Возьмём файл notes.txt со списком дел. В нём четыре строки, третья пустая. Скрипт лежит в той же папке, поэтому путь собираем через __DIR__.

<?php
$text = file_get_contents(__DIR__ . '/notes.txt');

if ($text === false) {
    exit("Не удалось прочитать файл\n");
}

echo $text;
echo "Размер в байтах: " . strlen($text) . "\n";

Вывод:

Купить молоко
Позвонить в банк

Оплатить интернет
Размер в байтах: 92

Обратите внимание на число: строк четыре, а strlen() насчитала 92. Функция считает байты, а буквы кириллицы в UTF-8 занимают по два байта. Нужно число символов — берите mb_strlen().

Почему именно file_get_contents? В справке PHP сказано, что вызов этой функции «наиболее предпочтителен, когда требуется получить содержимое файла целиком»: она использует отображение файла в память, если система это поддерживает.

Как прочитать файл в массив строк

Когда строки файла нужны по отдельности (список адресов, словарь, строки конфигурации), удобнее функция file(). Она возвращает массив, где один элемент равен одной строке.

<?php
$lines = file(__DIR__ . '/notes.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);

echo "Строк: " . count($lines) . "\n";
echo "Первая: " . $lines[0] . "\n";
echo "Последняя: " . end($lines) . "\n";
Строк: 3
Первая: Купить молоко
Последняя: Оплатить интернет

Два флага делают работу за вас:

  • FILE_IGNORE_NEW_LINES отрезает перевод строки в конце каждого элемента;
  • FILE_SKIP_EMPTY_LINES выбрасывает пустые строки, поэтому из четырёх осталось три.

Без первого флага строки придут вместе с символом \n, и сравнение $lines[0] === 'Купить молоко' вернёт false.

Как читать большой файл по строкам через fopen и fgets

file_get_contents() и file() загружают весь файл в память. На лог в несколько гигабайт так не хватит лимита: в стандартной настройке memory_limit равен 128 МБ, и скрипт упадёт с ошибкой нехватки памяти.

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

<?php
$fh = fopen(__DIR__ . '/app.log', 'r');

if ($fh === false) {
    exit("Лог не открылся\n");
}

$errors = 0;
while (($line = fgets($fh)) !== false) {
    if (str_contains($line, 'ERROR')) {
        $errors++;
        echo trim($line) . "\n";
    }
}
fclose($fh);

echo "Ошибок в логе: $errors\n";
2026-11-14 10:02:15 ERROR Нет связи с базой
2026-11-14 10:05:02 ERROR Таймаут платёжного шлюза
Ошибок в логе: 2

Порядок всегда один:

  1. fopen() открывает файл и возвращает дескриптор или false.
  2. fgets() в цикле отдаёт строку за строкой, а в конце файла возвращает false.
  3. fclose() закрывает файл.

Функция str_contains() появилась в PHP 8. На старых версиях вместо неё пишут strpos($line, 'ERROR') !== false.

Тем же циклом читают выгрузки в CSV, только вместо fgets() берут fgetcsv(): она сразу делит строку на поля. Как устроен сам формат, мы рассказали в разборе формата CSV.

Режимы fopen: какую букву передать

Второй аргумент fopen() решает, можно ли писать в файл и что станет с его содержимым. Полный список есть в справке по fopen(), на практике хватает шести режимов:

Режим Что делает Если файла нет
'r' только чтение, указатель в начале ошибка, false
'r+' чтение и запись, указатель в начале ошибка, false
'w' только запись, содержимое стирается создаст файл
'a' только запись в конец файла создаст файл
'x' создаёт новый файл для записи создаст; если файл уже есть, вернёт false
'c' запись без обрезки файла создаст файл

Дороже всего обходится 'w' там, где хотели дописать: файл обнулится в момент открытия, ещё до первой записи.

Если вы пишете ещё и на Python, буквы покажутся знакомыми: у функции open() те же режимы r, w, a и x. Как ими пользоваться там, разобрано в инструкции как открыть файл в Python.

Канал основателя Checkroi Вани Буявца3 800 человек читают мой Телеграм-канал про нейросетиСобрал промпты для Claude Code и ChatGPT, разборы ИИ-инструментов и лайфхаки по продвижению бизнеса в одном местеПрисоединиться

Как записать данные в файл через file_put_contents

Папка с текстовыми файлами и стрелка записи на столе

file_put_contents() сама открывает файл, пишет и закрывает его. Если файла нет, функция его создаст, а если он есть, перезапишет. Чтобы дописать в конец, передайте флаг FILE_APPEND.

<?php
$file = __DIR__ . '/report.txt';

$bytes = file_put_contents($file, "Отчёт за ноябрь\n");
echo "Записано байтов: $bytes\n";

file_put_contents($file, "Заказов: 48\n", FILE_APPEND | LOCK_EX);
file_put_contents($file, "Возвратов: 3\n", FILE_APPEND | LOCK_EX);

echo file_get_contents($file);
Записано байтов: 29
Отчёт за ноябрь
Заказов: 48
Возвратов: 3

Что здесь важно:

  • функция возвращает число записанных байтов или false, если записать не удалось;
  • перевод строки \n добавляете вы сами, иначе три записи склеятся в одну строку;
  • LOCK_EX ставит эксклюзивную блокировку на время записи, и запись из двух одновременных запросов к сайту не наложится друг на друга.

Флаги соединяются оператором |, как в примере.

Файловые журналы, кеш страниц и выгрузки заказов на практике пишут именно так. Системно бэкенд на PHP разбирают на курсах из нашей подборки курсов по PHP.

Как сохранить массив в файл и прочитать обратно

Строку записать просто, а массив настроек так не сохранишь. Удобнее всего перевести его в JSON: формат читается глазами и открывается в любом языке. Если с самим форматом вы ещё не работали, загляните в разбор что такое JSON.

<?php
$file = __DIR__ . '//selcdn.checkroi.ru/settings.json';

$settings = ['theme' => 'dark', 'lang' => 'ru', 'limit' => 20];
file_put_contents($file, json_encode($settings, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE));

$loaded = json_decode(file_get_contents($file), true);
echo $loaded['lang'] . ", лимит " . $loaded['limit'] . "\n";
var_dump($loaded === $settings);
ru, лимит 20
bool(true)

Второй аргумент true в json_decode() просит вернуть ассоциативный массив, а не объект. Последняя строка вывода подтверждает: после записи и чтения массив совпал с исходным. Тот же приём на другом языке разобран в статье про запись в JSON на Python.

CheckroiCheckroiПодборка курсов по PHP42 курса • 17 школСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить→

Как создать, проверить и удалить файл

Иногда файл нужно создать строго новым: например, квитанцию заказа, которую нельзя случайно затереть. Для этого есть режим 'x'. Повторная попытка открыть тот же файл в этом режиме вернёт false.

<?php
$file = __DIR__ . '/order-1001.txt';

$fh = fopen($file, 'x');
fwrite($fh, "Заказ 1001\n");
fclose($fh);

$again = @fopen($file, 'x');
var_dump($again);

unlink($file);
var_dump(file_exists($file));
bool(false)
bool(false)

Первое bool(false) вернул повторный fopen(): файл уже есть, и режим 'x' его не тронул. Значок @ здесь только прячет предупреждение, чтобы вывод был коротким. В рабочем коде лучше проверить результат через === false и оставить предупреждение в логе.

Второе bool(false) пришло от file_exists() после unlink(): файл удалён. Пригодятся ещё три проверки:

  • is_readable($file) проверяет, можно ли файл прочитать;
  • is_writable($file) проверяет, можно ли в него писать;
  • filesize($file) возвращает размер в байтах.

Как прочитать страницу по URL

file_get_contents() открывает не только файлы на диске, но и адреса в интернете. Это работает, когда в настройках включена директива allow_url_fopen, по умолчанию она включена. Таймаут лучше задать явно: без него в стандартной настройке скрипт будет ждать ответа до 60 секунд.

<?php
$context = stream_context_create([
    'http' => ['timeout' => 5],
]);

$html = file_get_contents('https://example.com/', false, $context);

if ($html === false) {
    exit("Сайт не ответил за 5 секунд\n");
}

echo "Получено байтов: " . strlen($html) . "\n";
preg_match('/<title>(.*?)<\/title>/', $html, $m);
echo "Заголовок страницы: " . $m[1] . "\n";
Получено байтов: 577
Заголовок страницы: Example Domain

Шестьдесят секунд задаёт директива default_socket_timeout, это её значение по умолчанию из той же справки. Для запроса к API с заголовками, методом POST и разбором кодов ответа сервера удобнее расширение cURL: оно даёт больше контроля над запросом.

Частые ошибки при работе с файлами в PHP

Рой радуется, что нашёл причину ошибки в скрипте

Начнём с самой коварной. Пустой файл читается без ошибок, но file_get_contents() возвращает пустую строку, а она в условии ведёт себя как false:

<?php
file_put_contents(__DIR__ . '/empty.txt', '');
$text = file_get_contents(__DIR__ . '/empty.txt');

if (!$text) {
    echo "Через ! : файл не прочитан\n";
}
if ($text === false) {
    echo "Через === false : файл не прочитан\n";
} else {
    echo "Через === false : файл прочитан, он пустой\n";
}
Через ! : файл не прочитан
Через === false : файл прочитан, он пустой

Решение: проверяйте результат строго, через === false. Справка PHP предупреждает об этом прямо: функция «возвращает как логическое значение false, так и нелогическое значение, которое приводится к false».

Вторая частая ситуация: файла нет по указанному пути. Функция выдаёт предупреждение и возвращает false:

<?php
$text = file_get_contents(__DIR__ . '/no-such-file.txt');
var_dump($text);

Warning: file_get_contents(/tmp/demo-site/no-such-file.txt): Failed to open stream: No such file or directory in /tmp/demo-site/06-missing.php on line 2
bool(false)

Остальные ошибки собрали в таблицу:

Что видите Причина Что сделать
Failed to open stream: No such file or directory относительный путь считается от папки запуска, а не от скрипта собирать путь через __DIR__
Failed to open stream: Permission denied у пользователя веб-сервера нет прав на файл или папку проверить владельца и права, писать в отдельную папку для данных
Allowed memory size exhausted большой файл целиком загружен в память читать по строкам через fopen() и fgets()
Файл после записи пустой, старые данные пропали открыт в режиме 'w' или записан без FILE_APPEND для дописывания режим 'a' или флаг FILE_APPEND
Все записи в одной строке не добавлен перевод строки дописывать "\n" или PHP_EOL в конец каждой записи
Строки из двух запросов перемешались одновременная запись без блокировки флаг LOCK_EX

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

Ваня БуявецКанал основателя Checkroi Вани БуявцаЗабирайте промпты и обучение по нейросетям в моём Телеграм-каналеБольше 3 800 человек уже применяют Claude Code, ChatGPT и другие нейросети в работе, учёбе, бизнесе и жизниПерейти в канал

Как то же самое выглядит в других языках

Приёмы почти одинаковые везде: открыть, прочитать или записать, закрыть. Разница в основном в синтаксисе.

Задача PHP Python
прочитать целиком file_get_contents($f) open(f).read()
прочитать по строкам fgets() в цикле for line in f:
записать строку file_put_contents($f, $s) f.write(s) в режиме 'w'
дописать в конец флаг FILE_APPEND режим 'a'

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

Где освоить PHP системно

Чтение и запись файлов входят в первые шаги бэкенд-разработчика. Дальше идут формы, базы данных, сессии и фреймворки вроде Laravel. Как выстроить этот путь по месяцам, мы расписали в плане как стать PHP-разработчиком, а чем такой специалист занят на работе, рассказали в обзоре профессии PHP-разработчика.

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

КурсШколаСтоимость со скидкойВ рассрочкуДлитель­ностьОбзор курса от Checkroi
Профессия «Fullstack-разработчик на PHP»
Перейти на сайт курса
SkillboxSkillbox166 715 ₽5378 ₽/мес.12 месяцевОбзор курса
PHP-разработчик с нуля до PRO
Перейти на сайт курса
SkillboxSkillbox114 961 ₽4176 ₽/мес.7 месяцевОбзор курса
Backend-разработчик на PHP
Перейти на сайт курса
SkillFactorySkillFactory158 004 ₽4389 ₽/мес.12 месяцевОбзор курса
PHP-разработчик
Перейти на сайт курса
HexletHexlet69 000 ₽3885 ₽/мес.10 месяцевОбзор курса
PHP-разработчик. Базовый уровень
Перейти на сайт курса
SkillboxSkillbox81 167 ₽5227 ₽/мес.3 месяцаОбзор курса

Больше программ — в полном каталоге курсов по php

Часто задаваемые вопросы

Чем file_get_contents отличается от fopen и fgets?

file_get_contents() читает весь файл в память одной строкой, это удобно для небольших файлов. fopen() с fgets() отдают файл по строке, поэтому подходят для логов и выгрузок, которые не помещаются в memory_limit.

Как дописать строку в конец файла PHP, не стирая старое?

Вызовите file_put_contents($file, $text . "\n", FILE_APPEND | LOCK_EX). Флаг FILE_APPEND дописывает в конец, LOCK_EX блокирует файл на время записи. Перевод строки добавьте сами.

Почему file_get_contents возвращает false?

Файла нет по указанному пути, у скрипта нет прав на чтение или вместо файла передана папка. Путь надёжнее собирать через __DIR__, а результат проверять строго: $text === false. Пустой файл вернёт пустую строку, это не ошибка.

Как создать файл в PHP?

Проще всего через file_put_contents(): если файла нет, функция его создаст. Если файл нельзя перезаписывать, откройте его через fopen($file, 'x'): при существующем файле вызов вернёт false.

Можно ли прочитать страницу сайта через file_get_contents?

Можно, если в настройках PHP включена директива allow_url_fopen, по умолчанию она включена. Задайте таймаут через stream_context_create(), а для запросов с заголовками и методом POST удобнее расширение cURL.

Чем открыть PHP-файл на компьютере?

PHP-файл содержит обычный текст, его открывает любой редактор кода, например VS Code. Чтобы выполнить скрипт, запустите в терминале php имя_файла.php или откройте его через веб-сервер с установленным PHP.

Читайте Checkroi первым в Google
Добавьте Checkroi в избранные источники — и наши разборы курсов и обзоры школ будут показываться выше в вашей выдаче Google.
Оставить комментарий
0 комментариев
Форма комментария

Оставьте комментарий

Напишите, что думаете. Нам важно ваше мнение!