array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.highlight-file.php', 1 => 'highlight_file', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Разные функции', ), 'prev' => array ( 0 => 'function.halt-compiler.php', 1 => '__halt_compiler', ), 'next' => array ( 0 => 'function.highlight-string.php', 1 => 'highlight_string', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/misc/functions/highlight-file.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
highlight_file — Подсвечивает синтаксис файла
Выводит или возвращает версию с подсветкой синтаксиса кода, содержащегося
в файле filename
, применяя цвета, которые определены
во встроенном обработчике подсветки синтаксиса PHP.
Многие серверы настроены с модулем phps, чтобы автоматически подсвечивать файлы. Например, при отображении файла example.phps будет выведен код с подсветкой синтаксиса. Чтобы включить подстветку, в файл httpd.conf добавляют строку:
AddType application/x-httpd-php-source .phps
filename
Путь к PHP-файлу, который нужно подсветить.
return
Параметру устанавливают значение true
, чтобы функция возвращала
подсвеченный код.
Если параметру return
установлено значение true
,
возвращает подсвеченный код в виде строки, а не выводит его. В остальных случаях
возвращает true
в случае успешного выполнения или false
в случае возникновения ошибки.
Версия | Описание |
---|---|
8.3.0 | Изменился результирующий HTML. |
Рекомендовано пользоваться функцией highlight_file() с повышенным вниманием с тем, чтобы по неосторожности не раскрыть конфиденциальную информацию, например, пароли или другую информацию, создающую угрозу безопасности.
Замечание:
Поскольку в сигнатуре функции есть параметр
return
, она будет использовать внутреннюю буферизацию вывода, поэтому эту функцию нельзя указывать в качестве callback-функции при вызове функции ob_start().