Комментарии PHP, Include/Include_once, Require/Require_once

Автор: Фиона Браун Фиона Браун
Hours обновлено

Зачем использовать комментарии?

  • Если вы какое-то время не работаете над исходным кодом, легко забыть, что этот код делает. Комментирование исходного кода помогает запомнить, что он делает.
  • Комментирование исходного кода также очень важно, когда над одним проектом работают несколько разработчиков. Изменения, внесенные одним разработчиком, могут быть легко поняты другими разработчиками, просто прочитав комментарии.
  • Рекомендуется иметь 3 строки комментариев на каждые 10 строк кода.

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

  • Комментарии помогают нам понять код
  • Комментарии — это пояснения, которые мы включаем в наш исходный код. Эти комментарии предназначены для человеческого понимания.
  • Однострочные комментарии начинаются с двойной косой черты // и заканчиваются на той же строке.
  • Комментарии PHP
  • Многострочные комментарии начинаются с косой черты, за которой следует звездочка /*, и заканчиваются звездочкой, за которой следует косая черта */.
  • Комментарии PHP

На диаграмме ниже показан файл PHP как с многострочными, так и с однострочными комментариями.

Пример PHP

Пример комментариев PHP

PHP Include и PHP Include_once

Оператор PHP «include» используется для включения других файлов в файл PHP.

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

Оператор включения имеет следующий синтаксис

<?php
include 'file_name';
?>

Инструкция include_once имеет следующий синтаксис

<?php
include_once 'file_name';
?>

ВОТ,

  • «Include/include_once» — это оператор, включающий файл.
  • «имя_файла» — это имя файла, который необходимо включить.

Пример: включить/Include_once

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

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

  • Мы создадим 2 имени файла
  • заголовок.php, индекс.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';

?>

На странице заголовка выше будет выведено

PHP Require и PHP require_once

Оператор require имеет два варианта: require и require_once.

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

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

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

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

ВОТ,

  • «require/require_once» — это оператор, включающий файл
  • «имя_файла» — это имя файла, который необходимо включить.

Пример: Требовать

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

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

<?php

$config['host'] = 'localhost';

$config['db'] = 'my_database';

$config['uid'] = 'root';

$config['password'] = '';

?>

Давайте теперь посмотрим на пример кода, для которого требуется файл конфигурации. Страницы_модель.php

<?php

require 'config.php'; //require the config file

//other code for connecting to the database

?>

PHP включает или требует

Разница между включением/требованием

Включают Требовать
Выдает предупреждение при возникновении ошибки Не выдает предупреждение
Выполнение скрипта продолжается при возникновении ошибки Выполнение скрипта прекращается при возникновении ошибки.

Как правило, рекомендуется использовать оператор include, чтобы в случае возникновения ошибки выполнение сценария продолжало отображать адрес электронной почты веб-мастера или страницу контактов с нами.

Оператор require следует использовать, если весь сценарий не может работать без запрошенного файла.

Операторы «include» и «require» можно использовать в любой строке исходного кода, где вы хотите, чтобы код отображался.

Итого

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

Вы могли бы: