Конструкция include в PHP.


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

Общий синтаксис конструкции:

1
include $filename;

или

1
include 'somename';

Также имя файла можно указать в скобках:

1
include($filename);

Давайте рассмотрим пример. У нас два файла. Первый – myvars.php, который мы будем подключать к основному сценарию, и второй – myscript.php, где мы будем выполнять подключение.

Содержание файла myvars.php

1
2
3
4
<?php
$name = 'Вадим';
$age = '20';
?>

Содержание myscript.php

1
2
3
4
5
<?php
include 'myvars.php';
echo "Меня зовут $name"; 
echo " и мне $age лет"; 
?>

В результате будет выведено: «Меня зовут Вадим и мне 20 лет».

Как видно из примера, в основном файле myscript.php мы не присваиваем значения переменным $name и $age, но, благодаря тому, что мы подключаем файл myvars.php, мы получаем нужные значения.

В подключаемые файлы можно также включать определения функций, однако, если используете include внутри какого-то цикла, то можете получить ошибку, так как функция была определена уже в процессе первого подключения файла. Чтобы этого избежать, нужно использовать альтернативную конструкцию include_once, которая подключит файл только в том случае, если он еще не был подключен ранее. Таким образом, нам нет необходимости писать специальную проверку.

Стоит отметить, что подключаться могут не только файлы, размещенные на этом же сервере, но и на внешнем. Для этого необходимо указывать полный (абсолютный) путь к файлу.

1
2
3
<?php
include 'http://www.site.com/file.php?var1=1&var2=2';
?>

Как видно из примера, здесь мы не только подключаем внешний файл, но и передаем методом GET значения двух переменных, которые может использовать подключаемый файл.

Будьте осторожны и внимательны к тем файлам, которые вы пытаетесь подключать с внешних сайтов. Делайте это только в отношении проверенных ресурсов, иначе в любом момент содержание внешнего файла может быть легко подменено вредоносным скриптом, который будет выполнен на стороне именно вашего сервера.

Возможно также использовать присваивание переменной результата выполнения подключаемого файла. Для этого мы в подключаемом файле должны использовать ключевое слово return:

Подключаемый файл returnfile.php

1
2
3
4
<?php
$myvar = 'Ответное значение';
return $myvar;
?>

Основной сценарий test.php

1
2
3
4
<?php
$answer = include 'returnfile.php';
echo $answer; // Выведет 'Ответное значение'
?>




Другие посты

Категория: PHP-скрипты

Оставить комментарий