Чтобы прочитать файл в PHP целиком, вызовите file_get_contents('путь'): функция вернёт содержимое строкой или false, если файл не открылся. Записать строку в файл помогает file_put_contents('путь', $данные). Чтобы дописать в конец и не стереть старое, добавьте к этому вызову флаг FILE_APPEND. Для больших файлов, например логов, подходит fopen() и чтение по строкам через fgets().
Ниже девять примеров, каждый мы запустили в PHP 8.3 и вставили вывод целиком. Если вы только знакомитесь с языком, начните с разбора синтаксиса PHP: переменные, условия и циклы там объяснены на таких же коротких примерах.
SkillboxПрофессия «Fullstack-разработчик на PHP»166 715 ₽12 месяцев
SkillFactoryBackend-разработчик на PHP158 004 ₽12 месяцев
HexletPHP-разработчик69 000 ₽10 месяцев
GeekBrainsПрофессия «Программист PHP»28 800 ₽4 месяца
OTUSPHP-разработчик77 000 ₽5 месяцев
OnSkillsPHP: базовый курс900 ₽
Как прочитать файл целиком через file_get_contents

Возьмём файл 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
Порядок всегда один:
fopen()открывает файл и возвращает дескриптор илиfalse.fgets()в цикле отдаёт строку за строкой, а в конце файла возвращаетfalse.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.
Как записать данные в файл через 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.
Как создать, проверить и удалить файл
Иногда файл нужно создать строго новым: например, квитанцию заказа, которую нельзя случайно затереть. Для этого есть режим '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 |
Один совет про безопасность. Никогда не подставляйте в путь к файлу то, что пришло от пользователя, без проверки: запрос с ../ в имени выведет скрипт за пределы нужной папки. Берите из запроса только имя, сверяйте его со списком разрешённых и склеивайте с папкой сами.
Как то же самое выглядит в других языках
Приёмы почти одинаковые везде: открыть, прочитать или записать, закрыть. Разница в основном в синтаксисе.
| Задача | 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» Перейти на сайт курса | 166 715 ₽ | 5378 ₽/мес. | 12 месяцев | Обзор курса | |
| PHP-разработчик с нуля до PRO Перейти на сайт курса | 114 961 ₽ | 4176 ₽/мес. | 7 месяцев | Обзор курса | |
| Backend-разработчик на PHP Перейти на сайт курса | 158 004 ₽ | 4389 ₽/мес. | 12 месяцев | Обзор курса | |
| PHP-разработчик Перейти на сайт курса | 69 000 ₽ | 3885 ₽/мес. | 10 месяцев | Обзор курса | |
| PHP-разработчик. Базовый уровень Перейти на сайт курса | 81 167 ₽ | 5227 ₽/мес. | 3 месяца | Обзор курса |
Больше программ — в полном каталоге курсов по php




