Файли: читання й запис
Що ви дізнаєтесь
- Як записати текст у файл і прочитати його цілком
- Як дописати рядок у кінець файлу і прочитати файл масивом рядків
- Де тримати файли даних і чому шлях до них будують від
__DIR__ - Що означають
No such file or directoryіPermission deniedі що буває, коли два запити пишуть файл одночасно
У кроці 7 гостьової книги записи живуть у сесії: інший браузер їх не бачить, а з новою сесією вони зникають. Щоб дані були спільними для всіх відвідувачів, сервер зберігає їх у файлах.
Запис і читання цілого файлу
Дві вбудовані функції працюють з файлом цілком:
file_put_contents($path, $text)записує рядок у файл і повертає кількість записаних байтів. Файлу немає — створює його, файл є — перезаписує повністю.file_get_contents($path)повертає весь вміст файлу одним рядком.
<?php
// src/public/notes.php
$path = __DIR__ . '/../storage/notes.txt';
$bytes = file_put_contents($path, "Купити каву\n");
var_dump($bytes);
var_dump(file_get_contents($path));
Відповідь сторінки в терміналі (curl -s http://localhost:8080/notes.php):
int(22)
string(22) "Купити каву
"
Файл з'явився в src/storage/notes.txt вашого проєкту — його можна відкрити в IDE. 22 — байти, а не літери: кирилична літера в UTF-8 займає два байти, як у лекції «Перевірка даних форми». Останній байт — перенесення рядка "\n", тому var_dump() закриває лапки вже на новому рядку.
Шлях — від __DIR__. Відносний шлях '../storage/notes.txt' PHP рахує від поточного робочого каталогу, а не від файлу з кодом, тож у підключеному файлі він веде не туди. Тому шлях до даних будують так само, як для require у лекції «Типи, include і require: код у кількох файлах»: від __DIR__. Тут __DIR__ — /var/www/html/public, а .. піднімає в /var/www/html, тобто у ваш src/.
Файлу може не бути. Сторінка read.php з одним рядком після <?php — echo file_get_contents(__DIR__ . '/../storage/notes.txt'); — до першого запису покаже:
Warning: file_get_contents(/var/www/html/public/../storage/notes.txt): Failed to open stream: No such file or directory in /var/www/html/public/read.php on line 2
file_get_contents() повернула false, а PHP показав шлях саме так, як його склали, разом із ... Тому перед читанням перевіряють file_exists($path) — вона повертає true, якщо файл є: $text = file_exists($path) ? file_get_contents($path) : '';. Те саме No such file or directory дає й file_put_contents(), коли немає каталогу: файл вона створює, а каталог — ні.
Дописування і читання рядками
Щоб додати рядок у кінець файлу, а не перезаписати його, третім аргументом передають прапорець FILE_APPEND. Журнал відвідувань:
<?php
// src/public/visits.php — журнал відвідувань
$path = __DIR__ . '/../storage/visits.log';
$line = date('Y-m-d H:i') . ' ' . ($_GET['page'] ?? 'home') . "\n";
file_put_contents($path, $line, FILE_APPEND | LOCK_EX);
$lines = file($path, FILE_IGNORE_NEW_LINES);
echo 'Відвідувань: ' . count($lines) . "\n";
echo 'Останнє: ' . $lines[count($lines) - 1] . "\n";
FILE_APPEND— вбудована константа: дописати в кінець. Кожен рядок закінчується"\n", інакше записи злипнуться в один рядок.LOCK_EX— блокування на час запису, про нього нижче. Кілька прапорців поєднують оператором|:FILE_APPEND | LOCK_EX— «і те, і те».file()— вбудована функція: читає файл у масив, по елементу на рядок. Кожен елемент закінчується"\n", а прапорецьFILE_IGNORE_NEW_LINESйого відкидає.
Три запити — visits.php, visits.php?page=menu і visits.php?page=contacts — і третя відповідь:
Відвідувань: 3
Останнє: 2026-10-06 05:52 contacts
Одночасний запис
Сайт відкривають багато людей, і кожен запит обробляє окремий процес PHP — іноді в ту саму мить. Два одночасні записи в один файл можуть перемішатися й зіпсувати його. LOCK_EX (exclusive lock — виключне блокування) ставить записи в чергу: поки один запит пише файл, інший, що теж пише з LOCK_EX, чекає. Тому файли даних пишуть із LOCK_EX завжди.
Від усього блокування не рятує. Сторінка, яка змінює файл, працює в три кроки: прочитати → змінити → записати весь файл. Якщо два запити прочитають файл одночасно, кожен запише свою версію, і зміна першого пропаде. FILE_APPEND цієї проблеми не має: він нічого не перечитує, а лише дописує в кінець. Для гостьової книги з кількома записами на день такий ризик прийнятний, а там, де пишуть сотні людей на секунду, дані тримають у базі даних.
Де лежать файли даних
Поза веб-коренем
nginx віддає кожен файл із src/public/ як є (лекція «Шлях запиту, шляхи до файлів і IDE»): src/public/notes.txt прочитав би будь-хто за адресою http://localhost:8080/notes.txt. А PHP читає й пише файли будь-де, тож дані кладуть поза веб-коренем, у свій каталог:
intita-php/
└── src/
├── guestbook/ ← код: функції, шаблони
├── storage/ ← дані, які пише PHP
│ └── notes.txt
└── public/ ← корінь сайту: лише сторінки
└── notes.php
Каталог src/storage/ створіть самі — в IDE чи командою mkdir src/storage.
Хто має право писати
PHP у контейнері php працює від імені користувача app з UID 1000 або з номером UID із .env (лекція «Docker і Docker Compose», розділ «Змінні UID і GID»). Через bind mount src/storage/ — це каталог на вашому диску, і власник у нього ваш. Якщо на Linux ваш номер (id -u) не 1000, а .env з UID і GID немає, PHP пише в чужий каталог, і Linux не дозволяє:
Warning: file_put_contents(/var/www/html/public/../storage/notes.txt): Failed to open stream: Permission denied in /var/www/html/public/notes.php on line 5
Виправлення — з модуля 2: UID і GID у .env і docker compose up -d --build. Номер власника показує ls -ln src: у каталогу storage він має збігатися з UID користувача app. На Windows і macOS Docker Desktop узгоджує права сам, і цієї помилки зазвичай немає.
Підсумок
file_put_contents()записує рядок у файл, перезаписуючи його; зFILE_APPEND— дописує в кінець.file_get_contents()читає файл цілком,file()— масивом рядків;FILE_IGNORE_NEW_LINESприбирає"\n".- Відсутній файл чи каталог —
No such file or directory, тож перед читанням перевіряютьfile_exists(). - Шлях до файлу будують від
__DIR__, а дані тримають позаsrc/public/— наприклад, уsrc/storage/. Permission denied— користувачappне має права писати в каталог; на Linux допомагаютьUIDіGIDу.env.- Файли даних пишуть із
LOCK_EX, але два одночасні «прочитати → змінити → записати» можуть загубити зміну.
Що далі
Лекція «JSON: json_encode і json_decode» — як зберегти у файлі не рядок, а цілий масив записів.