Include, Require и комментарии PHP

В этой статье мы рассмотрим:

• Комментарии PHP;
• Для чего использовать комментарии?;
• PHP include и include_once;
• Пример: include / include_once;
• PHP require и require_once;
• Пример: require;
• Require по сравнению с Require_once.

Комментарии PHP

• Комментарии помогают понять код;
• Комментарии поясняют, что делает код;
• Однострочный комментарий начинается с двойной косой черты // и заканчивается в конце строки:

• Комментарий из нескольких строк начинается с косой черты, за которой следует звездочка /*, и заканчиваются звездочкой и косой чертой */:

На приведенном ниже изображении показан PHP-файл с однострочным комментарием и комментарием из нескольких строк:

PHP Include и PHP include_once

Оператор include используется для подключения других файлов. Он доступен в двух вариантах: include и PHP include_once. Последний игнорируется интерпретатором, если файл уже был подключен.

Синтаксис оператора include:

<?php
Include/include_once 'file_name';
?>

Где:

• Include/include_once - это оператор, который подключает файл;
• 'file_name' - имя подключаемого файла.

Пример: Include / Include_once

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

В этом случае можно создать общий header, а затем подключать его на каждой странице с помощью include path PHP. Давайте посмотрим, как это можно сделать.

Мы создадим для файла:

header.php
<a href="/index.php">Home</a>
<a href="/aboutus.php">About us</a>
<a href="/services.php">Services</a>
<a href="/contactus.php">Contact Us</a>
 index.php
<?php
include 'header.php';
?>

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

PHP Require & PHP require_once

Оператор require имеет два варианта: require и require_once. Он также используется для подключения файлов.

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

Он имеет следующий синтаксис:

<?php
require/require_once 'file_name';
?>

Где:

• require/require_once - оператор подключения файла;
• 'file_name' - файл, который должен быть подключен.

Разница между Include и Require

Пример: Require

Предположим, что мы разрабатываем приложение для работы с базой данных. Можно создать конфигурационный файл, который будет подключаться на всех страницах проекта с помощью require:

config.php
<?php
$config['host'] = 'localhost';
$config['db'] = 'my_database';
$config['uid'] = 'root';
$config['password'] = '';
?>

Рассмотрим пример подключения конфигурационного файла:

pages_model.php
<?php
require 'config.php'; //подключаем конфигурационный файл
// другой код для подключения к базе данных
?>

Require и Require_once

• Заголовок, футер, сайдбар могут быть общими для многих страниц. Это позволяет изменять сайт, обновив один файл;
• Параметры конфигурации базы данных, пользовательские функции могут быть общими для многих страниц, что позволяет обеспечить использование на сайте / в приложении одинаковых настроек;
• Операторы PHP include или require используются для подключения файлов;
• Include_once / require_once игнорируется, если запрашиваемый файл уже подключен с использованием любого из четырех операторов;
• Оператор include выдает предупреждение и продолжает исполнение кода, если запрашиваемый файл не был найден;
• Оператор require вызывает фатальную ошибку и останавливает выполнение скрипта;
• В большинстве случаев должен использоваться оператор include, за исключением ситуаций, когда без запрашиваемого файла не может работать весь скрипт.

Заключение

• Комментарии используются, чтобы помочь нам понять код;
• Однострочные комментарии начинаются с двойной косой черты //;
• Комментарии из нескольких строк заключены в /* */;
• Операторы PHP include, include_once, require и require_once используются для подключения файлов;
• Include_once / require_once игнорируются, если запрашиваемый файл уже подключен с использованием любого из четырех операторов;
• Оператор include выдает предупреждение и продолжает исполнение кода, если запрашиваемый файл не был найден;
• Оператор require вызывает фатальную ошибку и останавливает выполнение скрипта;
• В большинстве случаев должен использоваться оператор include, за исключением ситуаций, когда без запрашиваемого файла не может работать весь скрипт.