Урок 7. Файлы и подключение: include и require

У сайта много страниц, но шапка, меню и подвал на них одинаковые. Копировать их в каждый файл — плохая идея: правка меню превратится в правку двадцати файлов. В PHP общие части выносят в отдельные файлы и подключают командой require.

Сайт из частей

Файл header.php — начало каждой страницы:

<!DOCTYPE html>
<html lang="ru">
<head>
    <meta charset="utf-8">
    <title><?= htmlspecialchars($title) ?></title>
</head>
<body>
<nav><a href="/">Главная</a> · <a href="/about.php">О сайте</a></nav>

Файл footer.php — конец:

<footer>© <?= date('Y') ?></footer>
</body>
</html>

Страница index.php задаёт заголовок и подключает обе части:

<?php
$title = 'Главная';
require __DIR__ . '/header.php';
?>
<h1>Добро пожаловать</h1>
<p>Текст главной страницы.</p>
<?php require __DIR__ . '/footer.php'; ?>

Подключённый файл выполняется так, будто его текст вставлен на место require. Поэтому header.php видит переменную $title из index.php. Страница about.php устроена так же, только со своим заголовком и текстом.

include, require и _once

Почти всегда нужен require: без шапки или настроек страница всё равно не заработает, и лучше сразу увидеть ошибку. Файлы с функциями и классами подключают через require_once — повторное объявление функции вызвало бы ошибку Cannot redeclare.

Зачем __DIR__

__DIR__ — встроенная константа: папка, где лежит текущий файл. Путь от __DIR__ одинаково работает отовсюду:

<?php
require __DIR__ . '/inc/functions.php';
require __DIR__ . '/../config.php';

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

Без __DIR__ путь легко сломать. Путь вроде require 'inc/menu.php' PHP ищет не от папки файла, а по списку папок include_path и от текущей рабочей папки. Пути с ./ и ../ — только от рабочей папки. Рабочая папка — та, из которой запущен скрипт, и она не всегда совпадает с папкой файла. Особенно часто путаница случается, когда файлы подключают друг друга из разных папок.

Файл настроек

Подключённый файл может вернуть значение через return. Так удобно хранить настройки:

<?php
return [
    'db_host' => 'localhost',
    'db_name' => 'shop',
    'per_page' => 20,
];

Если это файл config.php, настройки читаются одной строкой:

<?php
$config = require __DIR__ . '/config.php';
echo $config['per_page'];

Файлы с паролями держите вне папки, которую видно из интернета, и не добавляйте их в публичные репозитории.

Чтение и запись файлов

Простые операции делаются одной функцией:

<?php
$file = __DIR__ . '/notes.txt';
file_put_contents($file, "Первая строка\n");
file_put_contents($file, "Вторая строка\n", FILE_APPEND);
echo file_get_contents($file);
$lines = file($file, FILE_IGNORE_NEW_LINES);
echo count($lines) . "\n";

Первая строка
Вторая строка
2

• file_put_contents записывает строку в файл и создаёт его, если файла нет. Без флага файл перезаписывается, с FILE_APPEND — дописывается в конец.
• file_get_contents читает весь файл в строку.
• file читает файл в массив строк; FILE_IGNORE_NEW_LINES убирает переводы строк в конце каждой.

Если в файл одновременно пишут несколько посетителей, добавьте блокировку: FILE_APPEND | LOCK_EX. Тогда записи не перемешаются.

Большой файл (журнал на сотни мегабайт) целиком в память не читают, а идут по строкам:

<?php
$handle = fopen(__DIR__ . '/notes.txt', 'r');
if ($handle === false) {
    exit("Файл не открылся\n");
}
while (($line = fgets($handle)) !== false) {
    echo mb_strtoupper(trim($line)) . "\n";
}
fclose($handle);

fopen открывает файл ('r' — для чтения, 'w' — для записи с очисткой, 'a' — для дописывания), fgets читает очередную строку и возвращает false в конце файла, fclose закрывает файл.

Проверить, есть ли файл, — file_exists($path) или is_file($path); удалить — unlink($path); создать папку — mkdir($path).

Права на сервере

На Linux-сервере PHP работает от имени пользователя веб-сервера (в Ubuntu и Debian это обычно www-data). Если у него нет права писать в папку, запись закончится предупреждением Failed to open stream: Permission denied. Дайте право на запись только той папке, куда сайт действительно пишет (например, data или uploads), а не всему сайту.

Опасно: имя файла из адреса

Безопасный способ — список разрешённых страниц:

<?php
$pages = [
    'home' => 'home.php',
    'about' => 'about.php',
    'contacts' => 'contacts.php',
];
$page = $_GET['page'] ?? 'home';
if (!isset($pages[$page])) {
    http_response_code(404);
    $page = 'home';
}
require __DIR__ . '/pages/' . $pages[$page];

Посетитель выбирает только ключ, а имя файла берётся из списка, который составили вы.

Частые ошибки

• Failed to open stream: No such file or directory у require — неверный путь: он записан без __DIR__, в имени опечатка или другой регистр букв. Подробно — справка Как подключить файл.
• Cannot redeclare — файл с функциями подключён дважды. Подключайте его через require_once.
• Permission denied при записи — у PHP нет права писать в папку (раздел «Права на сервере» выше).
• Ошибка headers already sent после подключения файла — в нём пустая строка или пробел до <?php или после ?>: этот текст ушёл в браузер раньше заголовков (справка headers already sent).

Коротко

• Общие части сайта выносят в файлы и подключают require __DIR__ . '/файл.php'.
• require при ошибке останавливает программу, include — только предупреждает; _once не подключает файл дважды.
• __DIR__ — папка текущего файла: путь от неё работает из любого места.
• file_put_contents пишет (с FILE_APPEND — дописывает), file_get_contents читает, file — в массив строк.
• Имя подключаемого файла из адреса или формы — только через список разрешённых.

Проверьте себя