Перейти до змісту
Intita
Лекція · 35 хв

Файли: читання й запис

Що ви дізнаєтесь

  • Як записати текст у файл і прочитати його цілком
  • Як дописати рядок у кінець файлу і прочитати файл масивом рядків
  • Де тримати файли даних і чому шлях до них будують від __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(), коли немає каталогу: файл вона створює, а каталог — ні.

Файлу list.txt ще немає, $f — шлях до нього. Що виведе код?
<?php
file_put_contents($f, 'чай');
file_put_contents($f, 'кава');
echo file_get_contents($f);

Дописування і читання рядками

Щоб додати рядок у кінець файлу, а не перезаписати його, третім аргументом передають прапорець 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 цієї проблеми не має: він нічого не перечитує, а лише дописує в кінець. Для гостьової книги з кількома записами на день такий ризик прийнятний, а там, де пишуть сотні людей на секунду, дані тримають у базі даних.

У src/storage/admins.txt логіни записано по одному в рядку, серед них taras. Перевірка in_array('taras', file($path)) дає false. Де помилка?

Де лежать файли даних

Поза веб-коренем

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 узгоджує права сам, і цієї помилки зазвичай немає.

Сторінка src/public/guestbook/save.php дописує повідомлення у файл __DIR__ . '/messages.txt'. Будь-хто відкриває http://localhost:8080/guestbook/messages.txt і читає всі повідомлення. Де помилка?

Підсумок

  • 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» — як зберегти у файлі не рядок, а цілий масив записів.