(PHP 4 >= 4.0.0)
highlight_file -- Syntax highlighting of a file
Description
bool highlight_file (string filename)
The highlight_file() function prints out a syntax higlighted version of the code
contained in filename using the colors defined in the built-in syntax highlighter
for PHP. Returns TRUE on success, FALSE on failure.
Note: Care should be taken when using the
show_source() and highlight_file() functions to make sure that you do not
inadvertently reveal sensitive information such as passwords or any other type of information that
might create a potential security risk.
|
Example 1. Creating a source highlighting URL
To setup a URL that can code hightlight any script that you pass to it, we will make use
of the "ForceType" directive in Apache to generate a nice URL pattern, and use the function
highlight_file() to show a nice looking code list.
In your httpd.conf you can add the following:
<Location /source>
ForceType application/x-httpd-php
</Location>
|
And then make a file named "source" and put it in your web root directory.
<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>
|
Then you can use an URL like the one below to display a colorized version of a script
located in "/path/to/script.php" in your web site.
http://your.server.com/source/path/to/script.php
|
|
Tip: As with anything that outputs its result directly to the browser, you can use the output-control functions to capture the output of this function, and
save it - for example - in a string.
See also highlight_string(), show_source().
|
