(PHP 4, PHP 5, PHP 7)
eval — Исполняет код PHP, содержащейся в строке
Описание
mixed eval ( string $code )
Исполняет строку, переданную в параметре 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 и продолжается нормальное выполнение последующего кода. Ошибку обработки кода парсером невозможно использовать в
set_error_handler().
Примеры
Пример #1 Пример функции eval() - простое слияние текста
<?php
$string = 'cup';
$name = 'coffee';
$str = 'This is a $string with my $name in it.';
echo $str. "\n";
eval("\$str = \"$str\";");
echo $str. "\n";
?>
Результат выполнения данного примера:
This is a $string with my $name in it.
This is a cup with my coffee in it.
Примечания
Замечание: Поскольку это языковая конструкция, а не функция, она не может вызываться при помощи
переменных функций.
Подсказка
Как и с любой другой функцией, осуществляющей вывод непосредственно в браузер, вы можете использовать
функции контроля вывода, чтобы перехватывать выводимые этой функцией данные и сохранять их, например, в
string.
Замечание:
В случае фатальной ошибки в исполняемом коде прекращается исполнение всего скрипта.