функція include
Include має наступний синтаксис:
include "назва файлу";
Як назва вказується відносний або абсолютний шлях з розширенням підключається документа. Якщо розміщення не вказано, PHP автоматично перевірить вміст конфігураційного php.ini, в якому вказується include_path - директорія, в якій можуть розміщуватися додаткові бібліотеки. Якщо директива виявиться порожня або за вказаною в ній шляху також не знайдено необхідного файлу, вираз include буде проігноровано.
Після включення ви можете використовувати потрібний вміст в скрипті, привласнювати змінні, використовувати оголошені конструкції і т.п. Наприклад, існують 2 файли 1.php і 2.php. Вміст 1.php виглядає наступним чином:
lt;? php
$ Firstly = "variable from the first file" -
$ Secondly = "imported value" -
?gt;
Щоб включити в 2.php змінні, зазначені вище, можна виконати наступну операцію:
lt;? php
Include "1.php" -
echo $ firstly-
$ Emerge = "$ secondly" -
echo $ emerge-? gt;
В даному скрипті другого файлу командою include підключається вміст першого документа, після чого використовуються оголошені в 1.php змінні для виведення необхідних значень на екрані.
Include може використовуватися як на самому початку файлу, так і всередині оголошується функції в будь-якій частині документа. Небажано використовувати функцію для підключення файлів, що знаходяться на віддаленому сервері. Якщо ви хочете реалізувати дану можливість, вам буде потрібно включити опцію allow_url_fopen в файлі php.ini на вашому локальному або віддаленому сервері.
Require
Функція require є аналогічною include. Команди не відрізняються по синтаксису і за технологією виконання. Єдиною відмінністю є те, що при відсутності зазначеного файлу require припиняє роботу скрипта, в той час як include продовжить виконання скрипта і виведе відповідне попередження E_WARNING, яке можна придушити за допомогою спеціального символу @. наприклад:
lt;? php
require "1q.php" -
echo "Script stops working" -? gt;
В даному прикладі вказано шлях до неіснуючого документа 1q.php. Якщо файл відсутній, скрипт не виконає команду echo, а на екрані користувача буде або порожній лист, або повідомлення про помилку (в залежності від налаштувань php.ini). Якщо ввести аналогічний код з використанням include:
lt;? php
include "1q.php" -
echo "Script continues" -? gt;
Команда echo буде виконана, і на дисплеї з`явиться відповідний текст.