PHP | Конструкция включений include
PHP позволяет создавать различные функции и элементы, которые многократно используются на нескольких страницах. Создание и повтор сценария одной и той же функции на нескольких страницах сайта требует затрат усилий и времени. Эту задачу можно облегчить, если использовать концепцию включения файлов, которая помогает нам включать различные файлы (текст или коды) в одну программу, что избавит нас от необходимости многократно писать полную функцию или код. Эта концепция также дает еще одно преимущество — если понадобится изменить какой-либо код тогда, вместо того, чтобы редактировать его во всех файлах, мы просто отредактируем исходный файл, и все сценарии сайта будут автоматически изменены. Есть две функции, которые можно использовать для включения одного файла PHP в другой файл PHP:
- Функция
include() - Функция
require()
Include или require?
Содержимое одного файла PHP в другой файл PHP (до того, как сервер выполнит его), можно вставить с помощью оператора include или require.
Эти две конструкции идентичны во всём, кроме обработки сбоя в программе:
require- выдаст фатальную ошибку (E_COMPILE_ERROR) и остановит выполнение скрипта
include- выдаст только предупреждение (E_WARNING), но сценарий продолжится
Итак, если необходимо, чтобы выполнение сценария продолжалось и пользователю был показан вывод, даже если включаемый файл отсутствует, используйте оператор include. В противном случае например, когда вы используете FrameWork, CMS или сложный код PHP-приложения, всегда используйте оператор require для включения файла-ключа в поток выполнения сценария. Это поможет избежать нарушения безопасности и целостности вашего приложения на случай, если один ключевой файл случайно пропадет.
Функция include()
Функция include позволяет подключать и присоединять к вашему PHP-сценарию другие сценарии. При запуске программы интерпретатор просто заменит инструкцию на содержимое подключаемого файла. Это происходит до того, как сервер выполнит код.
Предположим, у нас есть стандартный файл нижнего колонтитула для сайта с именем "footer.php", который выглядит так:
echo "<p>Copyright © 2017-" . date("Y") . " wm-school.ru</p>";
?>
include:
Пример
Попробуй сам »<html>
<body>
<h1>Это заголовок главной страницы!</h1>
<p>Контент главной страницы.</p>
<p>Ещё контент главной страницы.</p>
<?php include 'footer.php';?>
</body>
</html>
В следующем примере создадим общее меню для своего веб-сайта. Сначала создайте файл menu.php со следующим содержимым:
menu.php
<?php
echo '<a href="/index.html">Home</a> -
<a href="/html/default.html">Уроки HTML</a> -
<a href="/css-tasks/exercise1.php">Уроки CSS</a> -
<a href="/js/index.php">Уроки JavaScript</a> -
<a href="index.php">Уроки PHP</a>';
?>
Теперь создайте столько страниц, сколько хотите, и включите этот файл для создания меню:
Пример
Попробуй сам »<html>>
<body>
<?php include 'menu.php';?>
<h1>Это заголовок главной страницы!</h1>
<p>Контент главной страницы.</p>
<p>Ещё контент главной страницы.</p>
<?php include 'footer.php';?>
</body>
</html>
Подключение внутри функции
Если подключение файла происходит внутри функции, тогда весь код, содержащийся во включаемом файле, будет вести себя так, как будто он был определен внутри этой функции, т.е. код будет иметь локальную область видимости.
Предположим, у нас есть файл с именем "add.php", в котором определены некоторые переменные:
add.php
<?php
$color='Красный';
$car='BMW';
?>
Теперь создадим другой файл и назовем "test.php" с функцией внутри, в котором мы подключим файл "add.php":
test.php
Попробуй сам »<?php
function foo() {
// объявили $car глобальной переменной
global $car;
include 'add.php';
echo "Внутри функции: $car $color";
}
foo();
echo "<br>В глобальной области: $car";
?>
Так как внутри функции мы объявили переменную $car глобальной, она становится также доступной и в глобальной области видимости.
Функция require()
Функция require() берет содержимое из указанного файла и копирует его в файл, который использует функцию включения. Если при загрузке файла возникает проблема, функция require() генерирует фатальную ошибку и останавливает выполнение скрипта.
Как вы уже поняли, нет никакой разницы между require() и include(), за исключением того, что они по разному обрабатывают условия ошибки. Рекомендуется использовать функцию require() вместо include(), поскольку скрипты не должны продолжать выполнение, если файлы отсутствуют или имеют неправильное имя.
Вы можете попробовать использовать приведенные выше пример с функцией require() и результат будет тот же. Но если вы попробуете следовать двум примерам, в которых файл не существует, вы получите разные результаты:
test.php
Попробуй сам »<!DOCTYPE html>
<html>
<body>
<h1>Добро пожаловать на мою домашнюю страницу!</h1>
<?php include 'noFileExists.php';
echo "Я имею $color $car.";
?>
</body>
</html>
Теперь давайте попробуем тот же пример с функцией require():
test.php
Попробуй сам »<!DOCTYPE html>
<html>
<body>
<h1>Добро пожаловать на мою домашнюю страницу!</h1>
<?php require 'noFileExists.php';
echo "Я имею $color $car.";
?>
</body>
</html>
На этот раз выполнение файла в точке подключения файла останавливается и после него ничего не отображается.
Примечание: Вы можете получить простые предупреждающие сообщения или сообщения о фатальных ошибках или вообще ничего. Это зависит от конфигурации вашего PHP-сервера.
