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

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

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

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

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

На приведенном ниже изображении показан 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

IncludeRequire
Выдает предупреждение при возникновении ошибки.Не выдает предупреждение.
Выполнение скрипта продолжается при возникновении ошибки.Выполнение скрипта останавливается при возникновении ошибки.

Пример: 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, за исключением ситуаций, когда без запрашиваемого файла не может работать весь скрипт.

Вадим Дворниковавтор-переводчик статьи «PHP Include, Require & Comments»