a b c d e f g h i j k l m n o p q r s t u v w x y z

Описание функции highlight-file

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