highlight_file
(PHP 4, PHP 5)
highlight_file — Подсветка синтаксиса файла
Описание
Выводит или возвращает версию с подсветкой синтаксиса кода, содержащегося
в файле filename, используя цвета определенные во
встроенной подсветке синтаксиса PHP.
Большинство серверов сконфигурированы автоматически подсвечивать файлы с расширением phps. К примеру, при отображении файла example.phps будет выведен код с подсветкой синтаксиса. Для включения добавьте следующую строку в httpd.conf:
AddType application/x-httpd-php-source .phps
Список параметров
-
filename -
Путь к подсвечиваемому PHP файлу.
-
return -
Установите в этот параметр
TRUEдля того чтобы функция возвращала подсвеченный код.
Возвращаемые значения
Если в return установлено TRUE, то подсвеченный
код возвращается в виде строки, а не отображается. В другом случае будет
возвращено TRUE, либо FALSE при ошибке.
Список изменений
| Версия | Описание |
|---|---|
| 4.2.1 | На данный момент на эту функцию также воздействуют режимы safe_mode и open_basedir. |
| 4.2.0 |
Был добавлен параметр return.
|
Примечания
Необходимо пользоваться функцией highlight_file() с должным вниманием, с тем чтобы по неосторожности не раскрыть конфиденциальную информацию, такую как пароли или любую другую информацию, которая может создать потенциальную угрозу безопасности.
Замечание:
При использовании параметра
returnданная функция использует внутреннюю буферизацию вывода, поэтому она не может быть использована внутри callback-функции ob_start().
Коментарии
Here is a simple, yet useful, tip... Issuing the following command under a Unix-like OS:
ln -s your_script.php your_script.phps
Will result in the creation of a symbolic link (called your_script.phps) to the source code (your_script.php). This way you have (apart from the source code .php) the highlighted version of your script (.phps) accessible via your web browser.