Include

Оператор include дозволяє включати код, що міститься в зазначеному файлі, і виконувати його стільки разів, скільки програма зустрічає цей оператор. Включення може використовуватися кожним з перерахованих способів:

include 'ім'я_файлу';include $file_name;include ("ім'я_файлу");

Приклад. Нехай у файлі params.inc у нас зберігається набір якихось параметрів і функцій. Щоразу, коли нам потрібно буде використовувати ці параметри (функції), ми будемо вставляти в текст нашої основної програми команду include 'params.inc'.

params.inc <?php$user = "Вася";$today = date("d.m.y");/* функція date() повертає датуі час (тут – дату у форматі день.місяць.рік) */?> include.php <?phpinclude ("params.inc"); /* змінні $user і $today задані у файліparams.inc. Тут ми теж можемо ними користуватися завдяки команді include("params.inc") */echo "Привіт, $user!<br>"; // виведе "Привіт, Вася!"echo "Сьогодні $today"; // виведе, наприклад, "Сьогодні 7.07.05"?>

Помітимо, що використання оператора include еквівалентно простій вставці змістовної частини файлу params.inc у код програми include.php. Можливо, тоді можна було б в params.inc записати простий текст без всяких тегів, що вказують на те, що це php-код? Не можна! Справа в тому, що в момент вставки файлу відбувається переключення з режиму обробки PHP у режим HTML. Тому код всередині файлу, що включається, який потрібно обробити як PHP-скрипт, повинен бути вкладений у відповідні теги.

Пошук файлу для вставки відбувається за наступними правилами.

• Спочатку ведеться пошук файлу в include_path щодо поточного робочого каталогу.
• Якщо файл не знайдений, то пошук ведеться в include_path щодо каталога поточного скрипта.
• Параметр include_path, обумовлений у файлі налаштувань PHP, задає імена каталогів, у яких потрібно шукати файли, що включаються.

Наприклад, ваш include_path це. (тобто поточний каталог), поточний робочий каталог це /www/. В основний файл include.php ви включаєте файл my_dir/a.php, що у свою чергу включає b.php. Тоді парсер першою справою шукає файл b.php у каталозі /www/, і якщо такого немає, то в каталозі /www/my_dir/.

Крім локальних файлів, за допомогою include можна включати і зовнішні файли, вказуючи їхні url-адреси. Дана можливість контролюється каталогом url_fopen_wrappers у файлі налаштувань PHP і за замовчуванням, як правило, включена. Але у версіях PHP для Windows до PHP 4.3.0 ця можливість не підтримується зовсім, поза залежністю від url_fopen_wrappers.

include() – це спеціальна мовна конструкція, тому при використанні всередині умовних блоків її потрібно взяти у фігурні дужки.

<?php/* Це невірний запис. Одержимо помилку. Ми ж вставляємо не одну команду, а декілька, вони лиш записані в іншому файлі */if ($condition) include("first.php");else include("second.php");// А от так правильно. if ($condition){ include("first.php"); }else { include("second.php"); }?>

При використанні include можливі два види помилок – помилка вставки (наприклад, не можливо знайти зазначений файл, невірно написана сама команда вставки і т.п.) або помилка виконання (якщо помилка міститься у файлі, що вставляється,). У будь-якому випадку при помилці в команді include виконання скрипта не завершується.