Функции Язык программирования PHP

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

Использование Отладчика

Внутренний отладчик в PHP 3 используется для поиска ошибок в коде. Отладчик работает через TCP-порт для каждого старта PHP 3. Все сообщения об ошибках по данному запросу пересылаются по данному TCP-соединению. Эта информация предназначается для "сервера отладки", который работает внутри IDE или программируемого редактора (такого как Emacs).

Как настроить отладчик:

  1. Настройте порт TCP для отладчика в файле конфигурации (debugger.port) и включите его (debugger.enabled).

  2. Настройте прослушиватель/listener TCP на этот порт (например, socket -l -s 1400 в UNIX).

  3. В вашем коде - запустите "debugger_on(host)", где host это IP-номер или имя хоста, на котором запущен TCP-прослушиватель.

Теперь все предупреждения, сообщения etc. будут выводиться на этот сокет прослушивателя, даже если вы отключите их