- PHP include_once
- Introduction to the PHP include_once construct
- Why use the PHP include_once construct
- Summary
- Как подключать PHP-файлы и зачем это вообще нужно
- Как подключить PHP из другой директории
- Как работает подключение кода PHP
- Различия `include`, `include_once`, `require`, `require_once`
- Подведём итоги
PHP include_once
Summary: in this tutorial, you will learn how to use the PHP include_once construct to include a file once.
Introduction to the PHP include_once construct
In the include tutorial, you learned how to load the code from another file using the include construct.
Sometimes, you may have a file that is included more than once.
If the included file has a function, you’ll get a fatal error because the function is already redeclared in the first load. For example:
Suppose that you have the following project directory:
. ├── inc │ └── functions.php └── index.php
Code language: plaintext (plaintext)
The functions.php has the dd() function definition:
function dd($data) < echo ''
; var_dump($data); echo '
'; die(); >Code language: HTML, XML (xml)
And in the index.php file , you include the functions.php file twice:
include 'inc/functions.php'; include 'inc/functions.php';
Code language: HTML, XML (xml)
PHP will issue the following error if you run the index.php file:
Fatal error: Cannot redeclare dd() (previously declared in .\inc\functions.php:3) in .\inc\functions.php on line 3
Code language: plaintext (plaintext)
Likewise, if the included file outputs some HTML elements, you’ll see them more once on the page. To see how it happens, let’s create two new files header.php and footer.php in the inc directory:
html>
html lang="en"> head> meta charset="UTF-8" /> meta name="viewport" content="width=device-width, initial-scale=1.0" /> title>PHP include_once title> head> body>Code language: HTML, XML (xml)
body
> html>Code language: HTML, XML (xml)
In the index.php file, if you include the header.php file twice, you’ll see that the page will have two headers:
include 'inc/header.php' ?> include 'inc/header.php' ?> h1>PHP include_once Demo h1>
include 'inc/footer.php' ?>Code language: HTML, XML (xml)
To avoid including a file more than once, you can use the include_once statement:
include_once 'path_to_file';
Code language: PHP (php)
The include_once behaves like the include statement except that if the file is included again, the include_once won’t load the file and returns true .
Simply put, the include_once loads the file just once regardless of how many times the file is included.
In the example above, if you use the include_once construct, the script will work properly:
include_once 'inc/header.php' ?> include_once 'inc/header.php' ?> h1>PHP include_once Demo h1>
include_once 'inc/footer.php' ?>Code language: HTML, XML (xml)
Why use the PHP include_once construct
Image that you have a file called index.php that loads two other files:
The Database.php file also loads the Logger.php file. In this case, the Logger.php file is used twice, once in the Database.php file and another in the index.php .
In this case, you need to use the include_once construct to load the Logger.php file to make it work properly.
Summary
Как подключать PHP-файлы и зачем это вообще нужно
Приветствую читателей блога! У вас наверняка уже есть небольшой опыт в кодинге на PHP. Возможно, вы уже разобрались с использованием переменных и базовых конструкций этого языка, а значит, логика вашего приложения увеличивается, как и количества кода.
Конечно, пока вся программа уменьшается в десяток строк, разбивать её на части не нужно. Но вы уже понимаете, что так будет не всегда: авторизация, отправка писем, взаимодействия с базой данных и т.д. – все это приведет к увеличению кода приложения.
Вы спросите: «Ну и что с того? Разве плохо писать всю логику в одном файле?». Стопроцентного ответа на этот вопрос нет, но мой опыт говорит, что код приложения, написанный в одном файле:
- при дополнении и внесении новой логики приводит к частым ошибкам
- требует большего времени для изучения другим разработчиком
- через месяц-два при необходимости маленькой правки потребует у тебя гораздо больше времени на понимание кода, чем на саму правку.
Если этих доводов недостаточно – советую почитать книгу Роберта Мартина «Чистый код». А пока продолжу.
Представим, что у нас есть 2 файла: `index.php` и `1.php`, лежащих в одной директории.
html lang="ru"> head> meta charset="UTF-8"> title>Document/title> /head> body> /body> /html>
Задача: вывести содержимое файла «1.php» в контейнере `body`, при запуске файла «index.php». Решить её можно разными способами, и в этом посте мы рассмотрим некоторые из них. Подключение PHP возможно с помощью разных инструкций:
Самый простой пример решения с `include`:
html lang="ru"> head> meta charset="UTF-8"> title>Document/title> /head> body> include '1.php'; ?> /body> /html>
Результат запуска в браузере:
Как подключить PHP из другой директории
Теперь изменим условия. Переместим файл `1.php` в папку с названием `test`, которую создадим в директории с файлом `index.php`.
Поскольку подключаемый файл находится в другой директории, для его подключения следует указать сначала папку, в которой он находится, а потом и сам файл.
Далее изменим код в `index.php`.
Строка, что мы указываем после инструкции `include`, это путь к файлу. Он может быть относительный (к файлу, где используется подключение) и абсолютным (от корня файловой системы). В приложениях рекомендуются использовать относительные пути.
Между папками, файлами и другими папками в пути устанавливаются разделители. Универсальный разделитель для различных операционных систем – `/`.
Если в папке `test` у нас была бы еще папка `lot`, в которой лежал файл `1.php`, то относительный путь выглядел бы так: ‘test/lot/1.php’.
С путями немного разобрались – возвращаемся к инструкциям. Произведем изменения в файлах. Файл «index.php»:
html lang="ru"> head> meta charset="UTF-8"> title>Document/title> /head> body> $say = 'Hello world!'; include 'test/1.php'; echo $test; echo " End/p>"; ?> /body> /html>
echo " "; $test = 'TEst connect';
Посмотрим на изменение в выводе:
Как работает подключение кода PHP
Интерпретатор php «читает» код сверху вниз и слева направо, как мы читаем книги на русском языке. На исполнение от сервера ему указывается файл «index.php», а значит, чтение начинается с него. Дойдя до строчки с `include ‘test/1.php’`, интерпретатор пытается найти и исполнить это файл так, как будто он является частью «index.php».
Перед подключением и исполнением файла «1.php» уже существует переменная `$say`, в которой содержится ‘Hello world!’. При выполнении файла «1.php», содержимое этой переменной выводится на экран и создается переменная `$test`, которая в свою очередь и выводится на экран в файле `index.php`.
Если описанное выше непонятно, советую немного поиграться с файлами `1.php` и `index.php` создавая и выводя в них переменные.
Различия `include`, `include_once`, `require`, `require_once`
Переименуем файл «1.php»в файл «2.php» и обратимся к «index.php»:
В итоге получаем ошибку. Но обратите внимание на то, что после вывода ошибки код PHP все равно продолжил выполнение и вывел `End`. Заменим `include` на `require` и запустим на выполнение.
В итоге видим похожие ошибки, но не видим вывода `End` в конце: после ошибки код php прекратил свою работу.
Разница между `include` и `require` заключается в том, что при подключении файла PHP первая инструкция позволяет продолжить выполнения скрипта, если не найден файл, а `require` завершает его, выводя фатальную ошибку.
Теперь рассмотрим отличие инструкций `require` и `require_once`. Внесем небольшие правки в наши файлы. Вот новый «index.php»:
html lang="ru"> head> meta charset="UTF-8"> title>Document/title> /head> body> $say = 'Hello world!'; require 'test/2.php'; require 'test/2.php'; require 'test/2.php'; require 'test/2.php'; echo " End/p>"; ?> /body> /html>
Как видно на скриншоте, с помощью `require` мы успешно подключили файл несколько раз. Снова внесем изменение в файлы. Новый файл «index.php»:
html lang="ru"> head> meta charset="UTF-8"> title>Document/title> /head> body> require 'test/2.php'; require 'test/2.php'; require 'test/2.php'; require 'test/2.php'; echo "p>End/p>"; ?> /body> /html>
И новый файл «2.php» — на этот раз объявим там функцию:
echo 'Im included
'; function sayHello($say) echo " "; >
Второе подключение файла «2.php» приводит к ошибке, как раз потому что в этом файле происходит объявление функции. А в PHP-скрипте двух одинаковых функций быть не должно.
Теперь заменим все `require` на `require_once` и запустим снова:
Ура, работает! Но обратим внимание на то, что файл подключился только один раз.
Теперь вновь переименуем файл `2.php` в `1.php` и запустим «index.php».
`Require_once`, так же как и `require` завершает выполнение скрипта, если не найден файл указанный для подключения. Заменим `require_once` на `include_once`:
Ошибок стало больше, но код по-прежнему отработал до конца: end в конце картинки это подтверждает. Внесем правки в «index.php»:
html lang="ru"> head> meta charset="UTF-8"> title>Document/title> /head> body> include_once 'test/1.php'; include_once 'test/1.php'; include_once 'test/1.php'; include_once 'test/1.php'; echo " End/p>"; ?> /body> /html>
Подведём итоги
Чтобы подключить PHP-файлы, можно воспользоваться четырьмя похожими инструкциями — `include` и `include_once`, `require` и `require_once`.
- Разница между `include` и `require`: при отсутствии файла последняя выводит фатальную ошибку, а первая — нет.
- Разница между `include` и `include_once` (а также `require` и `require_once` соответственно): инструкции с “once” проверяют перед подключением, был ли этот файл подключен ранее. Если он подключался, повторного подключения не произойдет.
- Разница между `require_once` и `include_once`: думаю, она понятна из двух предыдущих пунктов 🙂
Если вы хотите освоить PHP во всей его полноте — приглашаем вас на курсы PHP-разработки в GeekBrains. За шесть месяцев вы изучите не только работу с PHP, но и другие важные в профессии технологии — фреймворк Laravel, базы данных MS SQL и Postgre SQL, основы HTML/CSS и ООП. А также сможете пройти полноценную онлайн-стажировку!