Вызов файлов через PHP

PHP

Как только сайт расширится, став не просто «одностраничником», а более серьёзным проектом, возникнет необходимость синхронизации кода между разными файлами. Чтобы не редактировать каждый документ даже ради незначительных исправлений, советуется воспользоваться функциями PHPinclude();и require();, а также include_once();, require_once();.

Подобное можно совершить с помощью JS, указав document.writeIN();и в последствии вызывая нужное содержимое через теги <scriptsrc=»…»></script>. Минусом этого варианта является обработка на стороне посетителя сайта, вызывающая замедление загрузки сайта у пользователей слабых устройств. Содержимое, отправленное посредствами JavaScript, может быть проигнорировано поисковыми системами, а ещё один недостаток проявляется в несовместимости данного варианта с решениями, предполагающими выполнение действий на стороне back-end.

Обзор функций include»file.php»; include_once»file.php»; require»file.php»; require_once»file.php»;

Как и в документации, написанной создателями PHP, для описания предмета этой статьи используется слово «функция», когда подразумевается конструкционная единица языка. К этой группе относятся, к примеру, echo и print, вместе с рассматриваемыми require();, include(); и подобными не требующие, но поддерживающие заключения значений в скобки.

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

require(); и include(); служат для встраивания документов на серверной стороне, ввиду чего скорость загрузки не зависит от клиентских мощностей. Это же приводит к необходимости указывать полный путь файлов, не видимый простым посетителям ресурса и получаемый через элемент супермассива $_SERVER–DOCUMENT_ROOT. Его также можно прописывать вручную.

Обе функции действуют в обход заданных с помощью .htaccessпараметров чтения, что позволяет скрыть от пользователей файлы, которые не должны быть им доступны по-отдельности, не «ломая» работу программ.

Псевдо-функции имеют идентичный синтаксис и, более того, принцип работы. Отличие require(); от include(); заключается в том, что первый при некорректной выдаёт фатальную ошибку, а второй – предупреждение. С точки зрения безопасности require(); более надёжен, так как в случае каких-либо проблем с запрашиваемым содержимым скрипт просто не выполнится. А include(); лучше поставить на вывод нужных, но некритичных в случае возникновения каких-либо проблем документов.

Те же функции, но с постфиксом _once, отличаются отсутствием повторного переопределения на случай, если файл уже вызывался во время исполнения программы. К примеру, require_once(); и include_once(); полезны, когда необходимость запроса контента определяется результатами условий.

Распространённые проблемы

Указание видимого пути вместо абсолютного

Чтобы узнать путь, стоящий перед видимым, следует обратиться к $_SERVER[‘DOCUMENT_ROOT’], как к элементу массива. Далее остаётся дописать расположение документа, видимое в браузере, обрезав доменное имя ресурса.

Отсутствие кавычек

Содержимое этих псевдо-функций следует обворачивать в двойные кавычки(«») или секунды (») из-за присутствия точек между названиями и форматами документов. Интерпретатор распознаёт их, как попытку добавить какое-либо значение к существующему. Точки можно использовать для вызова переменной и/или функций, вручную определённой информации вместе.

Невозможность управления заголовками

Причиной ошибки, возникающей при отправке заголовков или cookiesи представленной невозможностью продолжения запланированной работы программы, может стать не только исходный файл, но и вложенные в него документы. К примеру, они могут быть сохранены в кодировке с BOM, иметь ненужные пробелы и переносы строки после закрывающих PHP-скрипты тегов (либо перед открывающими) и прочие моменты, приводящие к ошибке, рассмотренной сообществом.

Советы

  • Если запрашиваемый документ полностью состоит из PHP-кода, необязательно добавлять ?> в конец документа. Интерпретатор автоматически отслеживает или наличие данного фрагмента, или конец файла, что не приведёт к ошибкам, предупреждениям и даже нотификациям внутри лога.
  • В большие программы рекомендуется добавлять комментарии, а лучшим сценарием станет также предоставление описания файла с помощью документирования в самом начале. Туда же не будет лишним включить примеры страниц, которые могут ссылаться на программу.
  • Подобным образом можно задействовать не только PHP-содержимое. Пример пользования – вывод футера или хедера с мгновенным обновлением на всех страницах. Содержимое может быть представлено в, например, формате .html.
  • Контент, получаемый подобным образом, может быть и не «нацелен» на вывод какой-либо информации пользователю напрямую. К примеру, так можно задействовать функции, переменные из других документов, не определяя их повторно.
  • Нет разницы, используются ли шорт-теги (<?) или полные (<?php). Главное – допустимость их обработки (при необходимости), устанавливаемая в конфигурации веб-сервера.

Примеры использования

Запрос компонентов сайта по-отдельности

<!DOCTYPE HTML>
<html>
<head>
<meta charset=»utf-8″ />
<title>Мой сайт</title>
</head>
<body>
<header>
<?include($_SERVER[‘DOCUMENT_ROOT’].»/folder/of/header.php»);?>
</header>
<main>
В чащах юга жил-был цитрус… — да, но фальшивый экземпляръ!
</main>
<footer>
<?include($_SERVER[‘DOCUMENT_ROOT’].»/folder/of/footer.php»);?>
</footer>
</body>
</html>

Далее нужно создать файлы header.php и footer.php, указать к ним верные директории. Код демонстрирует встраиваемость функций языка PHP и позволяет быстро редактировать компоненты страниц, выведенные в отдельные файлы– не нужно вносить изменения отдельно для каждого документа, достаточно обновить один из них, к которому будут обращаться остальные скрипты.

Здесь запрашивается единица супермассива, дополняющаяся к видимому пути файла через точку.

Обязательный запрос

<?php
require($_SERVER[‘DOCUMENT_ROOT’].»/very/important/file.php»);

Если возникнут проблемы с заданным файлом, вся программа не будет работать. В остальном функция работает как и include();.

Оцените статью
Образовательный портал WELCOME4U.RU
Добавить комментарий

Adblock
detector