|
(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()
.
|
|
