PHP Учебник

PHP Старт Введение в PHP Установка PHP Синтаксис PHP Комментарии в PHP Переменные PHP PHP Echo / Print Типы данных PHP Строки PHP Числа PHP Математика в PHP Константы PHP Операторы PHP PHP If...Else...Elseif PHP Switch Циклы в PHP Функции PHP Массивы PHP PHP Суперглобальные PHP RegEx

PHP Формы

Обработка форм PHP Валидация форм PHP Обязательные поля Валидация URL/E-mail Полная форма PHP

PHP Продвинутый

PHP Дата и время PHP Include/Require PHP Работа с файлами Открытие/Чтение файлов Создание/Запись файлов PHP Загрузка файлов Файлы cookie PHP Сессии PHP Фильтры PHP Расширенные фильтры PHP Функция Callback PHP JSON PHP Исключения

PHP OOP

Что такое ООП в PHP Классы/Объекты PHP Цепочки методов PHP Конструктор PHP Деструктор PHP Модификаторы доступа Наследование в PHP Константы класса PHP Подсказка типов PHP Подсказка интерфейсов Абстрактные классы PHP PHP Интерфейсы PHP Полиформизм PHP Трейты Статические методы PHP Статические свойства PHP Пространства имен PHP Итерируемые объекты

База данных MySQL

База данных MySQL Подключение к MySQL Создание БД MySQL Создание таблицы MySQL Вставка данных MySQL Получить ID MySQL Подготовленные операторы PHP MySQL Получение данных MySQL Предложение WHERE Предложение ORDER BY Обновление данных MySQL Удаление данных БД MySQL Limit Data

PHP XML

Парсеры PHP XML Парсер PHP SimpleXML Получить PHP SimpleXML PHP XML Expat PHP XML DOM

PHP - AJAX

AJAX Введение AJAX PHP AJAX База Данных AJAX XML AJAX Живой поиск AJAX Опрос

PHP Примеры

PHP Примеры Практика ООП PHP PHP квиз-тест Упражнения Базовый PHP Упражнения Алгоритмы Упражнения Массивы Упражнения Цикл for Упражнения Функции Регулярные выражения Упражнения Дата PHP Упражнения Строки PHP Математика PHP Упражнения Формы PHP Упражнения Классы PHP Упражнения JSON PHP PHP Задачник


PHP | Конструкция включений include




PHP позволяет создавать различные функции и элементы, которые многократно используются на нескольких страницах. Создание и повтор сценария одной и той же функции на нескольких страницах сайта требует затрат усилий и времени. Эту задачу можно облегчить, если использовать концепцию включения файлов, которая помогает нам включать различные файлы (текст или коды) в одну программу, что избавит нас от необходимости многократно писать полную функцию или код. Эта концепция также дает еще одно преимущество — если понадобится изменить какой-либо код тогда, вместо того, чтобы редактировать его во всех файлах, мы просто отредактируем исходный файл, и все сценарии сайта будут автоматически изменены. Есть две функции, которые можно использовать для включения одного файла PHP в другой файл PHP:

  • Функция include()
  • Функция require()

Содержимое одного файла PHP в другой файл PHP (до того, как сервер выполнит его), можно вставить с помощью оператора include или require.

Эти две конструкции идентичны во всём, кроме обработки сбоя в программе:

require
выдаст фатальную ошибку (E_COMPILE_ERROR) и остановит выполнение скрипта
include
выдаст только предупреждение (E_WARNING), но сценарий продолжится

Итак, если необходимо, чтобы выполнение сценария продолжалось и пользователю был показан вывод, даже если включаемый файл отсутствует, используйте оператор include. В противном случае например, когда вы используете FrameWork, CMS или сложный код PHP-приложения, всегда используйте оператор require для включения файла-ключа в поток выполнения сценария. Это поможет избежать нарушения безопасности и целостности вашего приложения на случай, если один ключевой файл случайно пропадет.

Функция include позволяет подключать и присоединять к вашему PHP-сценарию другие сценарии. При запуске программы интерпретатор просто заменит инструкцию на содержимое подключаемого файла. Это происходит до того, как сервер выполнит код.

Предположим, у нас есть стандартный файл нижнего колонтитула для сайта с именем "footer.php", который выглядит так:

<?php
echo "<p>Copyright © 2017-" . date("Y") . " wm-school.ru</p>";
?>
Чтобы включить файл "footer.php" на страницу сайту, воспользуемся оператором 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":

<?php   
  function foo() {  
     // объявили $car глобальной переменной
     global $car; 
     include 'add.php'; 
     echo "Внутри функции: $car $color";
  }

  foo();
  echo "<br>В глобальной области: $car";
?>

Так как внутри функции мы объявили переменную $car глобальной, она становится также доступной и в глобальной области видимости.


Функция require() берет содержимое из указанного файла и копирует его в файл, который использует функцию включения. Если при загрузке файла возникает проблема, функция require() генерирует фатальную ошибку и останавливает выполнение скрипта.

Как вы уже поняли, нет никакой разницы между require() и include(), за исключением того, что они по разному обрабатывают условия ошибки. Рекомендуется использовать функцию require() вместо include(), поскольку скрипты не должны продолжать выполнение, если файлы отсутствуют или имеют неправильное имя.

Вы можете попробовать использовать приведенные выше пример с функцией require() и результат будет тот же. Но если вы попробуете следовать двум примерам, в которых файл не существует, вы получите разные результаты:

<!DOCTYPE html>
<html>
<body>

<h1>Добро пожаловать на мою домашнюю страницу!</h1>
<?php include 'noFileExists.php';
echo "Я имею $color $car.";
?>

</body>
</html>

Теперь давайте попробуем тот же пример с функцией require():

<!DOCTYPE html>
<html>
<body>

<h1>Добро пожаловать на мою домашнюю страницу!</h1>
<?php require 'noFileExists.php';
echo "Я имею $color $car.";
?>

</body>
</html>

На этот раз выполнение файла в точке подключения файла останавливается и после него ничего не отображается.

Примечание: Вы можете получить простые предупреждающие сообщения или сообщения о фатальных ошибках или вообще ничего. Это зависит от конфигурации вашего PHP-сервера.

Проверь себя с помощью упражнений

Задача:

Напишите правильный синтаксис, чтобы включить файл с именем "banner.php".

<?php ;?>





Профессия‌ ‌PHP-разработчик‌ Совет эксперта
Освойте PHP и MySQL с нуля в игровой форме
Профессия‌ ‌PHP-разработчик‌ Совет эксперта
На рынке не хватает веб-разработчиков
Профессия‌ ‌PHP-разработчик‌
На рынке не хватает веб-разработчиков
Профессия‌ ‌PHP-разработчик‌ Совет эксперта
Освойте популярный PHP-фреймворк
Профессия‌ ‌PHP-разработчик‌ Совет эксперта
На рынке не хватает fullstack-разработчиков!
PHP-разработчик с нуля до PRO
Обучение в рассрочку
Профессия‌ ‌PHP-разработчик‌ Совет эксперта
Учитесь сейчас, платите потом!
Профессия‌ ‌PHP-разработчик‌ Выберите специальность
Учитесь сейчас, платите потом!