Включення модулів в РНР
Функція include ()
Більш докладно про функції включення модулів
• include () і require () - підключають і обчислює специфікований файл.
Ці дві конструкції ідентичні у всьому, за винятком того, як вони обробляють невдале виконання.
include () видає Warning !. а require () видає Fatal Error. Інакше кажучи, не бійтеся використовувати require (). якщо вам потрібно, щоб відсутній файл зупиняв обробку сторінки. include () не працює таким чином: скрипт все одно продовжить роботу.
Коли файл підключений, що міститься в ньому код успадковує область видимості змінної рядка, на якій виникло підключення. Будь-які змінні, доступні на цьому рядку в зухвалій файлі, будуть доступні в викликається файлі, вперед від цієї точки.
Базовий приклад include ().
Базові приклади require ().
Якщо підключення виникає всередині функції в викликається файлі, то весь код, що міститься у включається файлі, буде працювати так, як якщо б він був визначений всередині. Так що він буде слідувати області видимості змінної.
Підключення всередині функцій:
Коли файл підключається, розбір переходить з режиму PHP в режим HTML на початку цільового файлу і знову продовжує після кінця. Виходячи з цього, будь-який код всередині файлу призначення, який повинен виконуватися як PHP-код, зобов'язаний бути укладений в правильні стартовий і кінцевий теги РНР.
Приклад include () через HTTP
Оскільки include () і require () є спеціальними конструкціями мови, ви зобов'язані укласти їх в блок операторів, якщо це всередині умовного блоку.
Приклад include () і умовні блоки:
Обробка повертає: можна виконати оператор return () всередині підключеного файлу, щоб перервати обробку цього файлу і повернутися в скрипт, який викликав його. Також можна повертати значення з підключених файлів. Ви можете прийняти значення виклику include як зазвичай.
Приклади include () і return ().
$ Bar має значення 1. оскільки підключення було успішним. Зверніть увагу на відмінності в прикладах. Перший використовує return () всередині підключеного файлу, а інші - ні.
• include_once () і require_once () - включають і обчислюють специфікований файл в процесі виконання скрипта. Це поведінка нагадує оператори include () і require () з тією лише різницею, що, якщо код з файлу вже був підключений, він не буде підключений ще раз. include_once () і require_once () повинні використовуватися в тих випадках, коли один і той же файл може бути підключений і обчислений більш ніж один раз на процесі певного виконання скрипта, а ви хочете мати впевненість, що він включений точно один раз, щоб уникнути проблем з повторним визначенням функцій, перепризначення змінних.
Приклади include_once () і require_once ().
• get_included_files - повертає масив імен всіх файлів, які включені з використанням include (). include_once (). require () або require_once ().
• get_required_files - ця функція є псевдонімом для get_included_files (). Файли, включені або витребувані кілька разів, показані в повернутому масиві тільки один раз.
Примітка. файли, включені з використанням директиви конфігурації auto_prepend_file. не входять до повертається масив.
згенерує на виведення:
• include_path string - специфікує список директорій, де функції require (). include () і fopen_with_path () шукають файли. Формат нагадує системну змінну оточення PATH: список директорій, розділених двокрапкою в UNIX або точкою коми - в Windows.
Приклад UNIX include_path.
Приклад Windows include_path.
Значення. за замовчуванням: . (Тільки поточна директорія).
безпечне програмування
або запобігання include PHP-ін'єкцій
Найбільш частою помилкою з цією функцією є код:
в якому змінна $ module передається як параметр з аресной рядки виклику до скрипту (наприклад, index.php? module = main.php).
Помилка коду в тому, що вхідний параметр приймаються і використовуються без перевірки. До вмісту змінної $ module просто додається «.php» і за отриманим шляху підключається файл.
Потенційно небезпечними в цьому відношенні є функції:
• preg_replace () (з модифікатором «e»),
Можна зробити фільтри на цю змінну, але найкращим вирішенням цієї проблеми є наступні варіанти:
Конструкція з оператором switch. наприклад так:
Варіант 2. Перевіряти, що $ module присвоєно одне з допустимих значень:
PHP надає також можливість відключення використання віддалених файлів, це реалізується шляхом зміни значення опції allow_url_fopen на Off в файлі конфігурації php.ini.
Включення великих файлів
Але при вкладенні в документ великих файлів, вбудована функція include не завжди працює коректно. І у стандартній функції немає перевірки на присутність файлу, який ми збираємося вкласти. У пропонованій функції таких недоліків немає. На початок сторінки