eval
(PHP 4, PHP 5, PHP 7)
eval — Выполняет код PHP, содержащейся в строке
Описание
Выполняет строку, переданную в параметре code
,
как код PHP.
Языковая конструкция eval() может быть очень опасной, поскольку позволяет выполнить произвольный код. Использование данной функции не рекомендуется. Если вы полностью убеждены, что нет другого способа, кроме использования этой конструкции, обратите особое внимание на то, чтобы не передавать какие-либо данные, предоставленые пользователем, без предварительной проверки.
Список параметров
-
code
-
Выполняемая строка кода PHP.
Код не должен быть обернут открывающимся и закрывающимся тегами PHP, то есть строка должна быть, например, такой
'echo "Привет!";'
, но не такой'<?php echo "Привет!"; >'
. Возможно переключаться между режимами PHP- и HTML-кода, например'echo "Код PHP!"; ?>Код HTML<?php echo "Снова код PHP!";'
.Передаваемый код должен быть верным исполняемым кодом PHP. Это значит, что операторы должны быть разделены точкой с запятой (;). При исполнении строки
'echo "Привет!"'
будет сгенерирована ошибка, а строка'echo "Привет!";'
будет успешно выполнена.Указание в коде ключевого слова
return
прекращает исполнение кода в строке.Исполняемый код из строки будет выполняться в области видимости кода, вызвавшего eval(). Таким образом, любые переменные, определенные или измененные в вызове eval(), будут доступны после его выполнения в теле программы.
Возвращаемые значения
Функция eval() возвращает null
, если не вызывается
return
, в случае чего возвращается значение, переданное
return
. С PHP 7, если в исполняемом коде присутствует ошибка, то
eval() вызывает исключение "ParseError". До PHP 7 в этом случае
возвращается false
и продолжается нормальное
выполнение последующего кода. Невозможно поймать ошибку парсера в eval(),
используя set_error_handler().
Примеры
Пример #1 Пример функции eval() - простое слияние текста
<?php
$string = 'чашка';
$name = 'кофе';
$str = 'Это $string с моим $name.';
echo $str. "\n";
eval("\$str = \"$str\";");
echo $str. "\n";
?>
Результат выполнения данного примера:
Это $string с моим $name. Это чашка с моим кофе.
Примечания
Замечание: Поскольку это языковая конструкция, а не функция, она не может вызываться при помощи переменных функций.
Как и с любой другой функцией, осуществляющей вывод непосредственно в браузер, вы можете использовать функции контроля вывода, чтобы перехватывать выводимые этой функцией данные и сохранять их, например, в строку (string).
Замечание:
В случае фатальной ошибки в исполняемом коде прекращается исполнение всего скрипта.