Учебник РНР
Назад Вперёд

highlight_file

(PHP 4)

highlight_file - выделение синтаксиса файла.

Описание

mixed highlight_file (string filename [, bool return])

Функция highlight_file() печатает версию с синтаксиса, с выделениями кода, содержащегося в filename , с использованием цветов, определённых встроенной подсветкой синтаксиса PHP.

Если второй параметр return имеет значение TRUE , то highlight_file() возвратит код с выделениями как строку, а не будет печатать его. Если второй параметр не имеет значение TRUE , то highlight_file() возвратит TRUE при успехе, FALSE при неудаче.

Примечание: параметр return стал доступен, начиная с PHP 4.2.0. До этого он имел поведение по умолчанию - FALSE .

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

Примечание: начиная с PHP 4.2.1, на эту функцию действуют также режим safe_mode и open_basedir.

Пример 1. Создание URL, подсвечивающего исходники

Для настройки URL, который может выделять код в любом скрипте, передаваемом ему, мы используем директиву "ForceType" в Apache для генерации URL-патэрна, и функцию highlight_file() - для показа листинга раскрашенного кода.

В вашем httpd.conf вы можете добавить:

<Location /source> ForceType application/x-httpd-php </Location>

а затем создать файл с именем "source" и поместить его в вашу директорию web root.

<HTML> <HEAD> <TITLE>Source Display</TITLE> </HEAD> <BODY BGCOLOR="white"> <?php $script = getenv ("PATH_TRANSLATED"); if(!$script) { echo "<BR><B>ERROR: Script Name needed</B><BR>"; } else { if (ereg("(\.php|\.inc)$",$script)) { echo "<H1>Source of: $PATH_INFO</H1>\n<HR>\n"; highlight_file($script); } else { echo "<H1>ERROR: Only PHP or include script names are allowed</H1>"; } } echo "<HR>Processed: ".date("Y/M/d H:i:s",time()); ?> </BODY> </HTML>

Затем вы можете использовать URL типа приведённого ниже для отображения расцвеченной версии скрипта, находящегося в "/path/to/script.php" на вашем web-сайте.

http://your.server.com/source/path/to/script.php

См. также highlight_string() , show_source() .


Назад Оглавление Вперёд
get_browser Вверх highlight_string