Конструкция PHP include

Конструкция include позволяет загружать код из одного файла в другой. Её синтаксис выглядит так:

Здесь после ключевого слова include указывается путь к файлу. Например, чтобы подключить файл functions.php в index.php, используется такой оператор:

Если PHP не сможет найти файл functions.php в каталоге src, будет выдано предупреждение, например:

При подключении файла PHP сначала ищет его в каталоге, указанном в директиве include_path. Если файл найден, его код загружается. В противном случае поиск продолжается в каталоге вызывающего скрипта и текущей рабочей директории. Если файл так и не найден, выводится предупреждение.

Когда PHP загружает файл, он выполняет весь код внутри него. Например, если в functions.php будет такой код:

и этот файл подключён в index.php, то при запуске вы увидите:

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

На практике include часто используют для подключения общих элементов сайта, например, шапки и подвала. Чтобы не дублировать их на каждой странице, код выносят в отдельные файлы (например, header.php и footer.php) и подключают их там, где нужно.

Обычно такие файлы размещают в отдельной папке, по соглашению её называют inc:

В файле header.php размещается код шапки страницы, включая ссылку на таблицу стилей:

В файле footer.php код подвала:

В index.php подключение выглядит так:

При запуске index.php в исходном коде страницы вы увидите содержимое и из header.php, и из footer.php.

При подключении файла все переменные, определённые в нём, наследуют область видимости того места, где стоит оператор include.

Если определить переменные в functions.php:

и подключить этот файл в index.php, переменные станут глобальными и их можно использовать так:

Если же подключить файл внутри функции, переменные будут локальными для этой функции:

В этом случае переменные $title и $content будут видны только внутри функции.

Используйте конструкцию PHP include для загрузки кода из другого файла скрипта. Это удобно для организации структуры проекта и повторного использования кода.